1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004
3 Free Software Foundation.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font or fontset pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
75 Faces are frame-local by nature because Emacs allows to define the
76 same named face (face names are symbols) differently for different
77 frames. Each frame has an alist of face definitions for all named
78 faces. The value of a named face in such an alist is a Lisp vector
79 with the symbol `face' in slot 0, and a slot for each of the face
80 attributes mentioned above.
82 There is also a global face alist `Vface_new_frame_defaults'. Face
83 definitions from this list are used to initialize faces of newly
86 A face doesn't have to specify all attributes. Those not specified
87 have a value of `unspecified'. Faces specifying all attributes but
88 the 14th are called `fully-specified'.
93 The display style of a given character in the text is determined by
94 combining several faces. This process is called `face merging'.
95 Any aspect of the display style that isn't specified by overlays or
96 text properties is taken from the `default' face. Since it is made
97 sure that the default face is always fully-specified, face merging
98 always results in a fully-specified face.
103 After all face attributes for a character have been determined by
104 merging faces of that character, that face is `realized'. The
105 realization process maps face attributes to what is physically
106 available on the system where Emacs runs. The result is a
107 `realized face' in form of a struct face which is stored in the
108 face cache of the frame on which it was realized.
110 Face realization is done in the context of the character to display
111 because different fonts may be used for different characters. In
112 other words, for characters that have different font
113 specifications, different realized faces are needed to display
116 Font specification is done by fontsets. See the comment in
117 fontset.c for the details. In the current implementation, all ASCII
118 characters share the same font in a fontset.
120 Faces are at first realized for ASCII characters, and, at that
121 time, assigned a specific realized fontset. Hereafter, we call
122 such a face as `ASCII face'. When a face for a multibyte character
123 is realized, it inherits (thus shares) a fontset of an ASCII face
124 that has the same attributes other than font-related ones.
126 Thus, all realized face have a realized fontset.
131 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
132 font as ASCII characters. That is because it is expected that
133 unibyte text users specify a font that is suitable both for ASCII
134 and raw 8-bit characters.
139 Font selection tries to find the best available matching font for a
140 given (character, face) combination.
142 If the face specifies a fontset name, that fontset determines a
143 pattern for fonts of the given character. If the face specifies a
144 font name or the other font-related attributes, a fontset is
145 realized from the default fontset. In that case, that
146 specification determines a pattern for ASCII characters and the
147 default fontset determines a pattern for multibyte characters.
149 Available fonts on the system on which Emacs runs are then matched
150 against the font pattern. The result of font selection is the best
151 match for the given face attributes in this font list.
153 Font selection can be influenced by the user.
155 1. The user can specify the relative importance he gives the face
156 attributes width, height, weight, and slant by setting
157 face-font-selection-order (faces.el) to a list of face attribute
158 names. The default is '(:width :height :weight :slant), and means
159 that font selection first tries to find a good match for the font
160 width specified by a face, then---within fonts with that
161 width---tries to find a best match for the specified font height,
164 2. Setting face-font-family-alternatives allows the user to
165 specify alternative font families to try if a family specified by a
168 3. Setting face-font-registry-alternatives allows the user to
169 specify all alternative font registries to try for a face
170 specifying a registry.
172 4. Setting face-ignored-fonts allows the user to ignore specific
176 Character composition.
178 Usually, the realization process is already finished when Emacs
179 actually reflects the desired glyph matrix on the screen. However,
180 on displaying a composition (sequence of characters to be composed
181 on the screen), a suitable font for the components of the
182 composition is selected and realized while drawing them on the
183 screen, i.e. the realization process is delayed but in principle
187 Initialization of basic faces.
189 The faces `default', `modeline' are considered `basic faces'.
190 When redisplay happens the first time for a newly created frame,
191 basic faces are realized for CHARSET_ASCII. Frame parameters are
192 used to fill in unspecified attributes of the default face. */
196 #include <sys/types.h>
197 #include <sys/stat.h>
198 #include <stdio.h> /* This needs to be before termchar.h */
202 #include "keyboard.h"
204 #include "termhooks.h"
206 #ifdef HAVE_WINDOW_SYSTEM
208 #endif /* HAVE_WINDOW_SYSTEM */
210 #ifdef HAVE_X_WINDOWS
214 #include <Xm/XmStrDefs.h>
215 #endif /* USE_MOTIF */
216 #endif /* HAVE_X_WINDOWS */
225 /* Redefine X specifics to W32 equivalents to avoid cluttering the
226 code with #ifdef blocks. */
227 #undef FRAME_X_DISPLAY_INFO
228 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
229 #define x_display_info w32_display_info
230 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
231 #define check_x check_w32
232 #define x_list_fonts w32_list_fonts
233 #define GCGraphicsExposures 0
234 #endif /* WINDOWSNT */
238 #define x_display_info mac_display_info
239 #define check_x check_mac
243 #include "dispextern.h"
244 #include "blockinput.h"
246 #include "intervals.h"
247 #include "termchar.h"
249 #ifdef HAVE_X_WINDOWS
251 /* Compensate for a bug in Xos.h on some systems, on which it requires
252 time.h. On some such systems, Xos.h tries to redefine struct
253 timeval and struct timezone if USG is #defined while it is
256 #ifdef XOS_NEEDS_TIME_H
262 #else /* not XOS_NEEDS_TIME_H */
264 #endif /* not XOS_NEEDS_TIME_H */
266 #endif /* HAVE_X_WINDOWS */
270 #define abs(X) ((X) < 0 ? -(X) : (X))
272 /* Number of pt per inch (from the TeXbook). */
274 #define PT_PER_INCH 72.27
276 /* Non-zero if face attribute ATTR is unspecified. */
278 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
280 /* Value is the number of elements of VECTOR. */
282 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
284 /* Make a copy of string S on the stack using alloca. Value is a pointer
287 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
289 /* Make a copy of the contents of Lisp string S on the stack using
290 alloca. Value is a pointer to the copy. */
292 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
294 /* Size of hash table of realized faces in face caches (should be a
297 #define FACE_CACHE_BUCKETS_SIZE 1001
299 /* Keyword symbols used for face attribute names. */
301 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
302 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
303 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
304 Lisp_Object QCreverse_video
;
305 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
307 /* Symbols used for attribute values. */
309 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
310 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
311 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
312 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
313 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
314 Lisp_Object Qultra_expanded
;
315 Lisp_Object Qreleased_button
, Qpressed_button
;
316 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
317 Lisp_Object Qunspecified
;
319 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
321 /* The name of the function to call when the background of the frame
322 has changed, frame_update_face_colors. */
324 Lisp_Object Qframe_update_face_colors
;
326 /* Names of basic faces. */
328 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
329 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
330 Lisp_Object Qmode_line_inactive
;
331 extern Lisp_Object Qmode_line
;
333 /* The symbol `face-alias'. A symbols having that property is an
334 alias for another face. Value of the property is the name of
337 Lisp_Object Qface_alias
;
339 /* Default stipple pattern used on monochrome displays. This stipple
340 pattern is used on monochrome displays instead of shades of gray
341 for a face background color. See `set-face-stipple' for possible
342 values for this variable. */
344 Lisp_Object Vface_default_stipple
;
346 /* Alist of alternative font families. Each element is of the form
347 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
348 try FAMILY1, then FAMILY2, ... */
350 Lisp_Object Vface_alternative_font_family_alist
;
352 /* Alist of alternative font registries. Each element is of the form
353 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
354 loaded, try REGISTRY1, then REGISTRY2, ... */
356 Lisp_Object Vface_alternative_font_registry_alist
;
358 /* Allowed scalable fonts. A value of nil means don't allow any
359 scalable fonts. A value of t means allow the use of any scalable
360 font. Otherwise, value must be a list of regular expressions. A
361 font may be scaled if its name matches a regular expression in the
364 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
366 /* List of regular expressions that matches names of fonts to ignore. */
368 Lisp_Object Vface_ignored_fonts
;
370 /* Alist of font name patterns vs the rescaling factor. */
372 Lisp_Object Vface_font_rescale_alist
;
374 /* Maximum number of fonts to consider in font_list. If not an
375 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
377 Lisp_Object Vfont_list_limit
;
378 #define DEFAULT_FONT_LIST_LIMIT 100
380 /* The symbols `foreground-color' and `background-color' which can be
381 used as part of a `face' property. This is for compatibility with
384 Lisp_Object Qforeground_color
, Qbackground_color
;
386 /* The symbols `face' and `mouse-face' used as text properties. */
389 extern Lisp_Object Qmouse_face
;
391 /* Error symbol for wrong_type_argument in load_pixmap. */
393 Lisp_Object Qbitmap_spec_p
;
395 /* Alist of global face definitions. Each element is of the form
396 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
397 is a Lisp vector of face attributes. These faces are used
398 to initialize faces for new frames. */
400 Lisp_Object Vface_new_frame_defaults
;
402 /* The next ID to assign to Lisp faces. */
404 static int next_lface_id
;
406 /* A vector mapping Lisp face Id's to face names. */
408 static Lisp_Object
*lface_id_to_name
;
409 static int lface_id_to_name_size
;
411 /* TTY color-related functions (defined in tty-colors.el). */
413 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
415 /* The name of the function used to compute colors on TTYs. */
417 Lisp_Object Qtty_color_alist
;
419 /* An alist of defined terminal colors and their RGB values. */
421 Lisp_Object Vtty_defined_color_alist
;
423 /* Counter for calls to clear_face_cache. If this counter reaches
424 CLEAR_FONT_TABLE_COUNT, and a frame has more than
425 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
427 static int clear_font_table_count
;
428 #define CLEAR_FONT_TABLE_COUNT 100
429 #define CLEAR_FONT_TABLE_NFONTS 10
431 /* Non-zero means face attributes have been changed since the last
432 redisplay. Used in redisplay_internal. */
434 int face_change_count
;
436 /* Non-zero means don't display bold text if a face's foreground
437 and background colors are the inverse of the default colors of the
438 display. This is a kluge to suppress `bold black' foreground text
439 which is hard to read on an LCD monitor. */
441 int tty_suppress_bold_inverse_default_colors_p
;
443 /* A list of the form `((x . y))' used to avoid consing in
444 Finternal_set_lisp_face_attribute. */
446 static Lisp_Object Vparam_value_alist
;
448 /* The total number of colors currently allocated. */
451 static int ncolors_allocated
;
452 static int npixmaps_allocated
;
456 /* Non-zero means the definition of the `menu' face for new frames has
459 int menu_face_changed_default
;
462 /* Function prototypes. */
467 static void map_tty_color
P_ ((struct frame
*, struct face
*,
468 enum lface_attribute_index
, int *));
469 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
));
470 static int may_use_scalable_font_p
P_ ((const char *));
471 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
472 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
474 static int x_face_list_fonts
P_ ((struct frame
*, char *,
475 struct font_name
**, int, int));
476 static int font_scalable_p
P_ ((struct font_name
*));
477 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
478 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
479 static unsigned char *xstrlwr
P_ ((unsigned char *));
480 static void signal_error
P_ ((char *, Lisp_Object
));
481 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
482 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
483 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
484 static void free_face_colors
P_ ((struct frame
*, struct face
*));
485 static int face_color_gray_p
P_ ((struct frame
*, char *));
486 static char *build_font_name
P_ ((struct font_name
*));
487 static void free_font_names
P_ ((struct font_name
*, int));
488 static int sorted_font_list
P_ ((struct frame
*, char *,
489 int (*cmpfn
) P_ ((const void *, const void *)),
490 struct font_name
**));
491 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
492 Lisp_Object
, struct font_name
**));
493 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
494 Lisp_Object
, struct font_name
**));
495 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
496 Lisp_Object
, Lisp_Object
, struct font_name
**,
498 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
499 Lisp_Object
, struct font_name
**));
500 static int cmp_font_names
P_ ((const void *, const void *));
501 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
502 struct face
*, int));
503 static struct face
*realize_x_face
P_ ((struct face_cache
*,
504 Lisp_Object
*, int, struct face
*));
505 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
506 Lisp_Object
*, int));
507 static int realize_basic_faces
P_ ((struct frame
*));
508 static int realize_default_face
P_ ((struct frame
*));
509 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
510 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
511 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
512 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
513 static unsigned lface_hash
P_ ((Lisp_Object
*));
514 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
515 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
516 static void free_realized_face
P_ ((struct frame
*, struct face
*));
517 static void clear_face_gcs
P_ ((struct face_cache
*));
518 static void free_face_cache
P_ ((struct face_cache
*));
519 static int face_numeric_weight
P_ ((Lisp_Object
));
520 static int face_numeric_slant
P_ ((Lisp_Object
));
521 static int face_numeric_swidth
P_ ((Lisp_Object
));
522 static int face_fontset
P_ ((Lisp_Object
*));
523 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
524 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*, Lisp_Object
));
525 static void merge_face_inheritance
P_ ((struct frame
*f
, Lisp_Object
,
526 Lisp_Object
*, Lisp_Object
));
527 static void merge_face_vector_with_property
P_ ((struct frame
*, Lisp_Object
*,
529 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
530 Lisp_Object
, int, int));
531 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
532 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
533 static void free_realized_faces
P_ ((struct face_cache
*));
534 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
535 struct font_name
*, int, int, int *));
536 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
537 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
538 static int xlfd_numeric_slant
P_ ((struct font_name
*));
539 static int xlfd_numeric_weight
P_ ((struct font_name
*));
540 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
541 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
542 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
543 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
544 static int xlfd_fixed_p
P_ ((struct font_name
*));
545 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
547 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
548 struct font_name
*, int,
550 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
551 struct font_name
*, int));
553 #ifdef HAVE_WINDOW_SYSTEM
555 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
556 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
557 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
558 int (*cmpfn
) P_ ((const void *, const void *))));
559 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
560 static void x_free_gc
P_ ((struct frame
*, GC
));
561 static void clear_font_table
P_ ((struct x_display_info
*));
564 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
565 #endif /* WINDOWSNT */
568 static void x_update_menu_appearance
P_ ((struct frame
*));
570 extern void free_frame_menubar
P_ ((struct frame
*));
571 #endif /* USE_X_TOOLKIT */
573 #endif /* HAVE_WINDOW_SYSTEM */
576 /***********************************************************************
578 ***********************************************************************/
580 #ifdef HAVE_X_WINDOWS
582 #ifdef DEBUG_X_COLORS
584 /* The following is a poor mans infrastructure for debugging X color
585 allocation problems on displays with PseudoColor-8. Some X servers
586 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
587 color reference counts completely so that they don't signal an
588 error when a color is freed whose reference count is already 0.
589 Other X servers do. To help me debug this, the following code
590 implements a simple reference counting schema of its own, for a
591 single display/screen. --gerd. */
593 /* Reference counts for pixel colors. */
595 int color_count
[256];
597 /* Register color PIXEL as allocated. */
600 register_color (pixel
)
603 xassert (pixel
< 256);
604 ++color_count
[pixel
];
608 /* Register color PIXEL as deallocated. */
611 unregister_color (pixel
)
614 xassert (pixel
< 256);
615 if (color_count
[pixel
] > 0)
616 --color_count
[pixel
];
622 /* Register N colors from PIXELS as deallocated. */
625 unregister_colors (pixels
, n
)
626 unsigned long *pixels
;
630 for (i
= 0; i
< n
; ++i
)
631 unregister_color (pixels
[i
]);
635 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
636 doc
: /* Dump currently allocated colors to stderr. */)
641 fputc ('\n', stderr
);
643 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
646 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
649 fputc ('\n', stderr
);
651 fputc ('\t', stderr
);
655 fputc ('\n', stderr
);
659 #endif /* DEBUG_X_COLORS */
662 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
663 color values. Interrupt input must be blocked when this function
667 x_free_colors (f
, pixels
, npixels
)
669 unsigned long *pixels
;
672 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
674 /* If display has an immutable color map, freeing colors is not
675 necessary and some servers don't allow it. So don't do it. */
676 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
678 #ifdef DEBUG_X_COLORS
679 unregister_colors (pixels
, npixels
);
681 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
687 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
688 color values. Interrupt input must be blocked when this function
692 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
696 unsigned long *pixels
;
699 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
700 int class = dpyinfo
->visual
->class;
702 /* If display has an immutable color map, freeing colors is not
703 necessary and some servers don't allow it. So don't do it. */
704 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
706 #ifdef DEBUG_X_COLORS
707 unregister_colors (pixels
, npixels
);
709 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
714 /* Create and return a GC for use on frame F. GC values and mask
715 are given by XGCV and MASK. */
718 x_create_gc (f
, mask
, xgcv
)
725 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
732 /* Free GC which was used on frame F. */
740 xassert (--ngcs
>= 0);
741 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
745 #endif /* HAVE_X_WINDOWS */
748 /* W32 emulation of GCs */
751 x_create_gc (f
, mask
, xgcv
)
758 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
765 /* Free GC which was used on frame F. */
773 xassert (--ngcs
>= 0);
778 #endif /* WINDOWSNT */
781 /* Mac OS emulation of GCs */
783 extern XGCValues
*XCreateGC (void *, Window
, unsigned long, XGCValues
*);
786 x_create_gc (f
, mask
, xgcv
)
792 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
801 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
806 /* Like stricmp. Used to compare parts of font names which are in
811 const unsigned char *s1
, *s2
;
815 unsigned char c1
= tolower (*s1
);
816 unsigned char c2
= tolower (*s2
);
818 return c1
< c2
? -1 : 1;
823 return *s2
== 0 ? 0 : -1;
828 /* Like strlwr, which might not always be available. */
830 static unsigned char *
834 unsigned char *p
= s
;
843 /* Signal `error' with message S, and additional argument ARG. */
846 signal_error (s
, arg
)
850 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
854 /* If FRAME is nil, return a pointer to the selected frame.
855 Otherwise, check that FRAME is a live frame, and return a pointer
856 to it. NPARAM is the parameter number of FRAME, for
857 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
858 Lisp function definitions. */
860 static INLINE
struct frame
*
861 frame_or_selected_frame (frame
, nparam
)
866 frame
= selected_frame
;
868 CHECK_LIVE_FRAME (frame
);
869 return XFRAME (frame
);
873 /***********************************************************************
875 ***********************************************************************/
877 /* Initialize face cache and basic faces for frame F. */
883 /* Make a face cache, if F doesn't have one. */
884 if (FRAME_FACE_CACHE (f
) == NULL
)
885 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
887 #ifdef HAVE_WINDOW_SYSTEM
888 /* Make the image cache. */
889 if (FRAME_WINDOW_P (f
))
891 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
892 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
893 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
895 #endif /* HAVE_WINDOW_SYSTEM */
897 /* Realize basic faces. Must have enough information in frame
898 parameters to realize basic faces at this point. */
899 #ifdef HAVE_X_WINDOWS
900 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
903 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
906 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
908 if (!realize_basic_faces (f
))
913 /* Free face cache of frame F. Called from Fdelete_frame. */
919 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
923 free_face_cache (face_cache
);
924 FRAME_FACE_CACHE (f
) = NULL
;
927 #ifdef HAVE_WINDOW_SYSTEM
928 if (FRAME_WINDOW_P (f
))
930 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
933 --image_cache
->refcount
;
934 if (image_cache
->refcount
== 0)
935 free_image_cache (f
);
938 #endif /* HAVE_WINDOW_SYSTEM */
942 /* Clear face caches, and recompute basic faces for frame F. Call
943 this after changing frame parameters on which those faces depend,
944 or when realized faces have been freed due to changing attributes
948 recompute_basic_faces (f
)
951 if (FRAME_FACE_CACHE (f
))
953 clear_face_cache (0);
954 if (!realize_basic_faces (f
))
960 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
961 try to free unused fonts, too. */
964 clear_face_cache (clear_fonts_p
)
967 #ifdef HAVE_WINDOW_SYSTEM
968 Lisp_Object tail
, frame
;
972 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
974 struct x_display_info
*dpyinfo
;
976 /* Fonts are common for frames on one display, i.e. on
978 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
979 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
980 clear_font_table (dpyinfo
);
982 /* From time to time see if we can unload some fonts. This also
983 frees all realized faces on all frames. Fonts needed by
984 faces will be loaded again when faces are realized again. */
985 clear_font_table_count
= 0;
987 FOR_EACH_FRAME (tail
, frame
)
989 struct frame
*f
= XFRAME (frame
);
990 if (FRAME_WINDOW_P (f
)
991 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
992 free_all_realized_faces (frame
);
997 /* Clear GCs of realized faces. */
998 FOR_EACH_FRAME (tail
, frame
)
1001 if (FRAME_WINDOW_P (f
))
1003 clear_face_gcs (FRAME_FACE_CACHE (f
));
1004 clear_image_cache (f
, 0);
1008 #endif /* HAVE_WINDOW_SYSTEM */
1012 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1013 doc
: /* Clear face caches on all frames.
1014 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1016 Lisp_Object thoroughly
;
1018 clear_face_cache (!NILP (thoroughly
));
1019 ++face_change_count
;
1020 ++windows_or_buffers_changed
;
1026 #ifdef HAVE_WINDOW_SYSTEM
1029 /* Remove fonts from the font table of DPYINFO except for the default
1030 ASCII fonts of frames on that display. Called from clear_face_cache
1031 from time to time. */
1034 clear_font_table (dpyinfo
)
1035 struct x_display_info
*dpyinfo
;
1039 /* Free those fonts that are not used by frames on DPYINFO. */
1040 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1042 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1043 Lisp_Object tail
, frame
;
1045 /* Check if slot is already free. */
1046 if (font_info
->name
== NULL
)
1049 /* Don't free a default font of some frame. */
1050 FOR_EACH_FRAME (tail
, frame
)
1052 struct frame
*f
= XFRAME (frame
);
1053 if (FRAME_WINDOW_P (f
)
1054 && font_info
->font
== FRAME_FONT (f
))
1062 if (font_info
->full_name
!= font_info
->name
)
1063 xfree (font_info
->full_name
);
1064 xfree (font_info
->name
);
1066 /* Free the font. */
1068 #ifdef HAVE_X_WINDOWS
1069 XFreeFont (dpyinfo
->display
, font_info
->font
);
1072 w32_unload_font (dpyinfo
, font_info
->font
);
1076 /* Mark font table slot free. */
1077 font_info
->font
= NULL
;
1078 font_info
->name
= font_info
->full_name
= NULL
;
1082 #endif /* HAVE_WINDOW_SYSTEM */
1086 /***********************************************************************
1088 ***********************************************************************/
1090 #ifdef HAVE_WINDOW_SYSTEM
1092 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1093 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1094 A bitmap specification is either a string, a file name, or a list
1095 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1096 HEIGHT is its height, and DATA is a string containing the bits of
1097 the pixmap. Bits are stored row by row, each row occupies
1098 \(WIDTH + 7)/8 bytes. */)
1104 if (STRINGP (object
))
1105 /* If OBJECT is a string, it's a file name. */
1107 else if (CONSP (object
))
1109 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1110 HEIGHT must be integers > 0, and DATA must be string large
1111 enough to hold a bitmap of the specified size. */
1112 Lisp_Object width
, height
, data
;
1114 height
= width
= data
= Qnil
;
1118 width
= XCAR (object
);
1119 object
= XCDR (object
);
1122 height
= XCAR (object
);
1123 object
= XCDR (object
);
1125 data
= XCAR (object
);
1129 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1131 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1133 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1138 return pixmap_p
? Qt
: Qnil
;
1142 /* Load a bitmap according to NAME (which is either a file name or a
1143 pixmap spec) for use on frame F. Value is the bitmap_id (see
1144 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1145 bitmap cannot be loaded, display a message saying so, and return
1146 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1147 if these pointers are not null. */
1150 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1153 unsigned int *w_ptr
, *h_ptr
;
1161 tem
= Fbitmap_spec_p (name
);
1163 wrong_type_argument (Qbitmap_spec_p
, name
);
1168 /* Decode a bitmap spec into a bitmap. */
1173 w
= XINT (Fcar (name
));
1174 h
= XINT (Fcar (Fcdr (name
)));
1175 bits
= Fcar (Fcdr (Fcdr (name
)));
1177 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1182 /* It must be a string -- a file name. */
1183 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1189 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1200 ++npixmaps_allocated
;
1203 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1206 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1212 #endif /* HAVE_WINDOW_SYSTEM */
1216 /***********************************************************************
1218 ***********************************************************************/
1220 #ifdef HAVE_WINDOW_SYSTEM
1222 /* Load font of face FACE which is used on frame F to display
1223 character C. The name of the font to load is determined by lface
1224 and fontset of FACE. */
1227 load_face_font (f
, face
, c
)
1232 struct font_info
*font_info
= NULL
;
1234 int needs_overstrike
;
1236 face
->font_info_id
= -1;
1239 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1245 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1250 face
->font_info_id
= font_info
->font_idx
;
1251 face
->font
= font_info
->font
;
1252 face
->font_name
= font_info
->full_name
;
1253 face
->overstrike
= needs_overstrike
;
1256 x_free_gc (f
, face
->gc
);
1261 add_to_log ("Unable to load font %s",
1262 build_string (font_name
), Qnil
);
1266 #endif /* HAVE_WINDOW_SYSTEM */
1270 /***********************************************************************
1272 ***********************************************************************/
1274 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1275 RGB_LIST should contain (at least) 3 lisp integers.
1276 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1279 parse_rgb_list (rgb_list
, color
)
1280 Lisp_Object rgb_list
;
1283 #define PARSE_RGB_LIST_FIELD(field) \
1284 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1286 color->field = XINT (XCAR (rgb_list)); \
1287 rgb_list = XCDR (rgb_list); \
1292 PARSE_RGB_LIST_FIELD (red
);
1293 PARSE_RGB_LIST_FIELD (green
);
1294 PARSE_RGB_LIST_FIELD (blue
);
1300 /* Lookup on frame F the color described by the lisp string COLOR.
1301 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1302 non-zero, then the `standard' definition of the same color is
1306 tty_lookup_color (f
, color
, tty_color
, std_color
)
1309 XColor
*tty_color
, *std_color
;
1311 Lisp_Object frame
, color_desc
;
1313 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1316 XSETFRAME (frame
, f
);
1318 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1319 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1323 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1326 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1328 rgb
= XCDR (XCDR (color_desc
));
1329 if (! parse_rgb_list (rgb
, tty_color
))
1332 /* Should we fill in STD_COLOR too? */
1335 /* Default STD_COLOR to the same as TTY_COLOR. */
1336 *std_color
= *tty_color
;
1338 /* Do a quick check to see if the returned descriptor is
1339 actually _exactly_ equal to COLOR, otherwise we have to
1340 lookup STD_COLOR separately. If it's impossible to lookup
1341 a standard color, we just give up and use TTY_COLOR. */
1342 if ((!STRINGP (XCAR (color_desc
))
1343 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1344 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1346 /* Look up STD_COLOR separately. */
1347 rgb
= call1 (Qtty_color_standard_values
, color
);
1348 if (! parse_rgb_list (rgb
, std_color
))
1355 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1356 /* We were called early during startup, and the colors are not
1357 yet set up in tty-defined-color-alist. Don't return a failure
1358 indication, since this produces the annoying "Unable to
1359 load color" messages in the *Messages* buffer. */
1362 /* tty-color-desc seems to have returned a bad value. */
1366 /* A version of defined_color for non-X frames. */
1369 tty_defined_color (f
, color_name
, color_def
, alloc
)
1378 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1380 color_def
->blue
= 0;
1381 color_def
->green
= 0;
1384 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1386 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1388 if (strcmp (color_name
, "unspecified-fg") == 0)
1389 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1390 else if (strcmp (color_name
, "unspecified-bg") == 0)
1391 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1394 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1401 /* Decide if color named COLOR_NAME is valid for the display
1402 associated with the frame F; if so, return the rgb values in
1403 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1405 This does the right thing for any type of frame. */
1408 defined_color (f
, color_name
, color_def
, alloc
)
1414 if (!FRAME_WINDOW_P (f
))
1415 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1416 #ifdef HAVE_X_WINDOWS
1417 else if (FRAME_X_P (f
))
1418 return x_defined_color (f
, color_name
, color_def
, alloc
);
1421 else if (FRAME_W32_P (f
))
1422 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1425 else if (FRAME_MAC_P (f
))
1426 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1433 /* Given the index IDX of a tty color on frame F, return its name, a
1437 tty_color_name (f
, idx
)
1441 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1444 Lisp_Object coldesc
;
1446 XSETFRAME (frame
, f
);
1447 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1449 if (!NILP (coldesc
))
1450 return XCAR (coldesc
);
1453 /* We can have an MSDOG frame under -nw for a short window of
1454 opportunity before internal_terminal_init is called. DTRT. */
1455 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1456 return msdos_stdcolor_name (idx
);
1459 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1460 return build_string (unspecified_fg
);
1461 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1462 return build_string (unspecified_bg
);
1465 return vga_stdcolor_name (idx
);
1468 return Qunspecified
;
1472 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1473 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1476 face_color_gray_p (f
, color_name
)
1483 if (defined_color (f
, color_name
, &color
, 0))
1484 gray_p
= ((abs (color
.red
- color
.green
)
1485 < max (color
.red
, color
.green
) / 20)
1486 && (abs (color
.green
- color
.blue
)
1487 < max (color
.green
, color
.blue
) / 20)
1488 && (abs (color
.blue
- color
.red
)
1489 < max (color
.blue
, color
.red
) / 20));
1497 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1498 BACKGROUND_P non-zero means the color will be used as background
1502 face_color_supported_p (f
, color_name
, background_p
)
1510 XSETFRAME (frame
, f
);
1512 #ifdef HAVE_X_WINDOWS
1514 ? (!NILP (Fxw_display_color_p (frame
))
1515 || xstricmp (color_name
, "black") == 0
1516 || xstricmp (color_name
, "white") == 0
1518 && face_color_gray_p (f
, color_name
))
1519 || (!NILP (Fx_display_grayscale_p (frame
))
1520 && face_color_gray_p (f
, color_name
)))
1523 tty_defined_color (f
, color_name
, ¬_used
, 0);
1527 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1528 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1529 FRAME specifies the frame and thus the display for interpreting COLOR.
1530 If FRAME is nil or omitted, use the selected frame. */)
1532 Lisp_Object color
, frame
;
1536 CHECK_STRING (color
);
1538 frame
= selected_frame
;
1540 CHECK_FRAME (frame
);
1542 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1546 DEFUN ("color-supported-p", Fcolor_supported_p
,
1547 Scolor_supported_p
, 1, 3, 0,
1548 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1549 BACKGROUND-P non-nil means COLOR is used as a background.
1550 If FRAME is nil or omitted, use the selected frame.
1551 COLOR must be a valid color name. */)
1552 (color
, frame
, background_p
)
1553 Lisp_Object frame
, color
, background_p
;
1557 CHECK_STRING (color
);
1559 frame
= selected_frame
;
1561 CHECK_FRAME (frame
);
1563 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1569 /* Load color with name NAME for use by face FACE on frame F.
1570 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1571 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1572 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1573 pixel color. If color cannot be loaded, display a message, and
1574 return the foreground, background or underline color of F, but
1575 record that fact in flags of the face so that we don't try to free
1579 load_color (f
, face
, name
, target_index
)
1583 enum lface_attribute_index target_index
;
1587 xassert (STRINGP (name
));
1588 xassert (target_index
== LFACE_FOREGROUND_INDEX
1589 || target_index
== LFACE_BACKGROUND_INDEX
1590 || target_index
== LFACE_UNDERLINE_INDEX
1591 || target_index
== LFACE_OVERLINE_INDEX
1592 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1593 || target_index
== LFACE_BOX_INDEX
);
1595 /* if the color map is full, defined_color will return a best match
1596 to the values in an existing cell. */
1597 if (!defined_color (f
, SDATA (name
), &color
, 1))
1599 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1601 switch (target_index
)
1603 case LFACE_FOREGROUND_INDEX
:
1604 face
->foreground_defaulted_p
= 1;
1605 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1608 case LFACE_BACKGROUND_INDEX
:
1609 face
->background_defaulted_p
= 1;
1610 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1613 case LFACE_UNDERLINE_INDEX
:
1614 face
->underline_defaulted_p
= 1;
1615 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1618 case LFACE_OVERLINE_INDEX
:
1619 face
->overline_color_defaulted_p
= 1;
1620 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1623 case LFACE_STRIKE_THROUGH_INDEX
:
1624 face
->strike_through_color_defaulted_p
= 1;
1625 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1628 case LFACE_BOX_INDEX
:
1629 face
->box_color_defaulted_p
= 1;
1630 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1639 ++ncolors_allocated
;
1646 #ifdef HAVE_WINDOW_SYSTEM
1648 /* Load colors for face FACE which is used on frame F. Colors are
1649 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1650 of ATTRS. If the background color specified is not supported on F,
1651 try to emulate gray colors with a stipple from Vface_default_stipple. */
1654 load_face_colors (f
, face
, attrs
)
1661 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1662 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1664 /* Swap colors if face is inverse-video. */
1665 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1673 /* Check for support for foreground, not for background because
1674 face_color_supported_p is smart enough to know that grays are
1675 "supported" as background because we are supposed to use stipple
1677 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1678 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1680 x_destroy_bitmap (f
, face
->stipple
);
1681 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1682 &face
->pixmap_w
, &face
->pixmap_h
);
1685 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1686 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1690 /* Free color PIXEL on frame F. */
1693 unload_color (f
, pixel
)
1695 unsigned long pixel
;
1697 #ifdef HAVE_X_WINDOWS
1701 x_free_colors (f
, &pixel
, 1);
1708 /* Free colors allocated for FACE. */
1711 free_face_colors (f
, face
)
1715 #ifdef HAVE_X_WINDOWS
1716 if (face
->colors_copied_bitwise_p
)
1721 if (!face
->foreground_defaulted_p
)
1723 x_free_colors (f
, &face
->foreground
, 1);
1724 IF_DEBUG (--ncolors_allocated
);
1727 if (!face
->background_defaulted_p
)
1729 x_free_colors (f
, &face
->background
, 1);
1730 IF_DEBUG (--ncolors_allocated
);
1733 if (face
->underline_p
1734 && !face
->underline_defaulted_p
)
1736 x_free_colors (f
, &face
->underline_color
, 1);
1737 IF_DEBUG (--ncolors_allocated
);
1740 if (face
->overline_p
1741 && !face
->overline_color_defaulted_p
)
1743 x_free_colors (f
, &face
->overline_color
, 1);
1744 IF_DEBUG (--ncolors_allocated
);
1747 if (face
->strike_through_p
1748 && !face
->strike_through_color_defaulted_p
)
1750 x_free_colors (f
, &face
->strike_through_color
, 1);
1751 IF_DEBUG (--ncolors_allocated
);
1754 if (face
->box
!= FACE_NO_BOX
1755 && !face
->box_color_defaulted_p
)
1757 x_free_colors (f
, &face
->box_color
, 1);
1758 IF_DEBUG (--ncolors_allocated
);
1762 #endif /* HAVE_X_WINDOWS */
1765 #endif /* HAVE_WINDOW_SYSTEM */
1769 /***********************************************************************
1771 ***********************************************************************/
1773 /* An enumerator for each field of an XLFD font name. */
1794 /* An enumerator for each possible slant value of a font. Taken from
1795 the XLFD specification. */
1803 XLFD_SLANT_REVERSE_ITALIC
,
1804 XLFD_SLANT_REVERSE_OBLIQUE
,
1808 /* Relative font weight according to XLFD documentation. */
1812 XLFD_WEIGHT_UNKNOWN
,
1813 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1814 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1815 XLFD_WEIGHT_LIGHT
, /* 30 */
1816 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1817 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1818 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1819 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1820 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1821 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1824 /* Relative proportionate width. */
1828 XLFD_SWIDTH_UNKNOWN
,
1829 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1830 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1831 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1832 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1833 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1834 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1835 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1836 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1837 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1840 /* Structure used for tables mapping XLFD weight, slant, and width
1841 names to numeric and symbolic values. */
1847 Lisp_Object
*symbol
;
1850 /* Table of XLFD slant names and their numeric and symbolic
1851 representations. This table must be sorted by slant names in
1854 static struct table_entry slant_table
[] =
1856 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1857 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1858 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1859 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1860 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1861 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1864 /* Table of XLFD weight names. This table must be sorted by weight
1865 names in ascending order. */
1867 static struct table_entry weight_table
[] =
1869 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1870 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1871 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1872 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1873 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1874 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1875 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1876 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1877 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1878 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1879 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1880 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1881 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1882 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1883 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1884 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1887 /* Table of XLFD width names. This table must be sorted by width
1888 names in ascending order. */
1890 static struct table_entry swidth_table
[] =
1892 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1893 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1894 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1895 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1896 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1897 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1898 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1899 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1900 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1901 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1902 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1903 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1904 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1905 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1906 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1909 /* Structure used to hold the result of splitting font names in XLFD
1910 format into their fields. */
1914 /* The original name which is modified destructively by
1915 split_font_name. The pointer is kept here to be able to free it
1916 if it was allocated from the heap. */
1919 /* Font name fields. Each vector element points into `name' above.
1920 Fields are NUL-terminated. */
1921 char *fields
[XLFD_LAST
];
1923 /* Numeric values for those fields that interest us. See
1924 split_font_name for which these are. */
1925 int numeric
[XLFD_LAST
];
1927 /* If the original name matches one of Vface_font_rescale_alist,
1928 the value is the corresponding rescale ratio. Otherwise, the
1930 double rescale_ratio
;
1932 /* Lower value mean higher priority. */
1933 int registry_priority
;
1936 /* The frame in effect when sorting font names. Set temporarily in
1937 sort_fonts so that it is available in font comparison functions. */
1939 static struct frame
*font_frame
;
1941 /* Order by which font selection chooses fonts. The default values
1942 mean `first, find a best match for the font width, then for the
1943 font height, then for weight, then for slant.' This variable can be
1944 set via set-face-font-sort-order. */
1947 static int font_sort_order
[4] = {
1948 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1951 static int font_sort_order
[4];
1954 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1955 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1956 is a pointer to the matching table entry or null if no table entry
1959 static struct table_entry
*
1960 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1961 struct table_entry
*table
;
1963 struct font_name
*font
;
1966 /* Function split_font_name converts fields to lower-case, so there
1967 is no need to use xstrlwr or xstricmp here. */
1968 char *s
= font
->fields
[field_index
];
1969 int low
, mid
, high
, cmp
;
1976 mid
= (low
+ high
) / 2;
1977 cmp
= strcmp (table
[mid
].name
, s
);
1991 /* Return a numeric representation for font name field
1992 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
1993 has DIM entries. Value is the numeric value found or DFLT if no
1994 table entry matches. This function is used to translate weight,
1995 slant, and swidth names of XLFD font names to numeric values. */
1998 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
1999 struct table_entry
*table
;
2001 struct font_name
*font
;
2005 struct table_entry
*p
;
2006 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2007 return p
? p
->numeric
: dflt
;
2011 /* Return a symbolic representation for font name field
2012 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2013 has DIM entries. Value is the symbolic value found or DFLT if no
2014 table entry matches. This function is used to translate weight,
2015 slant, and swidth names of XLFD font names to symbols. */
2017 static INLINE Lisp_Object
2018 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2019 struct table_entry
*table
;
2021 struct font_name
*font
;
2025 struct table_entry
*p
;
2026 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2027 return p
? *p
->symbol
: dflt
;
2031 /* Return a numeric value for the slant of the font given by FONT. */
2034 xlfd_numeric_slant (font
)
2035 struct font_name
*font
;
2037 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2038 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2042 /* Return a symbol representing the weight of the font given by FONT. */
2044 static INLINE Lisp_Object
2045 xlfd_symbolic_slant (font
)
2046 struct font_name
*font
;
2048 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2049 font
, XLFD_SLANT
, Qnormal
);
2053 /* Return a numeric value for the weight of the font given by FONT. */
2056 xlfd_numeric_weight (font
)
2057 struct font_name
*font
;
2059 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2060 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2064 /* Return a symbol representing the slant of the font given by FONT. */
2066 static INLINE Lisp_Object
2067 xlfd_symbolic_weight (font
)
2068 struct font_name
*font
;
2070 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2071 font
, XLFD_WEIGHT
, Qnormal
);
2075 /* Return a numeric value for the swidth of the font whose XLFD font
2076 name fields are found in FONT. */
2079 xlfd_numeric_swidth (font
)
2080 struct font_name
*font
;
2082 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2083 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2087 /* Return a symbolic value for the swidth of FONT. */
2089 static INLINE Lisp_Object
2090 xlfd_symbolic_swidth (font
)
2091 struct font_name
*font
;
2093 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2094 font
, XLFD_SWIDTH
, Qnormal
);
2098 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2099 entries. Value is a pointer to the matching table entry or null if
2100 no element of TABLE contains SYMBOL. */
2102 static struct table_entry
*
2103 face_value (table
, dim
, symbol
)
2104 struct table_entry
*table
;
2110 xassert (SYMBOLP (symbol
));
2112 for (i
= 0; i
< dim
; ++i
)
2113 if (EQ (*table
[i
].symbol
, symbol
))
2116 return i
< dim
? table
+ i
: NULL
;
2120 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2121 entries. Value is -1 if SYMBOL is not found in TABLE. */
2124 face_numeric_value (table
, dim
, symbol
)
2125 struct table_entry
*table
;
2129 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2130 return p
? p
->numeric
: -1;
2134 /* Return a numeric value representing the weight specified by Lisp
2135 symbol WEIGHT. Value is one of the enumerators of enum
2139 face_numeric_weight (weight
)
2142 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2146 /* Return a numeric value representing the slant specified by Lisp
2147 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2150 face_numeric_slant (slant
)
2153 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2157 /* Return a numeric value representing the swidth specified by Lisp
2158 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2161 face_numeric_swidth (width
)
2164 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2168 #ifdef HAVE_WINDOW_SYSTEM
2170 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2174 struct font_name
*font
;
2176 /* Function split_font_name converts fields to lower-case, so there
2177 is no need to use tolower here. */
2178 return *font
->fields
[XLFD_SPACING
] != 'p';
2182 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2184 The actual height of the font when displayed on F depends on the
2185 resolution of both the font and frame. For example, a 10pt font
2186 designed for a 100dpi display will display larger than 10pt on a
2187 75dpi display. (It's not unusual to use fonts not designed for the
2188 display one is using. For example, some intlfonts are available in
2189 72dpi versions, only.)
2191 Value is the real point size of FONT on frame F, or 0 if it cannot
2195 xlfd_point_size (f
, font
)
2197 struct font_name
*font
;
2199 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2200 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2204 if (*pixel_field
== '[')
2206 /* The pixel size field is `[A B C D]' which specifies
2207 a transformation matrix.
2213 by which all glyphs of the font are transformed. The spec
2214 says that s scalar value N for the pixel size is equivalent
2215 to A = N * resx/resy, B = C = 0, D = N. */
2216 char *start
= pixel_field
+ 1, *end
;
2220 for (i
= 0; i
< 4; ++i
)
2222 matrix
[i
] = strtod (start
, &end
);
2229 pixel
= atoi (pixel_field
);
2234 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2240 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2241 of frame F. This function is used to guess a point size of font
2242 when only the pixel height of the font is available. */
2245 pixel_point_size (f
, pixel
)
2249 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2253 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2254 point size of one dot. */
2255 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2256 int_pt
= real_pt
+ 0.5;
2262 /* Return a rescaling ratio of a font of NAME. */
2265 font_rescale_ratio (name
)
2268 Lisp_Object tail
, elt
;
2270 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2273 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2274 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2275 return XFLOAT_DATA (XCDR (elt
));
2281 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2282 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2283 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2284 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2285 zero if the font name doesn't have the format we expect. The
2286 expected format is a font name that starts with a `-' and has
2287 XLFD_LAST fields separated by `-'. */
2290 split_font_name (f
, font
, numeric_p
)
2292 struct font_name
*font
;
2297 double rescale_ratio
;
2300 /* This must be done before splitting the font name. */
2301 rescale_ratio
= font_rescale_ratio (font
->name
);
2303 if (*font
->name
== '-')
2305 char *p
= xstrlwr (font
->name
) + 1;
2307 while (i
< XLFD_LAST
)
2309 font
->fields
[i
] = p
;
2312 /* Pixel and point size may be of the form `[....]'. For
2313 BNF, see XLFD spec, chapter 4. Negative values are
2314 indicated by tilde characters which we replace with
2315 `-' characters, here. */
2317 && (i
- 1 == XLFD_PIXEL_SIZE
2318 || i
- 1 == XLFD_POINT_SIZE
))
2323 for (++p
; *p
&& *p
!= ']'; ++p
)
2327 /* Check that the matrix contains 4 floating point
2329 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2332 if (strtod (start
, &end
) == 0 && start
== end
)
2339 while (*p
&& *p
!= '-')
2349 success_p
= i
== XLFD_LAST
;
2351 /* If requested, and font name was in the expected format,
2352 compute numeric values for some fields. */
2353 if (numeric_p
&& success_p
)
2355 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2356 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2357 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2358 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2359 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2360 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2361 font
->rescale_ratio
= rescale_ratio
;
2364 /* Initialize it to zero. It will be overridden by font_list while
2365 trying alternate registries. */
2366 font
->registry_priority
= 0;
2372 /* Build an XLFD font name from font name fields in FONT. Value is a
2373 pointer to the font name, which is allocated via xmalloc. */
2376 build_font_name (font
)
2377 struct font_name
*font
;
2381 char *font_name
= (char *) xmalloc (size
);
2382 int total_length
= 0;
2384 for (i
= 0; i
< XLFD_LAST
; ++i
)
2386 /* Add 1 because of the leading `-'. */
2387 int len
= strlen (font
->fields
[i
]) + 1;
2389 /* Reallocate font_name if necessary. Add 1 for the final
2391 if (total_length
+ len
+ 1 >= size
)
2393 int new_size
= max (2 * size
, size
+ len
+ 1);
2394 int sz
= new_size
* sizeof *font_name
;
2395 font_name
= (char *) xrealloc (font_name
, sz
);
2399 font_name
[total_length
] = '-';
2400 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2401 total_length
+= len
;
2404 font_name
[total_length
] = 0;
2409 /* Free an array FONTS of N font_name structures. This frees FONTS
2410 itself and all `name' fields in its elements. */
2413 free_font_names (fonts
, n
)
2414 struct font_name
*fonts
;
2418 xfree (fonts
[--n
].name
);
2423 /* Sort vector FONTS of font_name structures which contains NFONTS
2424 elements using qsort and comparison function CMPFN. F is the frame
2425 on which the fonts will be used. The global variable font_frame
2426 is temporarily set to F to make it available in CMPFN. */
2429 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2431 struct font_name
*fonts
;
2433 int (*cmpfn
) P_ ((const void *, const void *));
2436 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2441 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2442 display in x_display_list. FONTS is a pointer to a vector of
2443 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2444 alternative patterns from Valternate_fontname_alist if no fonts are
2445 found matching PATTERN.
2447 For all fonts found, set FONTS[i].name to the name of the font,
2448 allocated via xmalloc, and split font names into fields. Ignore
2449 fonts that we can't parse. Value is the number of fonts found. */
2452 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2455 struct font_name
**pfonts
;
2456 int nfonts
, try_alternatives_p
;
2460 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2461 better to do it the other way around. */
2463 Lisp_Object lpattern
, tem
;
2464 struct font_name
*fonts
= 0;
2465 int num_fonts
= nfonts
;
2468 lpattern
= build_string (pattern
);
2470 /* Get the list of fonts matching PATTERN. */
2473 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2476 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2479 if (nfonts
< 0 && CONSP (lfonts
))
2480 num_fonts
= XFASTINT (Flength (lfonts
));
2482 /* Make a copy of the font names we got from X, and
2483 split them into fields. */
2485 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2487 Lisp_Object elt
, tail
;
2488 const char *name
= SDATA (XCAR (tem
));
2490 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2491 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2495 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2506 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2510 /* Make a copy of the font name. */
2511 fonts
[n
].name
= xstrdup (name
);
2513 if (split_font_name (f
, fonts
+ n
, 1))
2515 if (font_scalable_p (fonts
+ n
)
2516 && !may_use_scalable_font_p (name
))
2519 xfree (fonts
[n
].name
);
2525 xfree (fonts
[n
].name
);
2528 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2529 if (n
== 0 && try_alternatives_p
)
2531 Lisp_Object list
= Valternate_fontname_alist
;
2539 while (CONSP (list
))
2541 Lisp_Object entry
= XCAR (list
);
2543 && STRINGP (XCAR (entry
))
2544 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2551 Lisp_Object patterns
= XCAR (list
);
2554 while (CONSP (patterns
)
2555 /* If list is screwed up, give up. */
2556 && (name
= XCAR (patterns
),
2558 /* Ignore patterns equal to PATTERN because we tried that
2559 already with no success. */
2560 && (strcmp (SDATA (name
), pattern
) == 0
2561 || (n
= x_face_list_fonts (f
, SDATA (name
),
2564 patterns
= XCDR (patterns
);
2572 /* Check if a font matching pattern_offset_t on frame F is available
2573 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2574 a font name pattern is generated from FAMILY and REGISTRY. */
2577 face_font_available_p (f
, pattern
)
2579 Lisp_Object pattern
;
2583 if (! STRINGP (pattern
))
2585 Lisp_Object family
, registry
;
2586 char *family_str
, *registry_str
, *pattern_str
;
2588 CHECK_CONS (pattern
);
2589 family
= XCAR (pattern
);
2594 CHECK_STRING (family
);
2595 family_str
= (char *) SDATA (family
);
2597 registry
= XCDR (pattern
);
2598 if (NILP (registry
))
2602 CHECK_STRING (registry
);
2603 registry_str
= (char *) SDATA (registry
);
2606 pattern_str
= (char *) alloca (strlen (family_str
)
2607 + strlen (registry_str
)
2609 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2610 strcat (pattern_str
, family_str
);
2611 strcat (pattern_str
, "-*-");
2612 strcat (pattern_str
, registry_str
);
2613 if (!index (registry_str
, '-'))
2615 if (registry_str
[strlen (registry_str
) - 1] == '*')
2616 strcat (pattern_str
, "-*");
2618 strcat (pattern_str
, "*-*");
2620 pattern
= build_string (pattern_str
);
2623 /* Get the list of fonts matching PATTERN. */
2626 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2629 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2631 return XINT (Flength (fonts
));
2635 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2636 using comparison function CMPFN. Value is the number of fonts
2637 found. If value is non-zero, *FONTS is set to a vector of
2638 font_name structures allocated from the heap containing matching
2639 fonts. Each element of *FONTS contains a name member that is also
2640 allocated from the heap. Font names in these structures are split
2641 into fields. Use free_font_names to free such an array. */
2644 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2647 int (*cmpfn
) P_ ((const void *, const void *));
2648 struct font_name
**fonts
;
2652 /* Get the list of fonts matching pattern. 100 should suffice. */
2653 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2654 if (INTEGERP (Vfont_list_limit
))
2655 nfonts
= XINT (Vfont_list_limit
);
2658 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2660 /* Sort the resulting array and return it in *FONTS. If no
2661 fonts were found, make sure to set *FONTS to null. */
2663 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2674 /* Compare two font_name structures *A and *B. Value is analogous to
2675 strcmp. Sort order is given by the global variable
2676 font_sort_order. Font names are sorted so that, everything else
2677 being equal, fonts with a resolution closer to that of the frame on
2678 which they are used are listed first. The global variable
2679 font_frame is the frame on which we operate. */
2682 cmp_font_names (a
, b
)
2685 struct font_name
*x
= (struct font_name
*) a
;
2686 struct font_name
*y
= (struct font_name
*) b
;
2689 /* All strings have been converted to lower-case by split_font_name,
2690 so we can use strcmp here. */
2691 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2696 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2698 int j
= font_sort_order
[i
];
2699 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2704 /* Everything else being equal, we prefer fonts with an
2705 y-resolution closer to that of the frame. */
2706 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2707 int x_resy
= x
->numeric
[XLFD_RESY
];
2708 int y_resy
= y
->numeric
[XLFD_RESY
];
2709 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2717 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2718 is non-nil list fonts matching that pattern. Otherwise, if
2719 REGISTRY is non-nil return only fonts with that registry, otherwise
2720 return fonts of any registry. Set *FONTS to a vector of font_name
2721 structures allocated from the heap containing the fonts found.
2722 Value is the number of fonts found. */
2725 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2727 Lisp_Object pattern
, family
, registry
;
2728 struct font_name
**fonts
;
2730 char *pattern_str
, *family_str
, *registry_str
;
2734 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2735 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2737 pattern_str
= (char *) alloca (strlen (family_str
)
2738 + strlen (registry_str
)
2740 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2741 strcat (pattern_str
, family_str
);
2742 strcat (pattern_str
, "-*-");
2743 strcat (pattern_str
, registry_str
);
2744 if (!index (registry_str
, '-'))
2746 if (registry_str
[strlen (registry_str
) - 1] == '*')
2747 strcat (pattern_str
, "-*");
2749 strcat (pattern_str
, "*-*");
2753 pattern_str
= (char *) SDATA (pattern
);
2755 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2759 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2760 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2761 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2764 static struct font_name
*
2765 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2766 struct font_name
*fonts1
, *fonts2
;
2767 int nfonts1
, nfonts2
;
2769 int new_nfonts
= nfonts1
+ nfonts2
;
2770 struct font_name
*new_fonts
;
2772 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2773 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2774 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2781 /* Get a sorted list of fonts of family FAMILY on frame F.
2783 If PATTERN is non-nil list fonts matching that pattern.
2785 If REGISTRY is non-nil, return fonts with that registry and the
2786 alternative registries from Vface_alternative_font_registry_alist.
2788 If REGISTRY is nil return fonts of any registry.
2790 Set *FONTS to a vector of font_name structures allocated from the
2791 heap containing the fonts found. Value is the number of fonts
2795 font_list (f
, pattern
, family
, registry
, fonts
)
2797 Lisp_Object pattern
, family
, registry
;
2798 struct font_name
**fonts
;
2800 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2802 if (!NILP (registry
)
2803 && CONSP (Vface_alternative_font_registry_alist
))
2807 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2812 for (alter
= XCDR (alter
), reg_prio
= 1;
2814 alter
= XCDR (alter
), reg_prio
++)
2815 if (STRINGP (XCAR (alter
)))
2818 struct font_name
*fonts2
;
2820 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2822 for (i
= 0; i
< nfonts2
; i
++)
2823 fonts2
[i
].registry_priority
= reg_prio
;
2824 *fonts
= (nfonts
> 0
2825 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2836 /* Remove elements from LIST whose cars are `equal'. Called from
2837 x-family-fonts and x-font-family-list to remove duplicate font
2841 remove_duplicates (list
)
2844 Lisp_Object tail
= list
;
2846 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2848 Lisp_Object next
= XCDR (tail
);
2849 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2850 XSETCDR (tail
, XCDR (next
));
2857 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2858 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2859 If FAMILY is omitted or nil, list all families.
2860 Otherwise, FAMILY must be a string, possibly containing wildcards
2862 If FRAME is omitted or nil, use the selected frame.
2863 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2864 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2865 FAMILY is the font family name. POINT-SIZE is the size of the
2866 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2867 width, weight and slant of the font. These symbols are the same as for
2868 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2869 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2870 giving the registry and encoding of the font.
2871 The result list is sorted according to the current setting of
2872 the face font sort order. */)
2874 Lisp_Object family
, frame
;
2876 struct frame
*f
= check_x_frame (frame
);
2877 struct font_name
*fonts
;
2880 struct gcpro gcpro1
;
2883 CHECK_STRING (family
);
2887 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2888 for (i
= nfonts
- 1; i
>= 0; --i
)
2890 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2893 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2894 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2895 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2896 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2897 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2898 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2899 tem
= build_font_name (fonts
+ i
);
2900 ASET (v
, 6, build_string (tem
));
2901 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2902 fonts
[i
].fields
[XLFD_ENCODING
]);
2903 ASET (v
, 7, build_string (tem
));
2906 result
= Fcons (v
, result
);
2909 remove_duplicates (result
);
2910 free_font_names (fonts
, nfonts
);
2916 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2918 doc
: /* Return a list of available font families on FRAME.
2919 If FRAME is omitted or nil, use the selected frame.
2920 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2921 is a font family, and FIXED-P is non-nil if fonts of that family
2922 are fixed-pitch. */)
2926 struct frame
*f
= check_x_frame (frame
);
2928 struct font_name
*fonts
;
2930 struct gcpro gcpro1
;
2931 int count
= SPECPDL_INDEX ();
2933 /* Let's consider all fonts. */
2934 specbind (intern ("font-list-limit"), make_number (-1));
2935 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2939 for (i
= nfonts
- 1; i
>= 0; --i
)
2940 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2941 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2944 remove_duplicates (result
);
2945 free_font_names (fonts
, nfonts
);
2947 return unbind_to (count
, result
);
2951 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2952 doc
: /* Return a list of the names of available fonts matching PATTERN.
2953 If optional arguments FACE and FRAME are specified, return only fonts
2954 the same size as FACE on FRAME.
2955 PATTERN is a string, perhaps with wildcard characters;
2956 the * character matches any substring, and
2957 the ? character matches any single character.
2958 PATTERN is case-insensitive.
2959 FACE is a face name--a symbol.
2961 The return value is a list of strings, suitable as arguments to
2964 Fonts Emacs can't use may or may not be excluded
2965 even if they match PATTERN and FACE.
2966 The optional fourth argument MAXIMUM sets a limit on how many
2967 fonts to match. The first MAXIMUM fonts are reported.
2968 The optional fifth argument WIDTH, if specified, is a number of columns
2969 occupied by a character of a font. In that case, return only fonts
2970 the WIDTH times as wide as FACE on FRAME. */)
2971 (pattern
, face
, frame
, maximum
, width
)
2972 Lisp_Object pattern
, face
, frame
, maximum
, width
;
2979 CHECK_STRING (pattern
);
2985 CHECK_NATNUM (maximum
);
2986 maxnames
= XINT (maximum
);
2990 CHECK_NUMBER (width
);
2992 /* We can't simply call check_x_frame because this function may be
2993 called before any frame is created. */
2994 f
= frame_or_selected_frame (frame
, 2);
2995 if (!FRAME_WINDOW_P (f
))
2997 /* Perhaps we have not yet created any frame. */
3002 /* Determine the width standard for comparison with the fonts we find. */
3008 /* This is of limited utility since it works with character
3009 widths. Keep it for compatibility. --gerd. */
3010 int face_id
= lookup_named_face (f
, face
, 0);
3011 struct face
*face
= (face_id
< 0
3013 : FACE_FROM_ID (f
, face_id
));
3016 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3017 not maximum as on X. Redefine here. */
3019 #define FONT_WIDTH FONT_MAX_WIDTH
3022 if (face
&& face
->font
)
3023 size
= FONT_WIDTH (face
->font
);
3025 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3028 size
*= XINT (width
);
3032 Lisp_Object args
[2];
3034 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3036 /* We don't have to check fontsets. */
3038 args
[1] = list_fontsets (f
, pattern
, size
);
3039 return Fnconc (2, args
);
3043 #endif /* HAVE_WINDOW_SYSTEM */
3047 /***********************************************************************
3049 ***********************************************************************/
3051 /* Access face attributes of face LFACE, a Lisp vector. */
3053 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3054 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3055 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3056 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3057 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3058 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3059 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3060 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3061 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3062 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3063 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3064 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3065 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3066 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3067 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3068 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3070 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3071 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3073 #define LFACEP(LFACE) \
3075 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3076 && EQ (AREF (LFACE, 0), Qface))
3081 /* Check consistency of Lisp face attribute vector ATTRS. */
3084 check_lface_attrs (attrs
)
3087 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3088 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3089 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3090 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3091 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3092 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3093 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3094 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3095 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3096 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3097 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3098 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3099 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3100 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3101 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3102 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3103 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3104 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3105 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3106 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3107 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3108 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3109 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3110 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3111 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3112 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3113 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3114 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3115 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3116 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3117 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3118 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3119 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3120 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3121 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3122 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3123 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3124 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3125 #ifdef HAVE_WINDOW_SYSTEM
3126 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3127 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3128 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3129 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3130 || NILP (attrs
[LFACE_FONT_INDEX
])
3131 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3136 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3144 xassert (LFACEP (lface
));
3145 check_lface_attrs (XVECTOR (lface
)->contents
);
3149 #else /* GLYPH_DEBUG == 0 */
3151 #define check_lface_attrs(attrs) (void) 0
3152 #define check_lface(lface) (void) 0
3154 #endif /* GLYPH_DEBUG == 0 */
3157 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3158 to make it a symvol. If FACE_NAME is an alias for another face,
3159 return that face's name. */
3162 resolve_face_name (face_name
)
3163 Lisp_Object face_name
;
3165 Lisp_Object aliased
;
3167 if (STRINGP (face_name
))
3168 face_name
= intern (SDATA (face_name
));
3170 while (SYMBOLP (face_name
))
3172 aliased
= Fget (face_name
, Qface_alias
);
3176 face_name
= aliased
;
3183 /* Return the face definition of FACE_NAME on frame F. F null means
3184 return the definition for new frames. FACE_NAME may be a string or
3185 a symbol (apparently Emacs 20.2 allowed strings as face names in
3186 face text properties; Ediff uses that). If FACE_NAME is an alias
3187 for another face, return that face's definition. If SIGNAL_P is
3188 non-zero, signal an error if FACE_NAME is not a valid face name.
3189 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3192 static INLINE Lisp_Object
3193 lface_from_face_name (f
, face_name
, signal_p
)
3195 Lisp_Object face_name
;
3200 face_name
= resolve_face_name (face_name
);
3203 lface
= assq_no_quit (face_name
, f
->face_alist
);
3205 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3208 lface
= XCDR (lface
);
3210 signal_error ("Invalid face", face_name
);
3212 check_lface (lface
);
3217 /* Get face attributes of face FACE_NAME from frame-local faces on
3218 frame F. Store the resulting attributes in ATTRS which must point
3219 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3220 is non-zero, signal an error if FACE_NAME does not name a face.
3221 Otherwise, value is zero if FACE_NAME is not a face. */
3224 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3226 Lisp_Object face_name
;
3233 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3236 bcopy (XVECTOR (lface
)->contents
, attrs
,
3237 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3247 /* Non-zero if all attributes in face attribute vector ATTRS are
3248 specified, i.e. are non-nil. */
3251 lface_fully_specified_p (attrs
)
3256 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3257 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3258 && i
!= LFACE_AVGWIDTH_INDEX
)
3259 if (UNSPECIFIEDP (attrs
[i
])
3261 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3262 always unspecified. */
3263 && i
!= LFACE_STIPPLE_INDEX
3268 return i
== LFACE_VECTOR_SIZE
;
3271 #ifdef HAVE_WINDOW_SYSTEM
3273 /* Set font-related attributes of Lisp face LFACE from the fullname of
3274 the font opened by FONTNAME. If FORCE_P is zero, set only
3275 unspecified attributes of LFACE. The exception is `font'
3276 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3278 If FONTNAME is not available on frame F,
3279 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3280 If the fullname is not in a valid XLFD format,
3281 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3282 in LFACE and return 1.
3283 Otherwise, return 1. */
3286 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3289 Lisp_Object fontname
;
3290 int force_p
, may_fail_p
;
3292 struct font_name font
;
3297 char *font_name
= SDATA (fontname
);
3298 struct font_info
*font_info
;
3300 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3301 fontset
= fs_query_fontset (fontname
, 0);
3303 font_name
= SDATA (fontset_ascii (fontset
));
3305 /* Check if FONT_NAME is surely available on the system. Usually
3306 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3307 returns quickly. But, even if FONT_NAME is not yet cached,
3308 caching it now is not futail because we anyway load the font
3311 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3321 font
.name
= STRDUPA (font_info
->full_name
);
3322 have_xlfd_p
= split_font_name (f
, &font
, 1);
3324 /* Set attributes only if unspecified, otherwise face defaults for
3325 new frames would never take effect. If we couldn't get a font
3326 name conforming to XLFD, set normal values. */
3328 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3333 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3334 + strlen (font
.fields
[XLFD_FOUNDRY
])
3336 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3337 font
.fields
[XLFD_FAMILY
]);
3338 val
= build_string (buffer
);
3341 val
= build_string ("*");
3342 LFACE_FAMILY (lface
) = val
;
3345 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3348 pt
= xlfd_point_size (f
, &font
);
3350 pt
= pixel_point_size (f
, font_info
->height
* 10);
3352 LFACE_HEIGHT (lface
) = make_number (pt
);
3355 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3356 LFACE_SWIDTH (lface
)
3357 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3359 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3360 LFACE_AVGWIDTH (lface
)
3362 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3365 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3366 LFACE_WEIGHT (lface
)
3367 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3369 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3371 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3373 LFACE_FONT (lface
) = fontname
;
3378 #endif /* HAVE_WINDOW_SYSTEM */
3381 /* Merges the face height FROM with the face height TO, and returns the
3382 merged height. If FROM is an invalid height, then INVALID is
3383 returned instead. FROM and TO may be either absolute face heights or
3384 `relative' heights; the returned value is always an absolute height
3385 unless both FROM and TO are relative. GCPRO is a lisp value that
3386 will be protected from garbage-collection if this function makes a
3390 merge_face_heights (from
, to
, invalid
, gcpro
)
3391 Lisp_Object from
, to
, invalid
, gcpro
;
3393 Lisp_Object result
= invalid
;
3395 if (INTEGERP (from
))
3396 /* FROM is absolute, just use it as is. */
3398 else if (FLOATP (from
))
3399 /* FROM is a scale, use it to adjust TO. */
3402 /* relative X absolute => absolute */
3403 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3404 else if (FLOATP (to
))
3405 /* relative X relative => relative */
3406 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3408 else if (FUNCTIONP (from
))
3409 /* FROM is a function, which use to adjust TO. */
3411 /* Call function with current height as argument.
3412 From is the new height. */
3413 Lisp_Object args
[2];
3414 struct gcpro gcpro1
;
3420 result
= safe_call (2, args
);
3424 /* Ensure that if TO was absolute, so is the result. */
3425 if (INTEGERP (to
) && !INTEGERP (result
))
3433 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3434 store the resulting attributes in TO, which must be already be
3435 completely specified and contain only absolute attributes. Every
3436 specified attribute of FROM overrides the corresponding attribute of
3437 TO; relative attributes in FROM are merged with the absolute value in
3438 TO and replace it. CYCLE_CHECK is used internally to detect loops in
3439 face inheritance; it should be Qnil when called from other places. */
3442 merge_face_vectors (f
, from
, to
, cycle_check
)
3444 Lisp_Object
*from
, *to
;
3445 Lisp_Object cycle_check
;
3449 /* If FROM inherits from some other faces, merge their attributes into
3450 TO before merging FROM's direct attributes. Note that an :inherit
3451 attribute of `unspecified' is the same as one of nil; we never
3452 merge :inherit attributes, so nil is more correct, but lots of
3453 other code uses `unspecified' as a generic value for face attributes. */
3454 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3455 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3456 merge_face_inheritance (f
, from
[LFACE_INHERIT_INDEX
], to
, cycle_check
);
3458 /* If TO specifies a :font attribute, and FROM specifies some
3459 font-related attribute, we need to clear TO's :font attribute
3460 (because it will be inconsistent with whatever FROM specifies, and
3461 FROM takes precedence). */
3462 if (!NILP (to
[LFACE_FONT_INDEX
])
3463 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3464 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3465 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3466 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3467 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3468 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3469 to
[LFACE_FONT_INDEX
] = Qnil
;
3471 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3472 if (!UNSPECIFIEDP (from
[i
]))
3474 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3475 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
], cycle_check
);
3480 /* TO is always an absolute face, which should inherit from nothing.
3481 We blindly copy the :inherit attribute above and fix it up here. */
3482 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3485 /* Merge face attributes from the face on frame F whose name is
3486 INHERITS, into the vector of face attributes TO; INHERITS may also be
3487 a list of face names, in which case they are applied in order.
3488 CYCLE_CHECK is used to detect loops in face inheritance.
3489 Returns true if any of the inherited attributes are `font-related'. */
3492 merge_face_inheritance (f
, inherit
, to
, cycle_check
)
3494 Lisp_Object inherit
;
3496 Lisp_Object cycle_check
;
3498 if (SYMBOLP (inherit
) && !EQ (inherit
, Qunspecified
))
3499 /* Inherit from the named face INHERIT. */
3503 /* Make sure we're not in an inheritance loop. */
3504 cycle_check
= CYCLE_CHECK (cycle_check
, inherit
, 15);
3505 if (NILP (cycle_check
))
3506 /* Cycle detected, ignore any further inheritance. */
3509 lface
= lface_from_face_name (f
, inherit
, 0);
3511 merge_face_vectors (f
, XVECTOR (lface
)->contents
, to
, cycle_check
);
3513 else if (CONSP (inherit
))
3514 /* Handle a list of inherited faces by calling ourselves recursively
3515 on each element. Note that we only do so for symbol elements, so
3516 it's not possible to infinitely recurse. */
3518 while (CONSP (inherit
))
3520 if (SYMBOLP (XCAR (inherit
)))
3521 merge_face_inheritance (f
, XCAR (inherit
), to
, cycle_check
);
3523 /* Check for a circular inheritance list. */
3524 cycle_check
= CYCLE_CHECK (cycle_check
, inherit
, 15);
3525 if (NILP (cycle_check
))
3526 /* Cycle detected. */
3529 inherit
= XCDR (inherit
);
3535 /* Given a Lisp face attribute vector TO and a Lisp object PROP that
3536 is a face property, determine the resulting face attributes on
3537 frame F, and store them in TO. PROP may be a single face
3538 specification or a list of such specifications. Each face
3539 specification can be
3541 1. A symbol or string naming a Lisp face.
3543 2. A property list of the form (KEYWORD VALUE ...) where each
3544 KEYWORD is a face attribute name, and value is an appropriate value
3547 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3548 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3549 for compatibility with 20.2.
3551 Face specifications earlier in lists take precedence over later
3555 merge_face_vector_with_property (f
, to
, prop
)
3562 Lisp_Object first
= XCAR (prop
);
3564 if (EQ (first
, Qforeground_color
)
3565 || EQ (first
, Qbackground_color
))
3567 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3568 . COLOR). COLOR must be a string. */
3569 Lisp_Object color_name
= XCDR (prop
);
3570 Lisp_Object color
= first
;
3572 if (STRINGP (color_name
))
3574 if (EQ (color
, Qforeground_color
))
3575 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3577 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3580 add_to_log ("Invalid face color", color_name
, Qnil
);
3582 else if (SYMBOLP (first
)
3583 && *SDATA (SYMBOL_NAME (first
)) == ':')
3585 /* Assume this is the property list form. */
3586 while (CONSP (prop
) && CONSP (XCDR (prop
)))
3588 Lisp_Object keyword
= XCAR (prop
);
3589 Lisp_Object value
= XCAR (XCDR (prop
));
3591 if (EQ (keyword
, QCfamily
))
3593 if (STRINGP (value
))
3594 to
[LFACE_FAMILY_INDEX
] = value
;
3596 add_to_log ("Invalid face font family", value
, Qnil
);
3598 else if (EQ (keyword
, QCheight
))
3600 Lisp_Object new_height
=
3601 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
],
3604 if (NILP (new_height
))
3605 add_to_log ("Invalid face font height", value
, Qnil
);
3607 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3609 else if (EQ (keyword
, QCweight
))
3612 && face_numeric_weight (value
) >= 0)
3613 to
[LFACE_WEIGHT_INDEX
] = value
;
3615 add_to_log ("Invalid face weight", value
, Qnil
);
3617 else if (EQ (keyword
, QCslant
))
3620 && face_numeric_slant (value
) >= 0)
3621 to
[LFACE_SLANT_INDEX
] = value
;
3623 add_to_log ("Invalid face slant", value
, Qnil
);
3625 else if (EQ (keyword
, QCunderline
))
3630 to
[LFACE_UNDERLINE_INDEX
] = value
;
3632 add_to_log ("Invalid face underline", value
, Qnil
);
3634 else if (EQ (keyword
, QCoverline
))
3639 to
[LFACE_OVERLINE_INDEX
] = value
;
3641 add_to_log ("Invalid face overline", value
, Qnil
);
3643 else if (EQ (keyword
, QCstrike_through
))
3648 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3650 add_to_log ("Invalid face strike-through", value
, Qnil
);
3652 else if (EQ (keyword
, QCbox
))
3655 value
= make_number (1);
3656 if (INTEGERP (value
)
3660 to
[LFACE_BOX_INDEX
] = value
;
3662 add_to_log ("Invalid face box", value
, Qnil
);
3664 else if (EQ (keyword
, QCinverse_video
)
3665 || EQ (keyword
, QCreverse_video
))
3667 if (EQ (value
, Qt
) || NILP (value
))
3668 to
[LFACE_INVERSE_INDEX
] = value
;
3670 add_to_log ("Invalid face inverse-video", value
, Qnil
);
3672 else if (EQ (keyword
, QCforeground
))
3674 if (STRINGP (value
))
3675 to
[LFACE_FOREGROUND_INDEX
] = value
;
3677 add_to_log ("Invalid face foreground", value
, Qnil
);
3679 else if (EQ (keyword
, QCbackground
))
3681 if (STRINGP (value
))
3682 to
[LFACE_BACKGROUND_INDEX
] = value
;
3684 add_to_log ("Invalid face background", value
, Qnil
);
3686 else if (EQ (keyword
, QCstipple
))
3688 #ifdef HAVE_X_WINDOWS
3689 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3690 if (!NILP (pixmap_p
))
3691 to
[LFACE_STIPPLE_INDEX
] = value
;
3693 add_to_log ("Invalid face stipple", value
, Qnil
);
3696 else if (EQ (keyword
, QCwidth
))
3699 && face_numeric_swidth (value
) >= 0)
3700 to
[LFACE_SWIDTH_INDEX
] = value
;
3702 add_to_log ("Invalid face width", value
, Qnil
);
3704 else if (EQ (keyword
, QCinherit
))
3706 if (SYMBOLP (value
))
3707 to
[LFACE_INHERIT_INDEX
] = value
;
3711 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
3712 if (!SYMBOLP (XCAR (tail
)))
3715 to
[LFACE_INHERIT_INDEX
] = value
;
3717 add_to_log ("Invalid face inherit", value
, Qnil
);
3721 add_to_log ("Invalid attribute %s in face property",
3724 prop
= XCDR (XCDR (prop
));
3729 /* This is a list of face specs. Specifications at the
3730 beginning of the list take precedence over later
3731 specifications, so we have to merge starting with the
3732 last specification. */
3733 Lisp_Object next
= XCDR (prop
);
3735 merge_face_vector_with_property (f
, to
, next
);
3736 merge_face_vector_with_property (f
, to
, first
);
3741 /* PROP ought to be a face name. */
3742 Lisp_Object lface
= lface_from_face_name (f
, prop
, 0);
3744 add_to_log ("Invalid face text property value: %s", prop
, Qnil
);
3746 merge_face_vectors (f
, XVECTOR (lface
)->contents
, to
, Qnil
);
3751 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3752 Sinternal_make_lisp_face
, 1, 2, 0,
3753 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3754 If FACE was not known as a face before, create a new one.
3755 If optional argument FRAME is specified, make a frame-local face
3756 for that frame. Otherwise operate on the global face definition.
3757 Value is a vector of face attributes. */)
3759 Lisp_Object face
, frame
;
3761 Lisp_Object global_lface
, lface
;
3765 CHECK_SYMBOL (face
);
3766 global_lface
= lface_from_face_name (NULL
, face
, 0);
3770 CHECK_LIVE_FRAME (frame
);
3772 lface
= lface_from_face_name (f
, face
, 0);
3775 f
= NULL
, lface
= Qnil
;
3777 /* Add a global definition if there is none. */
3778 if (NILP (global_lface
))
3780 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3782 AREF (global_lface
, 0) = Qface
;
3783 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3784 Vface_new_frame_defaults
);
3786 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3787 face id to Lisp face is given by the vector lface_id_to_name.
3788 The mapping from Lisp face to Lisp face id is given by the
3789 property `face' of the Lisp face name. */
3790 if (next_lface_id
== lface_id_to_name_size
)
3792 int new_size
= max (50, 2 * lface_id_to_name_size
);
3793 int sz
= new_size
* sizeof *lface_id_to_name
;
3794 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3795 lface_id_to_name_size
= new_size
;
3798 lface_id_to_name
[next_lface_id
] = face
;
3799 Fput (face
, Qface
, make_number (next_lface_id
));
3803 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3804 AREF (global_lface
, i
) = Qunspecified
;
3806 /* Add a frame-local definition. */
3811 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3813 AREF (lface
, 0) = Qface
;
3814 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3817 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3818 AREF (lface
, i
) = Qunspecified
;
3821 lface
= global_lface
;
3823 /* Changing a named face means that all realized faces depending on
3824 that face are invalid. Since we cannot tell which realized faces
3825 depend on the face, make sure they are all removed. This is done
3826 by incrementing face_change_count. The next call to
3827 init_iterator will then free realized faces. */
3828 ++face_change_count
;
3829 ++windows_or_buffers_changed
;
3831 xassert (LFACEP (lface
));
3832 check_lface (lface
);
3837 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3838 Sinternal_lisp_face_p
, 1, 2, 0,
3839 doc
: /* Return non-nil if FACE names a face.
3840 If optional second parameter FRAME is non-nil, check for the
3841 existence of a frame-local face with name FACE on that frame.
3842 Otherwise check for the existence of a global face. */)
3844 Lisp_Object face
, frame
;
3850 CHECK_LIVE_FRAME (frame
);
3851 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3854 lface
= lface_from_face_name (NULL
, face
, 0);
3860 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3861 Sinternal_copy_lisp_face
, 4, 4, 0,
3862 doc
: /* Copy face FROM to TO.
3863 If FRAME it t, copy the global face definition of FROM to the
3864 global face definition of TO. Otherwise, copy the frame-local
3865 definition of FROM on FRAME to the frame-local definition of TO
3866 on NEW-FRAME, or FRAME if NEW-FRAME is nil.
3869 (from
, to
, frame
, new_frame
)
3870 Lisp_Object from
, to
, frame
, new_frame
;
3872 Lisp_Object lface
, copy
;
3874 CHECK_SYMBOL (from
);
3876 if (NILP (new_frame
))
3881 /* Copy global definition of FROM. We don't make copies of
3882 strings etc. because 20.2 didn't do it either. */
3883 lface
= lface_from_face_name (NULL
, from
, 1);
3884 copy
= Finternal_make_lisp_face (to
, Qnil
);
3888 /* Copy frame-local definition of FROM. */
3889 CHECK_LIVE_FRAME (frame
);
3890 CHECK_LIVE_FRAME (new_frame
);
3891 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3892 copy
= Finternal_make_lisp_face (to
, new_frame
);
3895 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3896 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
3898 /* Changing a named face means that all realized faces depending on
3899 that face are invalid. Since we cannot tell which realized faces
3900 depend on the face, make sure they are all removed. This is done
3901 by incrementing face_change_count. The next call to
3902 init_iterator will then free realized faces. */
3903 ++face_change_count
;
3904 ++windows_or_buffers_changed
;
3910 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
3911 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
3912 doc
: /* Set attribute ATTR of FACE to VALUE.
3913 FRAME being a frame means change the face on that frame.
3914 FRAME nil means change the face of the selected frame.
3915 FRAME t means change the default for new frames.
3916 FRAME 0 means change the face on all frames, and change the default
3918 (face
, attr
, value
, frame
)
3919 Lisp_Object face
, attr
, value
, frame
;
3922 Lisp_Object old_value
= Qnil
;
3923 /* Set 1 if ATTR is QCfont. */
3924 int font_attr_p
= 0;
3925 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
3926 int font_related_attr_p
= 0;
3928 CHECK_SYMBOL (face
);
3929 CHECK_SYMBOL (attr
);
3931 face
= resolve_face_name (face
);
3933 /* If FRAME is 0, change face on all frames, and change the
3934 default for new frames. */
3935 if (INTEGERP (frame
) && XINT (frame
) == 0)
3938 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
3939 FOR_EACH_FRAME (tail
, frame
)
3940 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
3944 /* Set lface to the Lisp attribute vector of FACE. */
3946 lface
= lface_from_face_name (NULL
, face
, 1);
3950 frame
= selected_frame
;
3952 CHECK_LIVE_FRAME (frame
);
3953 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3955 /* If a frame-local face doesn't exist yet, create one. */
3957 lface
= Finternal_make_lisp_face (face
, frame
);
3960 if (EQ (attr
, QCfamily
))
3962 if (!UNSPECIFIEDP (value
))
3964 CHECK_STRING (value
);
3965 if (SCHARS (value
) == 0)
3966 signal_error ("Invalid face family", value
);
3968 old_value
= LFACE_FAMILY (lface
);
3969 LFACE_FAMILY (lface
) = value
;
3970 font_related_attr_p
= 1;
3972 else if (EQ (attr
, QCheight
))
3974 if (!UNSPECIFIEDP (value
))
3978 test
= (EQ (face
, Qdefault
)
3980 /* The default face must have an absolute size,
3981 otherwise, we do a test merge with a random
3982 height to see if VALUE's ok. */
3983 : merge_face_heights (value
, make_number (10), Qnil
, Qnil
));
3985 if (!INTEGERP (test
) || XINT (test
) <= 0)
3986 signal_error ("Invalid face height", value
);
3989 old_value
= LFACE_HEIGHT (lface
);
3990 LFACE_HEIGHT (lface
) = value
;
3991 font_related_attr_p
= 1;
3993 else if (EQ (attr
, QCweight
))
3995 if (!UNSPECIFIEDP (value
))
3997 CHECK_SYMBOL (value
);
3998 if (face_numeric_weight (value
) < 0)
3999 signal_error ("Invalid face weight", value
);
4001 old_value
= LFACE_WEIGHT (lface
);
4002 LFACE_WEIGHT (lface
) = value
;
4003 font_related_attr_p
= 1;
4005 else if (EQ (attr
, QCslant
))
4007 if (!UNSPECIFIEDP (value
))
4009 CHECK_SYMBOL (value
);
4010 if (face_numeric_slant (value
) < 0)
4011 signal_error ("Invalid face slant", value
);
4013 old_value
= LFACE_SLANT (lface
);
4014 LFACE_SLANT (lface
) = value
;
4015 font_related_attr_p
= 1;
4017 else if (EQ (attr
, QCunderline
))
4019 if (!UNSPECIFIEDP (value
))
4020 if ((SYMBOLP (value
)
4022 && !EQ (value
, Qnil
))
4023 /* Underline color. */
4025 && SCHARS (value
) == 0))
4026 signal_error ("Invalid face underline", value
);
4028 old_value
= LFACE_UNDERLINE (lface
);
4029 LFACE_UNDERLINE (lface
) = value
;
4031 else if (EQ (attr
, QCoverline
))
4033 if (!UNSPECIFIEDP (value
))
4034 if ((SYMBOLP (value
)
4036 && !EQ (value
, Qnil
))
4037 /* Overline color. */
4039 && SCHARS (value
) == 0))
4040 signal_error ("Invalid face overline", value
);
4042 old_value
= LFACE_OVERLINE (lface
);
4043 LFACE_OVERLINE (lface
) = value
;
4045 else if (EQ (attr
, QCstrike_through
))
4047 if (!UNSPECIFIEDP (value
))
4048 if ((SYMBOLP (value
)
4050 && !EQ (value
, Qnil
))
4051 /* Strike-through color. */
4053 && SCHARS (value
) == 0))
4054 signal_error ("Invalid face strike-through", value
);
4056 old_value
= LFACE_STRIKE_THROUGH (lface
);
4057 LFACE_STRIKE_THROUGH (lface
) = value
;
4059 else if (EQ (attr
, QCbox
))
4063 /* Allow t meaning a simple box of width 1 in foreground color
4066 value
= make_number (1);
4068 if (UNSPECIFIEDP (value
))
4070 else if (NILP (value
))
4072 else if (INTEGERP (value
))
4073 valid_p
= XINT (value
) != 0;
4074 else if (STRINGP (value
))
4075 valid_p
= SCHARS (value
) > 0;
4076 else if (CONSP (value
))
4092 if (EQ (k
, QCline_width
))
4094 if (!INTEGERP (v
) || XINT (v
) == 0)
4097 else if (EQ (k
, QCcolor
))
4099 if (!STRINGP (v
) || SCHARS (v
) == 0)
4102 else if (EQ (k
, QCstyle
))
4104 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4111 valid_p
= NILP (tem
);
4117 signal_error ("Invalid face box", value
);
4119 old_value
= LFACE_BOX (lface
);
4120 LFACE_BOX (lface
) = value
;
4122 else if (EQ (attr
, QCinverse_video
)
4123 || EQ (attr
, QCreverse_video
))
4125 if (!UNSPECIFIEDP (value
))
4127 CHECK_SYMBOL (value
);
4128 if (!EQ (value
, Qt
) && !NILP (value
))
4129 signal_error ("Invalid inverse-video face attribute value", value
);
4131 old_value
= LFACE_INVERSE (lface
);
4132 LFACE_INVERSE (lface
) = value
;
4134 else if (EQ (attr
, QCforeground
))
4136 if (!UNSPECIFIEDP (value
))
4138 /* Don't check for valid color names here because it depends
4139 on the frame (display) whether the color will be valid
4140 when the face is realized. */
4141 CHECK_STRING (value
);
4142 if (SCHARS (value
) == 0)
4143 signal_error ("Empty foreground color value", value
);
4145 old_value
= LFACE_FOREGROUND (lface
);
4146 LFACE_FOREGROUND (lface
) = value
;
4148 else if (EQ (attr
, QCbackground
))
4150 if (!UNSPECIFIEDP (value
))
4152 /* Don't check for valid color names here because it depends
4153 on the frame (display) whether the color will be valid
4154 when the face is realized. */
4155 CHECK_STRING (value
);
4156 if (SCHARS (value
) == 0)
4157 signal_error ("Empty background color value", value
);
4159 old_value
= LFACE_BACKGROUND (lface
);
4160 LFACE_BACKGROUND (lface
) = value
;
4162 else if (EQ (attr
, QCstipple
))
4164 #ifdef HAVE_X_WINDOWS
4165 if (!UNSPECIFIEDP (value
)
4167 && NILP (Fbitmap_spec_p (value
)))
4168 signal_error ("Invalid stipple attribute", value
);
4169 old_value
= LFACE_STIPPLE (lface
);
4170 LFACE_STIPPLE (lface
) = value
;
4171 #endif /* HAVE_X_WINDOWS */
4173 else if (EQ (attr
, QCwidth
))
4175 if (!UNSPECIFIEDP (value
))
4177 CHECK_SYMBOL (value
);
4178 if (face_numeric_swidth (value
) < 0)
4179 signal_error ("Invalid face width", value
);
4181 old_value
= LFACE_SWIDTH (lface
);
4182 LFACE_SWIDTH (lface
) = value
;
4183 font_related_attr_p
= 1;
4185 else if (EQ (attr
, QCfont
))
4187 #ifdef HAVE_WINDOW_SYSTEM
4188 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4190 /* Set font-related attributes of the Lisp face from an XLFD
4196 f
= SELECTED_FRAME ();
4198 f
= check_x_frame (frame
);
4200 if (!UNSPECIFIEDP (value
))
4202 CHECK_STRING (value
);
4204 /* VALUE may be a fontset name or an alias of fontset. In
4205 such a case, use the base fontset name. */
4206 tmp
= Fquery_fontset (value
, Qnil
);
4210 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4211 signal_error ("Invalid font or fontset name", value
);
4216 #endif /* HAVE_WINDOW_SYSTEM */
4218 else if (EQ (attr
, QCinherit
))
4221 if (SYMBOLP (value
))
4224 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4225 if (!SYMBOLP (XCAR (tail
)))
4228 LFACE_INHERIT (lface
) = value
;
4230 signal_error ("Invalid face inheritance", value
);
4232 else if (EQ (attr
, QCbold
))
4234 old_value
= LFACE_WEIGHT (lface
);
4235 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4236 font_related_attr_p
= 1;
4238 else if (EQ (attr
, QCitalic
))
4240 old_value
= LFACE_SLANT (lface
);
4241 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4242 font_related_attr_p
= 1;
4245 signal_error ("Invalid face attribute name", attr
);
4247 if (font_related_attr_p
4248 && !UNSPECIFIEDP (value
))
4249 /* If a font-related attribute other than QCfont is specified, the
4250 original `font' attribute nor that of default face is useless
4251 to determine a new font. Thus, we set it to nil so that font
4252 selection mechanism doesn't use it. */
4253 LFACE_FONT (lface
) = Qnil
;
4255 /* Changing a named face means that all realized faces depending on
4256 that face are invalid. Since we cannot tell which realized faces
4257 depend on the face, make sure they are all removed. This is done
4258 by incrementing face_change_count. The next call to
4259 init_iterator will then free realized faces. */
4261 && (EQ (attr
, QCfont
)
4262 || NILP (Fequal (old_value
, value
))))
4264 ++face_change_count
;
4265 ++windows_or_buffers_changed
;
4268 if (!UNSPECIFIEDP (value
)
4269 && NILP (Fequal (old_value
, value
)))
4275 if (EQ (face
, Qdefault
))
4277 #ifdef HAVE_WINDOW_SYSTEM
4278 /* Changed font-related attributes of the `default' face are
4279 reflected in changed `font' frame parameters. */
4281 && (font_related_attr_p
|| font_attr_p
)
4282 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4283 set_font_frame_param (frame
, lface
);
4285 #endif /* HAVE_WINDOW_SYSTEM */
4287 if (EQ (attr
, QCforeground
))
4288 param
= Qforeground_color
;
4289 else if (EQ (attr
, QCbackground
))
4290 param
= Qbackground_color
;
4292 #ifdef HAVE_WINDOW_SYSTEM
4294 else if (EQ (face
, Qscroll_bar
))
4296 /* Changing the colors of `scroll-bar' sets frame parameters
4297 `scroll-bar-foreground' and `scroll-bar-background'. */
4298 if (EQ (attr
, QCforeground
))
4299 param
= Qscroll_bar_foreground
;
4300 else if (EQ (attr
, QCbackground
))
4301 param
= Qscroll_bar_background
;
4303 #endif /* not WINDOWSNT */
4304 else if (EQ (face
, Qborder
))
4306 /* Changing background color of `border' sets frame parameter
4308 if (EQ (attr
, QCbackground
))
4309 param
= Qborder_color
;
4311 else if (EQ (face
, Qcursor
))
4313 /* Changing background color of `cursor' sets frame parameter
4315 if (EQ (attr
, QCbackground
))
4316 param
= Qcursor_color
;
4318 else if (EQ (face
, Qmouse
))
4320 /* Changing background color of `mouse' sets frame parameter
4322 if (EQ (attr
, QCbackground
))
4323 param
= Qmouse_color
;
4325 #endif /* HAVE_WINDOW_SYSTEM */
4326 else if (EQ (face
, Qmenu
))
4328 /* Indicate that we have to update the menu bar when
4329 realizing faces on FRAME. FRAME t change the
4330 default for new frames. We do this by setting
4331 setting the flag in new face caches */
4334 struct frame
*f
= XFRAME (frame
);
4335 if (FRAME_FACE_CACHE (f
) == NULL
)
4336 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4337 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4340 menu_face_changed_default
= 1;
4346 /* Update `default-frame-alist', which is used for new frames. */
4348 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4351 /* Update the current frame's parameters. */
4354 cons
= XCAR (Vparam_value_alist
);
4355 XSETCAR (cons
, param
);
4356 XSETCDR (cons
, value
);
4357 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4366 #ifdef HAVE_WINDOW_SYSTEM
4368 /* Set the `font' frame parameter of FRAME determined from `default'
4369 face attributes LFACE. If a face or fontset name is explicitely
4370 specfied in LFACE, use it as is. Otherwise, determine a font name
4371 from the other font-related atrributes of LFACE. In that case, if
4372 there's no matching font, signals an error. */
4375 set_font_frame_param (frame
, lface
)
4376 Lisp_Object frame
, lface
;
4378 struct frame
*f
= XFRAME (frame
);
4380 if (FRAME_WINDOW_P (f
))
4382 Lisp_Object font_name
;
4385 if (STRINGP (LFACE_FONT (lface
)))
4386 font_name
= LFACE_FONT (lface
);
4389 /* Choose a font name that reflects LFACE's attributes and has
4390 the registry and encoding pattern specified in the default
4391 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4392 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4394 error ("No font matches the specified attribute");
4395 font_name
= build_string (font
);
4399 f
->default_face_done_p
= 0;
4400 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4405 /* Update the corresponding face when frame parameter PARAM on frame F
4406 has been assigned the value NEW_VALUE. */
4409 update_face_from_frame_parameter (f
, param
, new_value
)
4411 Lisp_Object param
, new_value
;
4415 /* If there are no faces yet, give up. This is the case when called
4416 from Fx_create_frame, and we do the necessary things later in
4417 face-set-after-frame-defaults. */
4418 if (NILP (f
->face_alist
))
4421 /* Changing a named face means that all realized faces depending on
4422 that face are invalid. Since we cannot tell which realized faces
4423 depend on the face, make sure they are all removed. This is done
4424 by incrementing face_change_count. The next call to
4425 init_iterator will then free realized faces. */
4426 ++face_change_count
;
4427 ++windows_or_buffers_changed
;
4429 if (EQ (param
, Qforeground_color
))
4431 lface
= lface_from_face_name (f
, Qdefault
, 1);
4432 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4433 ? new_value
: Qunspecified
);
4434 realize_basic_faces (f
);
4436 else if (EQ (param
, Qbackground_color
))
4440 /* Changing the background color might change the background
4441 mode, so that we have to load new defface specs. Call
4442 frame-update-face-colors to do that. */
4443 XSETFRAME (frame
, f
);
4444 call1 (Qframe_update_face_colors
, frame
);
4446 lface
= lface_from_face_name (f
, Qdefault
, 1);
4447 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4448 ? new_value
: Qunspecified
);
4449 realize_basic_faces (f
);
4451 if (EQ (param
, Qborder_color
))
4453 lface
= lface_from_face_name (f
, Qborder
, 1);
4454 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4455 ? new_value
: Qunspecified
);
4457 else if (EQ (param
, Qcursor_color
))
4459 lface
= lface_from_face_name (f
, Qcursor
, 1);
4460 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4461 ? new_value
: Qunspecified
);
4463 else if (EQ (param
, Qmouse_color
))
4465 lface
= lface_from_face_name (f
, Qmouse
, 1);
4466 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4467 ? new_value
: Qunspecified
);
4472 /* Get the value of X resource RESOURCE, class CLASS for the display
4473 of frame FRAME. This is here because ordinary `x-get-resource'
4474 doesn't take a frame argument. */
4476 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4477 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4478 (resource
, class, frame
)
4479 Lisp_Object resource
, class, frame
;
4481 Lisp_Object value
= Qnil
;
4482 CHECK_STRING (resource
);
4483 CHECK_STRING (class);
4484 CHECK_LIVE_FRAME (frame
);
4486 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4487 resource
, class, Qnil
, Qnil
);
4493 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4494 If VALUE is "on" or "true", return t. If VALUE is "off" or
4495 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4496 error; if SIGNAL_P is zero, return 0. */
4499 face_boolean_x_resource_value (value
, signal_p
)
4503 Lisp_Object result
= make_number (0);
4505 xassert (STRINGP (value
));
4507 if (xstricmp (SDATA (value
), "on") == 0
4508 || xstricmp (SDATA (value
), "true") == 0)
4510 else if (xstricmp (SDATA (value
), "off") == 0
4511 || xstricmp (SDATA (value
), "false") == 0)
4513 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4514 result
= Qunspecified
;
4516 signal_error ("Invalid face attribute value from X resource", value
);
4522 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4523 Finternal_set_lisp_face_attribute_from_resource
,
4524 Sinternal_set_lisp_face_attribute_from_resource
,
4525 3, 4, 0, doc
: /* */)
4526 (face
, attr
, value
, frame
)
4527 Lisp_Object face
, attr
, value
, frame
;
4529 CHECK_SYMBOL (face
);
4530 CHECK_SYMBOL (attr
);
4531 CHECK_STRING (value
);
4533 if (xstricmp (SDATA (value
), "unspecified") == 0)
4534 value
= Qunspecified
;
4535 else if (EQ (attr
, QCheight
))
4537 value
= Fstring_to_number (value
, make_number (10));
4538 if (XINT (value
) <= 0)
4539 signal_error ("Invalid face height from X resource", value
);
4541 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4542 value
= face_boolean_x_resource_value (value
, 1);
4543 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4544 value
= intern (SDATA (value
));
4545 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4546 value
= face_boolean_x_resource_value (value
, 1);
4547 else if (EQ (attr
, QCunderline
)
4548 || EQ (attr
, QCoverline
)
4549 || EQ (attr
, QCstrike_through
))
4551 Lisp_Object boolean_value
;
4553 /* If the result of face_boolean_x_resource_value is t or nil,
4554 VALUE does NOT specify a color. */
4555 boolean_value
= face_boolean_x_resource_value (value
, 0);
4556 if (SYMBOLP (boolean_value
))
4557 value
= boolean_value
;
4559 else if (EQ (attr
, QCbox
))
4560 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4562 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4565 #endif /* HAVE_WINDOW_SYSTEM */
4568 /***********************************************************************
4570 ***********************************************************************/
4572 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4574 /* Make menus on frame F appear as specified by the `menu' face. */
4577 x_update_menu_appearance (f
)
4580 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4584 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4588 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4589 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4590 const char *myname
= SDATA (Vx_resource_name
);
4593 const char *popup_path
= "popup_menu";
4595 const char *popup_path
= "menu.popup";
4598 if (STRINGP (LFACE_FOREGROUND (lface
)))
4600 sprintf (line
, "%s.%s*foreground: %s",
4602 SDATA (LFACE_FOREGROUND (lface
)));
4603 XrmPutLineResource (&rdb
, line
);
4604 sprintf (line
, "%s.pane.menubar*foreground: %s",
4605 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4606 XrmPutLineResource (&rdb
, line
);
4610 if (STRINGP (LFACE_BACKGROUND (lface
)))
4612 sprintf (line
, "%s.%s*background: %s",
4614 SDATA (LFACE_BACKGROUND (lface
)));
4615 XrmPutLineResource (&rdb
, line
);
4616 sprintf (line
, "%s.pane.menubar*background: %s",
4617 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4618 XrmPutLineResource (&rdb
, line
);
4623 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4624 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4625 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4626 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4627 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4628 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4631 const char *suffix
= "List";
4633 const char *suffix
= "";
4635 sprintf (line
, "%s.pane.menubar*font%s: %s",
4636 myname
, suffix
, face
->font_name
);
4637 XrmPutLineResource (&rdb
, line
);
4638 sprintf (line
, "%s.%s*font%s: %s",
4639 myname
, popup_path
, suffix
, face
->font_name
);
4640 XrmPutLineResource (&rdb
, line
);
4644 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4645 free_frame_menubar (f
);
4649 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4652 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4653 Sface_attribute_relative_p
,
4655 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4657 Lisp_Object attribute
, value
;
4659 if (EQ (value
, Qunspecified
))
4661 else if (EQ (attribute
, QCheight
))
4662 return INTEGERP (value
) ? Qnil
: Qt
;
4667 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4669 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4670 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4671 the result will be absolute, otherwise it will be relative. */)
4672 (attribute
, value1
, value2
)
4673 Lisp_Object attribute
, value1
, value2
;
4675 if (EQ (value1
, Qunspecified
))
4677 else if (EQ (attribute
, QCheight
))
4678 return merge_face_heights (value1
, value2
, value1
, Qnil
);
4684 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4685 Sinternal_get_lisp_face_attribute
,
4687 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4688 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4689 face attribute name, signal an error.
4690 If the optional argument FRAME is given, report on face FACE in that
4691 frame. If FRAME is t, report on the defaults for face FACE (for new
4692 frames). If FRAME is omitted or nil, use the selected frame. */)
4693 (symbol
, keyword
, frame
)
4694 Lisp_Object symbol
, keyword
, frame
;
4696 Lisp_Object lface
, value
= Qnil
;
4698 CHECK_SYMBOL (symbol
);
4699 CHECK_SYMBOL (keyword
);
4702 lface
= lface_from_face_name (NULL
, symbol
, 1);
4706 frame
= selected_frame
;
4707 CHECK_LIVE_FRAME (frame
);
4708 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4711 if (EQ (keyword
, QCfamily
))
4712 value
= LFACE_FAMILY (lface
);
4713 else if (EQ (keyword
, QCheight
))
4714 value
= LFACE_HEIGHT (lface
);
4715 else if (EQ (keyword
, QCweight
))
4716 value
= LFACE_WEIGHT (lface
);
4717 else if (EQ (keyword
, QCslant
))
4718 value
= LFACE_SLANT (lface
);
4719 else if (EQ (keyword
, QCunderline
))
4720 value
= LFACE_UNDERLINE (lface
);
4721 else if (EQ (keyword
, QCoverline
))
4722 value
= LFACE_OVERLINE (lface
);
4723 else if (EQ (keyword
, QCstrike_through
))
4724 value
= LFACE_STRIKE_THROUGH (lface
);
4725 else if (EQ (keyword
, QCbox
))
4726 value
= LFACE_BOX (lface
);
4727 else if (EQ (keyword
, QCinverse_video
)
4728 || EQ (keyword
, QCreverse_video
))
4729 value
= LFACE_INVERSE (lface
);
4730 else if (EQ (keyword
, QCforeground
))
4731 value
= LFACE_FOREGROUND (lface
);
4732 else if (EQ (keyword
, QCbackground
))
4733 value
= LFACE_BACKGROUND (lface
);
4734 else if (EQ (keyword
, QCstipple
))
4735 value
= LFACE_STIPPLE (lface
);
4736 else if (EQ (keyword
, QCwidth
))
4737 value
= LFACE_SWIDTH (lface
);
4738 else if (EQ (keyword
, QCinherit
))
4739 value
= LFACE_INHERIT (lface
);
4740 else if (EQ (keyword
, QCfont
))
4741 value
= LFACE_FONT (lface
);
4743 signal_error ("Invalid face attribute name", keyword
);
4749 DEFUN ("internal-lisp-face-attribute-values",
4750 Finternal_lisp_face_attribute_values
,
4751 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4752 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4753 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4757 Lisp_Object result
= Qnil
;
4759 CHECK_SYMBOL (attr
);
4761 if (EQ (attr
, QCweight
)
4762 || EQ (attr
, QCslant
)
4763 || EQ (attr
, QCwidth
))
4765 /* Extract permissible symbols from tables. */
4766 struct table_entry
*table
;
4769 if (EQ (attr
, QCweight
))
4770 table
= weight_table
, dim
= DIM (weight_table
);
4771 else if (EQ (attr
, QCslant
))
4772 table
= slant_table
, dim
= DIM (slant_table
);
4774 table
= swidth_table
, dim
= DIM (swidth_table
);
4776 for (i
= 0; i
< dim
; ++i
)
4778 Lisp_Object symbol
= *table
[i
].symbol
;
4779 Lisp_Object tail
= result
;
4782 && !EQ (XCAR (tail
), symbol
))
4786 result
= Fcons (symbol
, result
);
4789 else if (EQ (attr
, QCunderline
))
4790 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4791 else if (EQ (attr
, QCoverline
))
4792 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4793 else if (EQ (attr
, QCstrike_through
))
4794 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4795 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4796 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4802 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4803 Sinternal_merge_in_global_face
, 2, 2, 0,
4804 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4805 Default face attributes override any local face attributes. */)
4807 Lisp_Object face
, frame
;
4810 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4812 CHECK_LIVE_FRAME (frame
);
4813 global_lface
= lface_from_face_name (NULL
, face
, 1);
4814 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4815 if (NILP (local_lface
))
4816 local_lface
= Finternal_make_lisp_face (face
, frame
);
4818 /* Make every specified global attribute override the local one.
4819 BEWARE!! This is only used from `face-set-after-frame-default' where
4820 the local frame is defined from default specs in `face-defface-spec'
4821 and those should be overridden by global settings. Hence the strange
4822 "global before local" priority. */
4823 lvec
= XVECTOR (local_lface
)->contents
;
4824 gvec
= XVECTOR (global_lface
)->contents
;
4825 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4826 if (! UNSPECIFIEDP (gvec
[i
]))
4833 /* The following function is implemented for compatibility with 20.2.
4834 The function is used in x-resolve-fonts when it is asked to
4835 return fonts with the same size as the font of a face. This is
4836 done in fontset.el. */
4838 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4839 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4840 If the optional argument FRAME is given, report on face FACE in that frame.
4841 If FRAME is t, report on the defaults for face FACE (for new frames).
4842 The font default for a face is either nil, or a list
4843 of the form (bold), (italic) or (bold italic).
4844 If FRAME is omitted or nil, use the selected frame. */)
4846 Lisp_Object face
, frame
;
4850 Lisp_Object result
= Qnil
;
4851 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4853 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4854 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4855 result
= Fcons (Qbold
, result
);
4857 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4858 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4859 result
= Fcons (Qitalic
, result
);
4865 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4866 int face_id
= lookup_named_face (f
, face
, 0);
4867 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4868 return face
? build_string (face
->font_name
) : Qnil
;
4873 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
4874 all attributes are `equal'. Tries to be fast because this function
4875 is called quite often. */
4878 lface_equal_p (v1
, v2
)
4879 Lisp_Object
*v1
, *v2
;
4883 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
4885 Lisp_Object a
= v1
[i
];
4886 Lisp_Object b
= v2
[i
];
4888 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
4889 and the other is specified. */
4890 equal_p
= XTYPE (a
) == XTYPE (b
);
4899 equal_p
= ((SBYTES (a
)
4901 && bcmp (SDATA (a
), SDATA (b
),
4911 equal_p
= !NILP (Fequal (a
, b
));
4921 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
4922 Sinternal_lisp_face_equal_p
, 2, 3, 0,
4923 doc
: /* True if FACE1 and FACE2 are equal.
4924 If the optional argument FRAME is given, report on face FACE in that frame.
4925 If FRAME is t, report on the defaults for face FACE (for new frames).
4926 If FRAME is omitted or nil, use the selected frame. */)
4927 (face1
, face2
, frame
)
4928 Lisp_Object face1
, face2
, frame
;
4932 Lisp_Object lface1
, lface2
;
4937 /* Don't use check_x_frame here because this function is called
4938 before X frames exist. At that time, if FRAME is nil,
4939 selected_frame will be used which is the frame dumped with
4940 Emacs. That frame is not an X frame. */
4941 f
= frame_or_selected_frame (frame
, 2);
4943 lface1
= lface_from_face_name (NULL
, face1
, 1);
4944 lface2
= lface_from_face_name (NULL
, face2
, 1);
4945 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
4946 XVECTOR (lface2
)->contents
);
4947 return equal_p
? Qt
: Qnil
;
4951 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
4952 Sinternal_lisp_face_empty_p
, 1, 2, 0,
4953 doc
: /* True if FACE has no attribute specified.
4954 If the optional argument FRAME is given, report on face FACE in that frame.
4955 If FRAME is t, report on the defaults for face FACE (for new frames).
4956 If FRAME is omitted or nil, use the selected frame. */)
4958 Lisp_Object face
, frame
;
4965 frame
= selected_frame
;
4966 CHECK_LIVE_FRAME (frame
);
4970 lface
= lface_from_face_name (NULL
, face
, 1);
4972 lface
= lface_from_face_name (f
, face
, 1);
4974 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4975 if (!UNSPECIFIEDP (AREF (lface
, i
)))
4978 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
4982 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
4984 doc
: /* Return an alist of frame-local faces defined on FRAME.
4985 For internal use only. */)
4989 struct frame
*f
= frame_or_selected_frame (frame
, 0);
4990 return f
->face_alist
;
4994 /* Return a hash code for Lisp string STRING with case ignored. Used
4995 below in computing a hash value for a Lisp face. */
4997 static INLINE
unsigned
4998 hash_string_case_insensitive (string
)
5001 const unsigned char *s
;
5003 xassert (STRINGP (string
));
5004 for (s
= SDATA (string
); *s
; ++s
)
5005 hash
= (hash
<< 1) ^ tolower (*s
);
5010 /* Return a hash code for face attribute vector V. */
5012 static INLINE
unsigned
5016 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5017 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5018 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5019 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5020 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5021 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5022 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5026 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5027 considering charsets/registries). They do if they specify the same
5028 family, point size, weight, width, slant, and fontset. Both LFACE1
5029 and LFACE2 must be fully-specified. */
5032 lface_same_font_attributes_p (lface1
, lface2
)
5033 Lisp_Object
*lface1
, *lface2
;
5035 xassert (lface_fully_specified_p (lface1
)
5036 && lface_fully_specified_p (lface2
));
5037 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5038 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5039 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5040 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5041 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5042 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5043 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5044 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5045 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5046 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5047 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5048 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5053 /***********************************************************************
5055 ***********************************************************************/
5057 /* Allocate and return a new realized face for Lisp face attribute
5060 static struct face
*
5061 make_realized_face (attr
)
5064 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5065 bzero (face
, sizeof *face
);
5066 face
->ascii_face
= face
;
5067 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5072 /* Free realized face FACE, including its X resources. FACE may
5076 free_realized_face (f
, face
)
5082 #ifdef HAVE_WINDOW_SYSTEM
5083 if (FRAME_WINDOW_P (f
))
5085 /* Free fontset of FACE if it is ASCII face. */
5086 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5087 free_face_fontset (f
, face
);
5090 x_free_gc (f
, face
->gc
);
5094 free_face_colors (f
, face
);
5095 x_destroy_bitmap (f
, face
->stipple
);
5097 #endif /* HAVE_WINDOW_SYSTEM */
5104 /* Prepare face FACE for subsequent display on frame F. This
5105 allocated GCs if they haven't been allocated yet or have been freed
5106 by clearing the face cache. */
5109 prepare_face_for_display (f
, face
)
5113 #ifdef HAVE_WINDOW_SYSTEM
5114 xassert (FRAME_WINDOW_P (f
));
5119 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5121 xgcv
.foreground
= face
->foreground
;
5122 xgcv
.background
= face
->background
;
5123 #ifdef HAVE_X_WINDOWS
5124 xgcv
.graphics_exposures
= False
;
5126 /* The font of FACE may be null if we couldn't load it. */
5129 #ifdef HAVE_X_WINDOWS
5130 xgcv
.font
= face
->font
->fid
;
5133 xgcv
.font
= face
->font
;
5136 xgcv
.font
= face
->font
;
5142 #ifdef HAVE_X_WINDOWS
5145 xgcv
.fill_style
= FillOpaqueStippled
;
5146 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5147 mask
|= GCFillStyle
| GCStipple
;
5150 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5153 #endif /* HAVE_WINDOW_SYSTEM */
5157 /* Returns the `distance' between the colors X and Y. */
5160 color_distance (x
, y
)
5163 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5164 Quoting from that paper:
5166 This formula has results that are very close to L*u*v* (with the
5167 modified lightness curve) and, more importantly, it is a more even
5168 algorithm: it does not have a range of colours where it suddenly
5169 gives far from optimal results.
5171 See <http://www.compuphase.com/cmetric.htm> for more info. */
5173 long r
= (x
->red
- y
->red
) >> 8;
5174 long g
= (x
->green
- y
->green
) >> 8;
5175 long b
= (x
->blue
- y
->blue
) >> 8;
5176 long r_mean
= (x
->red
+ y
->red
) >> 9;
5179 (((512 + r_mean
) * r
* r
) >> 8)
5181 + (((767 - r_mean
) * b
* b
) >> 8);
5185 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5186 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5187 COLOR1 and COLOR2 may be either strings containing the color name,
5188 or lists of the form (RED GREEN BLUE).
5189 If FRAME is unspecified or nil, the current frame is used. */)
5190 (color1
, color2
, frame
)
5191 Lisp_Object color1
, color2
, frame
;
5194 XColor cdef1
, cdef2
;
5197 frame
= selected_frame
;
5198 CHECK_LIVE_FRAME (frame
);
5201 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5202 || !STRINGP (color1
)
5203 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5204 signal_error ("Invalid color", color1
);
5205 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5206 || !STRINGP (color2
)
5207 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5208 signal_error ("Invalid color", color2
);
5210 return make_number (color_distance (&cdef1
, &cdef2
));
5214 /***********************************************************************
5215 Face capability testing for ttys
5216 ***********************************************************************/
5219 /* If the distance (as returned by color_distance) between two colors is
5220 less than this, then they are considered the same, for determining
5221 whether a color is supported or not. The range of values is 0-65535. */
5223 #define TTY_SAME_COLOR_THRESHOLD 10000
5226 DEFUN ("tty-supports-face-attributes-p",
5227 Ftty_supports_face_attributes_p
, Stty_supports_face_attributes_p
,
5229 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
5230 The optional argument FRAME is the frame on which to test; if it is nil
5231 or unspecified, then the current frame is used. If FRAME is not a tty
5232 frame, then nil is returned.
5234 The definition of `supported' is somewhat heuristic, but basically means
5235 that a face containing all the attributes in ATTRIBUTES, when merged
5236 with the default face for display, can be represented in a way that's
5238 \(1) different in appearance than the default face, and
5239 \(2) `close in spirit' to what the attributes specify, if not exact.
5241 Point (2) implies that a `:weight black' attribute will be satisified
5242 by any terminal that can display bold, and a `:foreground "yellow"' as
5243 long as the terminal can display a yellowish color, but `:slant italic'
5244 will _not_ be satisified by the tty display code's automatic
5245 substitution of a `dim' face for italic. */)
5247 Lisp_Object attributes
, frame
;
5251 Lisp_Object val
, fg
, bg
;
5252 XColor fg_tty_color
, fg_std_color
;
5253 XColor bg_tty_color
, bg_std_color
;
5254 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5255 unsigned test_caps
= 0;
5258 frame
= selected_frame
;
5259 CHECK_LIVE_FRAME (frame
);
5262 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
5263 attrs
[i
] = Qunspecified
;
5264 merge_face_vector_with_property (f
, attrs
, attributes
);
5266 /* This function only works on ttys. */
5267 if (!FRAME_TERMCAP_P (f
) && !FRAME_MSDOS_P (f
))
5270 /* First check some easy-to-check stuff; ttys support none of the
5271 following attributes, so we can just return nil if any are requested. */
5274 val
= attrs
[LFACE_STIPPLE_INDEX
];
5275 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5279 val
= attrs
[LFACE_HEIGHT_INDEX
];
5280 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5284 val
= attrs
[LFACE_SWIDTH_INDEX
];
5285 if (!UNSPECIFIEDP (val
) && !NILP (val
)
5286 && face_numeric_swidth (val
) != XLFD_SWIDTH_MEDIUM
)
5290 val
= attrs
[LFACE_OVERLINE_INDEX
];
5291 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5294 /* strike-through */
5295 val
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
5296 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5300 val
= attrs
[LFACE_BOX_INDEX
];
5301 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5304 /* slant (italics/oblique); We consider any non-default value
5305 unsupportable on ttys, even though the face code actually `fakes'
5306 them using a dim attribute if possible. This is because the faked
5307 result is too different from what the face specifies. */
5308 val
= attrs
[LFACE_SLANT_INDEX
];
5309 if (!UNSPECIFIEDP (val
) && !NILP (val
)
5310 && face_numeric_slant (val
) != XLFD_SLANT_ROMAN
)
5314 /* Test for terminal `capabilities' (non-color character attributes). */
5316 /* font weight (bold/dim) */
5317 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
5320 if (weight
> XLFD_WEIGHT_MEDIUM
)
5321 test_caps
= TTY_CAP_BOLD
;
5322 else if (weight
< XLFD_WEIGHT_MEDIUM
)
5323 test_caps
= TTY_CAP_DIM
;
5327 val
= attrs
[LFACE_UNDERLINE_INDEX
];
5328 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5331 return Qnil
; /* ttys don't support colored underlines */
5333 test_caps
|= TTY_CAP_UNDERLINE
;
5337 val
= attrs
[LFACE_INVERSE_INDEX
];
5338 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5339 test_caps
|= TTY_CAP_INVERSE
;
5342 /* Color testing. */
5344 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
5345 we use them when calling `tty_capable_p' below, even if the face
5346 specifies no colors. */
5347 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
5348 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
5350 /* Check if foreground color is close enough. */
5351 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
5354 if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
5356 else if (color_distance (&fg_tty_color
, &fg_std_color
)
5357 > TTY_SAME_COLOR_THRESHOLD
)
5361 /* Check if background color is close enough. */
5362 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
5365 if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
5367 else if (color_distance (&bg_tty_color
, &bg_std_color
)
5368 > TTY_SAME_COLOR_THRESHOLD
)
5372 /* If both foreground and background are requested, see if the
5373 distance between them is OK. We just check to see if the distance
5374 between the tty's foreground and background is close enough to the
5375 distance between the standard foreground and background. */
5376 if (STRINGP (fg
) && STRINGP (bg
))
5379 = (color_distance (&fg_std_color
, &bg_std_color
)
5380 - color_distance (&fg_tty_color
, &bg_tty_color
));
5381 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
5382 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
5387 /* See if the capabilities we selected above are supported, with the
5389 if (test_caps
!= 0 &&
5390 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
5394 /* Hmmm, everything checks out, this terminal must support this face. */
5400 /***********************************************************************
5402 ***********************************************************************/
5404 /* Return a new face cache for frame F. */
5406 static struct face_cache
*
5410 struct face_cache
*c
;
5413 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5414 bzero (c
, sizeof *c
);
5415 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5416 c
->buckets
= (struct face
**) xmalloc (size
);
5417 bzero (c
->buckets
, size
);
5419 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5421 c
->menu_face_changed_p
= menu_face_changed_default
;
5426 /* Clear out all graphics contexts for all realized faces, except for
5427 the basic faces. This should be done from time to time just to avoid
5428 keeping too many graphics contexts that are no longer needed. */
5432 struct face_cache
*c
;
5434 if (c
&& FRAME_WINDOW_P (c
->f
))
5436 #ifdef HAVE_WINDOW_SYSTEM
5438 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5440 struct face
*face
= c
->faces_by_id
[i
];
5441 if (face
&& face
->gc
)
5443 x_free_gc (c
->f
, face
->gc
);
5447 #endif /* HAVE_WINDOW_SYSTEM */
5452 /* Free all realized faces in face cache C, including basic faces. C
5453 may be null. If faces are freed, make sure the frame's current
5454 matrix is marked invalid, so that a display caused by an expose
5455 event doesn't try to use faces we destroyed. */
5458 free_realized_faces (c
)
5459 struct face_cache
*c
;
5464 struct frame
*f
= c
->f
;
5466 /* We must block input here because we can't process X events
5467 safely while only some faces are freed, or when the frame's
5468 current matrix still references freed faces. */
5471 for (i
= 0; i
< c
->used
; ++i
)
5473 free_realized_face (f
, c
->faces_by_id
[i
]);
5474 c
->faces_by_id
[i
] = NULL
;
5478 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5479 bzero (c
->buckets
, size
);
5481 /* Must do a thorough redisplay the next time. Mark current
5482 matrices as invalid because they will reference faces freed
5483 above. This function is also called when a frame is
5484 destroyed. In this case, the root window of F is nil. */
5485 if (WINDOWP (f
->root_window
))
5487 clear_current_matrices (f
);
5488 ++windows_or_buffers_changed
;
5496 /* Free all faces realized for multibyte characters on frame F that
5500 free_realized_multibyte_face (f
, fontset
)
5504 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5508 /* We must block input here because we can't process X events safely
5509 while only some faces are freed, or when the frame's current
5510 matrix still references freed faces. */
5513 for (i
= 0; i
< cache
->used
; i
++)
5515 face
= cache
->faces_by_id
[i
];
5517 && face
!= face
->ascii_face
5518 && face
->fontset
== fontset
)
5520 uncache_face (cache
, face
);
5521 free_realized_face (f
, face
);
5525 /* Must do a thorough redisplay the next time. Mark current
5526 matrices as invalid because they will reference faces freed
5527 above. This function is also called when a frame is destroyed.
5528 In this case, the root window of F is nil. */
5529 if (WINDOWP (f
->root_window
))
5531 clear_current_matrices (f
);
5532 ++windows_or_buffers_changed
;
5539 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5540 This is done after attributes of a named face have been changed,
5541 because we can't tell which realized faces depend on that face. */
5544 free_all_realized_faces (frame
)
5550 FOR_EACH_FRAME (rest
, frame
)
5551 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5554 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5558 /* Free face cache C and faces in it, including their X resources. */
5562 struct face_cache
*c
;
5566 free_realized_faces (c
);
5568 xfree (c
->faces_by_id
);
5574 /* Cache realized face FACE in face cache C. HASH is the hash value
5575 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5576 collision list of the face hash table of C. This is done because
5577 otherwise lookup_face would find FACE for every character, even if
5578 faces with the same attributes but for specific characters exist. */
5581 cache_face (c
, face
, hash
)
5582 struct face_cache
*c
;
5586 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5590 if (face
->fontset
>= 0)
5592 struct face
*last
= c
->buckets
[i
];
5603 c
->buckets
[i
] = face
;
5604 face
->prev
= face
->next
= NULL
;
5610 face
->next
= c
->buckets
[i
];
5612 face
->next
->prev
= face
;
5613 c
->buckets
[i
] = face
;
5616 /* Find a free slot in C->faces_by_id and use the index of the free
5617 slot as FACE->id. */
5618 for (i
= 0; i
< c
->used
; ++i
)
5619 if (c
->faces_by_id
[i
] == NULL
)
5623 /* Maybe enlarge C->faces_by_id. */
5626 if (c
->used
== c
->size
)
5629 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5630 if (new_size
== c
->size
)
5631 abort (); /* Alternatives? ++kfs */
5632 sz
= new_size
* sizeof *c
->faces_by_id
;
5633 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5640 /* Check that FACE got a unique id. */
5645 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5646 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5652 #endif /* GLYPH_DEBUG */
5654 c
->faces_by_id
[i
] = face
;
5658 /* Remove face FACE from cache C. */
5661 uncache_face (c
, face
)
5662 struct face_cache
*c
;
5665 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5668 face
->prev
->next
= face
->next
;
5670 c
->buckets
[i
] = face
->next
;
5673 face
->next
->prev
= face
->prev
;
5675 c
->faces_by_id
[face
->id
] = NULL
;
5676 if (face
->id
== c
->used
)
5681 /* Look up a realized face with face attributes ATTR in the face cache
5682 of frame F. The face will be used to display character C. Value
5683 is the ID of the face found. If no suitable face is found, realize
5684 a new one. In that case, if C is a multibyte character, BASE_FACE
5685 is a face that has the same attributes. */
5688 lookup_face (f
, attr
, c
, base_face
)
5692 struct face
*base_face
;
5694 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5699 xassert (cache
!= NULL
);
5700 check_lface_attrs (attr
);
5702 /* Look up ATTR in the face cache. */
5703 hash
= lface_hash (attr
);
5704 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5706 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5707 if (face
->hash
== hash
5708 && (!FRAME_WINDOW_P (f
)
5709 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5710 && lface_equal_p (face
->lface
, attr
))
5713 /* If not found, realize a new face. */
5715 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5718 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5720 /* When this function is called from face_for_char (in this case, C is
5721 a multibyte character), a fontset of a face returned by
5722 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5723 C) is not sutisfied. The fontset is set for this face by
5724 face_for_char later. */
5726 if (FRAME_WINDOW_P (f
))
5727 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5729 #endif /* GLYPH_DEBUG */
5735 /* Return the face id of the realized face for named face SYMBOL on
5736 frame F suitable for displaying character C. Value is -1 if the
5737 face couldn't be determined, which might happen if the default face
5738 isn't realized and cannot be realized. */
5741 lookup_named_face (f
, symbol
, c
)
5746 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5747 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5748 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5750 if (default_face
== NULL
)
5752 if (!realize_basic_faces (f
))
5754 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5757 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5758 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5759 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
5760 return lookup_face (f
, attrs
, c
, NULL
);
5764 /* Return the ID of the realized ASCII face of Lisp face with ID
5765 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5768 ascii_face_of_lisp_face (f
, lface_id
)
5774 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5776 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5777 face_id
= lookup_named_face (f
, face_name
, 0);
5786 /* Return a face for charset ASCII that is like the face with id
5787 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5788 STEPS < 0 means larger. Value is the id of the face. */
5791 smaller_face (f
, face_id
, steps
)
5795 #ifdef HAVE_WINDOW_SYSTEM
5797 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5798 int pt
, last_pt
, last_height
;
5801 struct face
*new_face
;
5803 /* If not called for an X frame, just return the original face. */
5804 if (FRAME_TERMCAP_P (f
))
5807 /* Try in increments of 1/2 pt. */
5808 delta
= steps
< 0 ? 5 : -5;
5809 steps
= abs (steps
);
5811 face
= FACE_FROM_ID (f
, face_id
);
5812 bcopy (face
->lface
, attrs
, sizeof attrs
);
5813 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5814 new_face_id
= face_id
;
5815 last_height
= FONT_HEIGHT (face
->font
);
5819 /* Give up if we cannot find a font within 10pt. */
5820 && abs (last_pt
- pt
) < 100)
5822 /* Look up a face for a slightly smaller/larger font. */
5824 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5825 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5826 new_face
= FACE_FROM_ID (f
, new_face_id
);
5828 /* If height changes, count that as one step. */
5829 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5830 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5833 last_height
= FONT_HEIGHT (new_face
->font
);
5840 #else /* not HAVE_WINDOW_SYSTEM */
5844 #endif /* not HAVE_WINDOW_SYSTEM */
5848 /* Return a face for charset ASCII that is like the face with id
5849 FACE_ID on frame F, but has height HEIGHT. */
5852 face_with_height (f
, face_id
, height
)
5857 #ifdef HAVE_WINDOW_SYSTEM
5859 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5861 if (FRAME_TERMCAP_P (f
)
5865 face
= FACE_FROM_ID (f
, face_id
);
5866 bcopy (face
->lface
, attrs
, sizeof attrs
);
5867 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5868 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5869 #endif /* HAVE_WINDOW_SYSTEM */
5875 /* Return the face id of the realized face for named face SYMBOL on
5876 frame F suitable for displaying character C, and use attributes of
5877 the face FACE_ID for attributes that aren't completely specified by
5878 SYMBOL. This is like lookup_named_face, except that the default
5879 attributes come from FACE_ID, not from the default face. FACE_ID
5880 is assumed to be already realized. */
5883 lookup_derived_face (f
, symbol
, c
, face_id
)
5889 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5890 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5891 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5896 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5897 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5898 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
5899 return lookup_face (f
, attrs
, c
, default_face
);
5902 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5903 Sface_attributes_as_vector
, 1, 1, 0,
5904 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5909 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5911 merge_face_vector_with_property (XFRAME (selected_frame
),
5912 XVECTOR (lface
)->contents
,
5919 /***********************************************************************
5921 ***********************************************************************/
5923 DEFUN ("internal-set-font-selection-order",
5924 Finternal_set_font_selection_order
,
5925 Sinternal_set_font_selection_order
, 1, 1, 0,
5926 doc
: /* Set font selection order for face font selection to ORDER.
5927 ORDER must be a list of length 4 containing the symbols `:width',
5928 `:height', `:weight', and `:slant'. Face attributes appearing
5929 first in ORDER are matched first, e.g. if `:height' appears before
5930 `:weight' in ORDER, font selection first tries to find a font with
5931 a suitable height, and then tries to match the font weight.
5938 int indices
[DIM (font_sort_order
)];
5941 bzero (indices
, sizeof indices
);
5945 CONSP (list
) && i
< DIM (indices
);
5946 list
= XCDR (list
), ++i
)
5948 Lisp_Object attr
= XCAR (list
);
5951 if (EQ (attr
, QCwidth
))
5953 else if (EQ (attr
, QCheight
))
5954 xlfd
= XLFD_POINT_SIZE
;
5955 else if (EQ (attr
, QCweight
))
5957 else if (EQ (attr
, QCslant
))
5962 if (indices
[i
] != 0)
5967 if (!NILP (list
) || i
!= DIM (indices
))
5968 signal_error ("Invalid font sort order", order
);
5969 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
5970 if (indices
[i
] == 0)
5971 signal_error ("Invalid font sort order", order
);
5973 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
5975 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
5976 free_all_realized_faces (Qnil
);
5983 DEFUN ("internal-set-alternative-font-family-alist",
5984 Finternal_set_alternative_font_family_alist
,
5985 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
5986 doc
: /* Define alternative font families to try in face font selection.
5987 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
5988 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
5989 be found. Value is ALIST. */)
5994 Vface_alternative_font_family_alist
= alist
;
5995 free_all_realized_faces (Qnil
);
6000 DEFUN ("internal-set-alternative-font-registry-alist",
6001 Finternal_set_alternative_font_registry_alist
,
6002 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6003 doc
: /* Define alternative font registries to try in face font selection.
6004 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6005 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6006 be found. Value is ALIST. */)
6011 Vface_alternative_font_registry_alist
= alist
;
6012 free_all_realized_faces (Qnil
);
6017 #ifdef HAVE_WINDOW_SYSTEM
6019 /* Value is non-zero if FONT is the name of a scalable font. The
6020 X11R6 XLFD spec says that point size, pixel size, and average width
6021 are zero for scalable fonts. Intlfonts contain at least one
6022 scalable font ("*-muleindian-1") for which this isn't true, so we
6023 just test average width. */
6026 font_scalable_p (font
)
6027 struct font_name
*font
;
6029 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6030 return (*s
== '0' && *(s
+ 1) == '\0')
6032 /* Windows implementation of XLFD is slightly broken for backward
6033 compatibility with previous broken versions, so test for
6034 wildcards as well as 0. */
6041 /* Ignore the difference of font point size less than this value. */
6043 #define FONT_POINT_SIZE_QUANTUM 5
6045 /* Value is non-zero if FONT1 is a better match for font attributes
6046 VALUES than FONT2. VALUES is an array of face attribute values in
6047 font sort order. COMPARE_PT_P zero means don't compare point
6048 sizes. AVGWIDTH, if not zero, is a specified font average width
6052 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6054 struct font_name
*font1
, *font2
;
6055 int compare_pt_p
, avgwidth
;
6059 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6061 int xlfd_idx
= font_sort_order
[i
];
6063 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6067 if (xlfd_idx
== XLFD_POINT_SIZE
)
6069 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6070 / font1
->rescale_ratio
));
6071 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6072 / font2
->rescale_ratio
));
6073 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6078 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6079 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6082 if (delta1
> delta2
)
6084 else if (delta1
< delta2
)
6088 /* The difference may be equal because, e.g., the face
6089 specifies `italic' but we have only `regular' and
6090 `oblique'. Prefer `oblique' in this case. */
6091 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6092 && font1
->numeric
[xlfd_idx
] > values
[i
]
6093 && font2
->numeric
[xlfd_idx
] < values
[i
])
6101 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6102 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6103 if (delta1
> delta2
)
6105 else if (delta1
< delta2
)
6111 /* We prefer a real scalable font; i.e. not what autoscaled. */
6112 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6113 && font1
->numeric
[XLFD_RESY
] > 0);
6114 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6115 && font2
->numeric
[XLFD_RESY
] > 0);
6117 if (auto_scaled_1
!= auto_scaled_2
)
6118 return auto_scaled_2
;
6121 return font1
->registry_priority
< font2
->registry_priority
;
6125 /* Value is non-zero if FONT is an exact match for face attributes in
6126 SPECIFIED. SPECIFIED is an array of face attribute values in font
6127 sort order. AVGWIDTH, if non-zero, is an average width to compare
6131 exact_face_match_p (specified
, font
, avgwidth
)
6133 struct font_name
*font
;
6138 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6139 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6142 return (i
== DIM (font_sort_order
)
6144 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6148 /* Value is the name of a scaled font, generated from scalable font
6149 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6150 Value is allocated from heap. */
6153 build_scalable_font_name (f
, font
, specified_pt
)
6155 struct font_name
*font
;
6158 char pixel_size
[20];
6160 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6163 /* If scalable font is for a specific resolution, compute
6164 the point size we must specify from the resolution of
6165 the display and the specified resolution of the font. */
6166 if (font
->numeric
[XLFD_RESY
] != 0)
6168 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6169 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
;
6174 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
;
6176 /* We may need a font of the different size. */
6177 pixel_value
*= font
->rescale_ratio
;
6179 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6180 font of the specified PIXEL_SIZE. */
6182 { /* Set point size of the font. */
6183 char point_size
[20];
6184 sprintf (point_size
, "%d", (int) pt
);
6185 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6186 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6190 /* Set pixel size. */
6191 sprintf (pixel_size
, "%d", pixel_value
);
6192 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6193 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6195 /* If font doesn't specify its resolution, use the
6196 resolution of the display. */
6197 if (font
->numeric
[XLFD_RESY
] == 0)
6200 sprintf (buffer
, "%d", (int) resy
);
6201 font
->fields
[XLFD_RESY
] = buffer
;
6202 font
->numeric
[XLFD_RESY
] = resy
;
6205 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6208 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6209 sprintf (buffer
, "%d", resx
);
6210 font
->fields
[XLFD_RESX
] = buffer
;
6211 font
->numeric
[XLFD_RESX
] = resx
;
6214 return build_font_name (font
);
6218 /* Value is non-zero if we are allowed to use scalable font FONT. We
6219 can't run a Lisp function here since this function may be called
6220 with input blocked. */
6223 may_use_scalable_font_p (font
)
6226 if (EQ (Vscalable_fonts_allowed
, Qt
))
6228 else if (CONSP (Vscalable_fonts_allowed
))
6230 Lisp_Object tail
, regexp
;
6232 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6234 regexp
= XCAR (tail
);
6235 if (STRINGP (regexp
)
6236 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6246 /* Return the name of the best matching font for face attributes ATTRS
6247 in the array of font_name structures FONTS which contains NFONTS
6248 elements. WIDTH_RATIO is a factor with which to multiply average
6249 widths if ATTRS specifies such a width.
6251 Value is a font name which is allocated from the heap. FONTS is
6252 freed by this function.
6254 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6255 indicate whether the resulting font should be drawn using overstrike
6256 to simulate bold-face. */
6259 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6262 struct font_name
*fonts
;
6265 int *needs_overstrike
;
6268 struct font_name
*best
;
6271 int exact_p
, avgwidth
;
6276 /* Make specified font attributes available in `specified',
6277 indexed by sort order. */
6278 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6280 int xlfd_idx
= font_sort_order
[i
];
6282 if (xlfd_idx
== XLFD_SWIDTH
)
6283 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6284 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6285 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6286 else if (xlfd_idx
== XLFD_WEIGHT
)
6287 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6288 else if (xlfd_idx
== XLFD_SLANT
)
6289 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6294 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6296 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6300 if (needs_overstrike
)
6301 *needs_overstrike
= 0;
6303 /* Start with the first non-scalable font in the list. */
6304 for (i
= 0; i
< nfonts
; ++i
)
6305 if (!font_scalable_p (fonts
+ i
))
6308 /* Find the best match among the non-scalable fonts. */
6313 for (i
= 1; i
< nfonts
; ++i
)
6314 if (!font_scalable_p (fonts
+ i
)
6315 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6319 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6327 /* Unless we found an exact match among non-scalable fonts, see if
6328 we can find a better match among scalable fonts. */
6331 /* A scalable font is better if
6333 1. its weight, slant, swidth attributes are better, or.
6335 2. the best non-scalable font doesn't have the required
6336 point size, and the scalable fonts weight, slant, swidth
6339 int non_scalable_has_exact_height_p
;
6341 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6342 non_scalable_has_exact_height_p
= 1;
6344 non_scalable_has_exact_height_p
= 0;
6346 for (i
= 0; i
< nfonts
; ++i
)
6347 if (font_scalable_p (fonts
+ i
))
6350 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6351 || (!non_scalable_has_exact_height_p
6352 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6354 non_scalable_has_exact_height_p
= 1;
6359 if (needs_overstrike
)
6361 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6362 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6364 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6366 /* We want a bold font, but didn't get one; try to use
6367 overstriking instead to simulate bold-face. However,
6368 don't overstrike an already-bold fontn unless the
6369 desired weight grossly exceeds the available weight. */
6370 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6371 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6373 *needs_overstrike
= 1;
6378 if (font_scalable_p (best
))
6379 font_name
= build_scalable_font_name (f
, best
, pt
);
6381 font_name
= build_font_name (best
);
6383 /* Free font_name structures. */
6384 free_font_names (fonts
, nfonts
);
6390 /* Get a list of matching fonts on frame F, considering FAMILY
6391 and alternative font families from Vface_alternative_font_registry_alist.
6393 FAMILY is the font family whose alternatives are considered.
6395 REGISTRY, if a string, specifies a font registry and encoding to
6396 match. A value of nil means include fonts of any registry and
6399 Return in *FONTS a pointer to a vector of font_name structures for
6400 the fonts matched. Value is the number of fonts found. */
6403 try_alternative_families (f
, family
, registry
, fonts
)
6405 Lisp_Object family
, registry
;
6406 struct font_name
**fonts
;
6411 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6414 /* Try alternative font families. */
6415 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6418 for (alter
= XCDR (alter
);
6419 CONSP (alter
) && nfonts
== 0;
6420 alter
= XCDR (alter
))
6422 if (STRINGP (XCAR (alter
)))
6423 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6427 /* Try all scalable fonts before giving up. */
6428 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6430 int count
= SPECPDL_INDEX ();
6431 specbind (Qscalable_fonts_allowed
, Qt
);
6432 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6433 unbind_to (count
, Qnil
);
6440 /* Get a list of matching fonts on frame F.
6442 FAMILY, if a string, specifies a font family derived from the fontset.
6443 It is only used if the face does not specify any family in ATTRS or
6444 if we cannot find any font of the face's family.
6446 REGISTRY, if a string, specifies a font registry and encoding to
6447 match. A value of nil means include fonts of any registry and
6450 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6451 Otherwise, prefer FAMILY.
6453 Return in *FONTS a pointer to a vector of font_name structures for
6454 the fonts matched. Value is the number of fonts found. */
6457 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6460 Lisp_Object family
, registry
;
6461 struct font_name
**fonts
;
6462 int prefer_face_family
;
6465 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6466 Lisp_Object try_family
;
6468 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6470 if (STRINGP (try_family
))
6471 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6474 /* When realizing the default face and a font spec does not matched
6475 exactly, Emacs looks for ones with the same registry as the
6476 default font. On the Mac, this is mac-roman, which does not work
6477 if the family is -etl-fixed, e.g. The following widens the
6478 choices and fixes that problem. */
6479 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
)
6480 && xstricmp (SDATA (registry
), "mac-roman") == 0)
6481 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6484 if (EQ (try_family
, family
))
6485 family
= face_family
;
6487 if (nfonts
== 0 && STRINGP (family
))
6488 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6490 /* Try font family of the default face or "fixed". */
6493 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6495 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6497 family
= build_string ("fixed");
6498 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6501 /* Try any family with the given registry. */
6503 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6509 /* Return the fontset id of the base fontset name or alias name given
6510 by the fontset attribute of ATTRS. Value is -1 if the fontset
6511 attribute of ATTRS doesn't name a fontset. */
6514 face_fontset (attrs
)
6519 name
= attrs
[LFACE_FONT_INDEX
];
6520 if (!STRINGP (name
))
6522 return fs_query_fontset (name
, 0);
6526 /* Choose a name of font to use on frame F to display character C with
6527 Lisp face attributes specified by ATTRS. The font name is
6528 determined by the font-related attributes in ATTRS and the name
6529 pattern for C in FONTSET. Value is the font name which is
6530 allocated from the heap and must be freed by the caller, or NULL if
6531 we can get no information about the font name of C. It is assured
6532 that we always get some information for a single byte
6535 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6536 indicate whether the resulting font should be drawn using overstrike
6537 to simulate bold-face. */
6540 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6544 int *needs_overstrike
;
6546 Lisp_Object pattern
;
6547 char *font_name
= NULL
;
6548 struct font_name
*fonts
;
6549 int nfonts
, width_ratio
;
6551 if (needs_overstrike
)
6552 *needs_overstrike
= 0;
6554 /* Get (foundry and) family name and registry (and encoding) name of
6556 pattern
= fontset_font_pattern (f
, fontset
, c
);
6559 xassert (!SINGLE_BYTE_CHAR_P (c
));
6563 /* If what we got is a name pattern, return it. */
6564 if (STRINGP (pattern
))
6565 return xstrdup (SDATA (pattern
));
6567 /* Get a list of fonts matching that pattern and choose the
6568 best match for the specified face attributes from it. */
6569 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6570 (SINGLE_BYTE_CHAR_P (c
)
6571 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6572 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6574 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6575 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6580 #endif /* HAVE_WINDOW_SYSTEM */
6584 /***********************************************************************
6586 ***********************************************************************/
6588 /* Realize basic faces on frame F. Value is zero if frame parameters
6589 of F don't contain enough information needed to realize the default
6593 realize_basic_faces (f
)
6597 int count
= SPECPDL_INDEX ();
6599 /* Block input here so that we won't be surprised by an X expose
6600 event, for instance, without having the faces set up. */
6602 specbind (Qscalable_fonts_allowed
, Qt
);
6604 if (realize_default_face (f
))
6606 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6607 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6608 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6609 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6610 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6611 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6612 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6613 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6614 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6615 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6617 /* Reflect changes in the `menu' face in menu bars. */
6618 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6620 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6621 #ifdef USE_X_TOOLKIT
6622 if (FRAME_WINDOW_P (f
))
6623 x_update_menu_appearance (f
);
6630 unbind_to (count
, Qnil
);
6636 /* Realize the default face on frame F. If the face is not fully
6637 specified, make it fully-specified. Attributes of the default face
6638 that are not explicitly specified are taken from frame parameters. */
6641 realize_default_face (f
)
6644 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6646 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6647 Lisp_Object frame_font
;
6650 /* If the `default' face is not yet known, create it. */
6651 lface
= lface_from_face_name (f
, Qdefault
, 0);
6655 XSETFRAME (frame
, f
);
6656 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6660 #ifdef HAVE_WINDOW_SYSTEM
6661 if (FRAME_WINDOW_P (f
))
6663 /* Set frame_font to the value of the `font' frame parameter. */
6664 frame_font
= Fassq (Qfont
, f
->param_alist
);
6665 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
6666 frame_font
= XCDR (frame_font
);
6667 set_lface_from_font_name (f
, lface
, frame_font
,
6668 f
->default_face_done_p
, 1);
6669 f
->default_face_done_p
= 1;
6671 #endif /* HAVE_WINDOW_SYSTEM */
6673 if (!FRAME_WINDOW_P (f
))
6675 LFACE_FAMILY (lface
) = build_string ("default");
6676 LFACE_SWIDTH (lface
) = Qnormal
;
6677 LFACE_HEIGHT (lface
) = make_number (1);
6678 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
6679 LFACE_WEIGHT (lface
) = Qnormal
;
6680 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
6681 LFACE_SLANT (lface
) = Qnormal
;
6682 LFACE_AVGWIDTH (lface
) = Qunspecified
;
6685 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
6686 LFACE_UNDERLINE (lface
) = Qnil
;
6688 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
6689 LFACE_OVERLINE (lface
) = Qnil
;
6691 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
6692 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
6694 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
6695 LFACE_BOX (lface
) = Qnil
;
6697 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
6698 LFACE_INVERSE (lface
) = Qnil
;
6700 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
6702 /* This function is called so early that colors are not yet
6703 set in the frame parameter list. */
6704 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
6706 if (CONSP (color
) && STRINGP (XCDR (color
)))
6707 LFACE_FOREGROUND (lface
) = XCDR (color
);
6708 else if (FRAME_WINDOW_P (f
))
6710 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6711 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
6716 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
6718 /* This function is called so early that colors are not yet
6719 set in the frame parameter list. */
6720 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
6721 if (CONSP (color
) && STRINGP (XCDR (color
)))
6722 LFACE_BACKGROUND (lface
) = XCDR (color
);
6723 else if (FRAME_WINDOW_P (f
))
6725 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6726 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
6731 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
6732 LFACE_STIPPLE (lface
) = Qnil
;
6734 /* Realize the face; it must be fully-specified now. */
6735 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
6736 check_lface (lface
);
6737 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
6738 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
6743 /* Realize basic faces other than the default face in face cache C.
6744 SYMBOL is the face name, ID is the face id the realized face must
6745 have. The default face must have been realized already. */
6748 realize_named_face (f
, symbol
, id
)
6753 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6754 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
6755 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6756 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6757 struct face
*new_face
;
6759 /* The default face must exist and be fully specified. */
6760 get_lface_attributes (f
, Qdefault
, attrs
, 1);
6761 check_lface_attrs (attrs
);
6762 xassert (lface_fully_specified_p (attrs
));
6764 /* If SYMBOL isn't know as a face, create it. */
6768 XSETFRAME (frame
, f
);
6769 lface
= Finternal_make_lisp_face (symbol
, frame
);
6772 /* Merge SYMBOL's face with the default face. */
6773 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
6774 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
6776 /* Realize the face. */
6777 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
6781 /* Realize the fully-specified face with attributes ATTRS in face
6782 cache CACHE for character C. If C is a multibyte character,
6783 BASE_FACE is a face that has the same attributes. Otherwise,
6784 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
6785 ID of face to remove before caching the new face. Value is a
6786 pointer to the newly created realized face. */
6788 static struct face
*
6789 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
6790 struct face_cache
*cache
;
6793 struct face
*base_face
;
6798 /* LFACE must be fully specified. */
6799 xassert (cache
!= NULL
);
6800 check_lface_attrs (attrs
);
6802 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
6804 /* Remove the former face. */
6805 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
6806 uncache_face (cache
, former_face
);
6807 free_realized_face (cache
->f
, former_face
);
6810 if (FRAME_WINDOW_P (cache
->f
))
6811 face
= realize_x_face (cache
, attrs
, c
, base_face
);
6812 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
6813 face
= realize_tty_face (cache
, attrs
, c
);
6814 else if (FRAME_INITIAL_P (cache
->f
))
6816 /* Create a dummy face. */
6817 face
= make_realized_face (attrs
);
6822 /* Insert the new face. */
6823 cache_face (cache
, face
, lface_hash (attrs
));
6824 #ifdef HAVE_WINDOW_SYSTEM
6825 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
6826 load_face_font (cache
->f
, face
, c
);
6827 #endif /* HAVE_WINDOW_SYSTEM */
6832 /* Realize the fully-specified face with attributes ATTRS in face
6833 cache CACHE for character C. Do it for X frame CACHE->f. If C is
6834 a multibyte character, BASE_FACE is a face that has the same
6835 attributes. Otherwise, BASE_FACE is ignored. If the new face
6836 doesn't share font with the default face, a fontname is allocated
6837 from the heap and set in `font_name' of the new face, but it is not
6838 yet loaded here. Value is a pointer to the newly created realized
6841 static struct face
*
6842 realize_x_face (cache
, attrs
, c
, base_face
)
6843 struct face_cache
*cache
;
6846 struct face
*base_face
;
6848 #ifdef HAVE_WINDOW_SYSTEM
6849 struct face
*face
, *default_face
;
6851 Lisp_Object stipple
, overline
, strike_through
, box
;
6853 xassert (FRAME_WINDOW_P (cache
->f
));
6854 xassert (SINGLE_BYTE_CHAR_P (c
)
6857 /* Allocate a new realized face. */
6858 face
= make_realized_face (attrs
);
6862 /* If C is a multibyte character, we share all face attirbutes with
6863 BASE_FACE including the realized fontset. But, we must load a
6865 if (!SINGLE_BYTE_CHAR_P (c
))
6867 bcopy (base_face
, face
, sizeof *face
);
6870 /* Don't try to free the colors copied bitwise from BASE_FACE. */
6871 face
->colors_copied_bitwise_p
= 1;
6873 /* to force realize_face to load font */
6878 /* Now we are realizing a face for ASCII (and unibyte) characters. */
6880 /* Determine the font to use. Most of the time, the font will be
6881 the same as the font of the default face, so try that first. */
6882 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6884 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
6885 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
6887 face
->font
= default_face
->font
;
6888 face
->fontset
= default_face
->fontset
;
6889 face
->font_info_id
= default_face
->font_info_id
;
6890 face
->font_name
= default_face
->font_name
;
6891 face
->ascii_face
= face
;
6893 /* But, as we can't share the fontset, make a new realized
6894 fontset that has the same base fontset as of the default
6897 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
6901 /* If the face attribute ATTRS specifies a fontset, use it as
6902 the base of a new realized fontset. Otherwise, use the same
6903 base fontset as of the default face. The base determines
6904 registry and encoding of a font. It may also determine
6905 foundry and family. The other fields of font name pattern
6906 are constructed from ATTRS. */
6907 int fontset
= face_fontset (attrs
);
6909 if ((fontset
== -1) && default_face
)
6910 fontset
= default_face
->fontset
;
6911 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
6912 face
->font
= NULL
; /* to force realize_face to load font */
6915 /* Load colors, and set remaining attributes. */
6917 load_face_colors (f
, face
, attrs
);
6920 box
= attrs
[LFACE_BOX_INDEX
];
6923 /* A simple box of line width 1 drawn in color given by
6925 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
6927 face
->box
= FACE_SIMPLE_BOX
;
6928 face
->box_line_width
= 1;
6930 else if (INTEGERP (box
))
6932 /* Simple box of specified line width in foreground color of the
6934 xassert (XINT (box
) != 0);
6935 face
->box
= FACE_SIMPLE_BOX
;
6936 face
->box_line_width
= XINT (box
);
6937 face
->box_color
= face
->foreground
;
6938 face
->box_color_defaulted_p
= 1;
6940 else if (CONSP (box
))
6942 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
6943 being one of `raised' or `sunken'. */
6944 face
->box
= FACE_SIMPLE_BOX
;
6945 face
->box_color
= face
->foreground
;
6946 face
->box_color_defaulted_p
= 1;
6947 face
->box_line_width
= 1;
6951 Lisp_Object keyword
, value
;
6953 keyword
= XCAR (box
);
6961 if (EQ (keyword
, QCline_width
))
6963 if (INTEGERP (value
) && XINT (value
) != 0)
6964 face
->box_line_width
= XINT (value
);
6966 else if (EQ (keyword
, QCcolor
))
6968 if (STRINGP (value
))
6970 face
->box_color
= load_color (f
, face
, value
,
6972 face
->use_box_color_for_shadows_p
= 1;
6975 else if (EQ (keyword
, QCstyle
))
6977 if (EQ (value
, Qreleased_button
))
6978 face
->box
= FACE_RAISED_BOX
;
6979 else if (EQ (value
, Qpressed_button
))
6980 face
->box
= FACE_SUNKEN_BOX
;
6985 /* Text underline, overline, strike-through. */
6987 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
6989 /* Use default color (same as foreground color). */
6990 face
->underline_p
= 1;
6991 face
->underline_defaulted_p
= 1;
6992 face
->underline_color
= 0;
6994 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
6996 /* Use specified color. */
6997 face
->underline_p
= 1;
6998 face
->underline_defaulted_p
= 0;
6999 face
->underline_color
7000 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7001 LFACE_UNDERLINE_INDEX
);
7003 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7005 face
->underline_p
= 0;
7006 face
->underline_defaulted_p
= 0;
7007 face
->underline_color
= 0;
7010 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7011 if (STRINGP (overline
))
7013 face
->overline_color
7014 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7015 LFACE_OVERLINE_INDEX
);
7016 face
->overline_p
= 1;
7018 else if (EQ (overline
, Qt
))
7020 face
->overline_color
= face
->foreground
;
7021 face
->overline_color_defaulted_p
= 1;
7022 face
->overline_p
= 1;
7025 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7026 if (STRINGP (strike_through
))
7028 face
->strike_through_color
7029 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7030 LFACE_STRIKE_THROUGH_INDEX
);
7031 face
->strike_through_p
= 1;
7033 else if (EQ (strike_through
, Qt
))
7035 face
->strike_through_color
= face
->foreground
;
7036 face
->strike_through_color_defaulted_p
= 1;
7037 face
->strike_through_p
= 1;
7040 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7041 if (!NILP (stipple
))
7042 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7044 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7046 #endif /* HAVE_WINDOW_SYSTEM */
7050 /* Map a specified color of face FACE on frame F to a tty color index.
7051 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7052 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7053 default foreground/background colors. */
7056 map_tty_color (f
, face
, idx
, defaulted
)
7059 enum lface_attribute_index idx
;
7062 Lisp_Object frame
, color
, def
;
7063 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7064 unsigned long default_pixel
, default_other_pixel
, pixel
;
7066 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7070 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7071 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7075 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7076 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7079 XSETFRAME (frame
, f
);
7080 color
= face
->lface
[idx
];
7084 && CONSP (Vtty_defined_color_alist
)
7085 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7088 /* Associations in tty-defined-color-alist are of the form
7089 (NAME INDEX R G B). We need the INDEX part. */
7090 pixel
= XINT (XCAR (XCDR (def
)));
7093 if (pixel
== default_pixel
&& STRINGP (color
))
7095 pixel
= load_color (f
, face
, color
, idx
);
7097 #if defined (MSDOS) || defined (WINDOWSNT)
7098 /* If the foreground of the default face is the default color,
7099 use the foreground color defined by the frame. */
7101 if (FRAME_MSDOS_P (f
))
7104 if (pixel
== default_pixel
7105 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7108 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7110 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7111 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7114 else if (pixel
== default_other_pixel
)
7117 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7119 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7120 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7126 #endif /* MSDOS or WINDOWSNT */
7130 face
->foreground
= pixel
;
7132 face
->background
= pixel
;
7136 /* Realize the fully-specified face with attributes ATTRS in face
7137 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7138 pointer to the newly created realized face. */
7140 static struct face
*
7141 realize_tty_face (cache
, attrs
, c
)
7142 struct face_cache
*cache
;
7148 int face_colors_defaulted
= 0;
7149 struct frame
*f
= cache
->f
;
7151 /* Frame must be a termcap frame. */
7152 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7154 /* Allocate a new realized face. */
7155 face
= make_realized_face (attrs
);
7156 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7158 /* Map face attributes to TTY appearances. We map slant to
7159 dimmed text because we want italic text to appear differently
7160 and because dimmed text is probably used infrequently. */
7161 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7162 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7164 if (weight
> XLFD_WEIGHT_MEDIUM
)
7165 face
->tty_bold_p
= 1;
7166 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7167 face
->tty_dim_p
= 1;
7168 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7169 face
->tty_underline_p
= 1;
7170 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7171 face
->tty_reverse_p
= 1;
7173 /* Map color names to color indices. */
7174 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7175 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7177 /* Swap colors if face is inverse-video. If the colors are taken
7178 from the frame colors, they are already inverted, since the
7179 frame-creation function calls x-handle-reverse-video. */
7180 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7182 unsigned long tem
= face
->foreground
;
7183 face
->foreground
= face
->background
;
7184 face
->background
= tem
;
7187 if (tty_suppress_bold_inverse_default_colors_p
7189 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7190 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7191 face
->tty_bold_p
= 0;
7197 DEFUN ("tty-suppress-bold-inverse-default-colors",
7198 Ftty_suppress_bold_inverse_default_colors
,
7199 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7200 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7201 SUPPRESS non-nil means suppress it.
7202 This affects bold faces on TTYs whose foreground is the default background
7203 color of the display and whose background is the default foreground color.
7204 For such faces, the bold face attribute is ignored if this variable
7207 Lisp_Object suppress
;
7209 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7210 ++face_change_count
;
7216 /***********************************************************************
7218 ***********************************************************************/
7220 /* Return the ID of the face to use to display character CH with face
7221 property PROP on frame F in current_buffer. */
7224 compute_char_face (f
, ch
, prop
)
7231 if (NILP (current_buffer
->enable_multibyte_characters
))
7236 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7237 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7241 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7242 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7243 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7244 merge_face_vector_with_property (f
, attrs
, prop
);
7245 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7251 /* Return the face ID associated with buffer position POS for
7252 displaying ASCII characters. Return in *ENDPTR the position at
7253 which a different face is needed, as far as text properties and
7254 overlays are concerned. W is a window displaying current_buffer.
7256 REGION_BEG, REGION_END delimit the region, so it can be
7259 LIMIT is a position not to scan beyond. That is to limit the time
7260 this function can take.
7262 If MOUSE is non-zero, use the character's mouse-face, not its face.
7264 The face returned is suitable for displaying ASCII characters. */
7267 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7268 endptr
, limit
, mouse
)
7271 int region_beg
, region_end
;
7276 struct frame
*f
= XFRAME (w
->frame
);
7277 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7278 Lisp_Object prop
, position
;
7280 Lisp_Object
*overlay_vec
;
7283 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7284 Lisp_Object limit1
, end
;
7285 struct face
*default_face
;
7287 /* W must display the current buffer. We could write this function
7288 to use the frame and buffer of W, but right now it doesn't. */
7289 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7291 XSETFRAME (frame
, f
);
7292 XSETFASTINT (position
, pos
);
7295 if (pos
< region_beg
&& region_beg
< endpos
)
7296 endpos
= region_beg
;
7298 /* Get the `face' or `mouse_face' text property at POS, and
7299 determine the next position at which the property changes. */
7300 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7301 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7302 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7304 endpos
= XINT (end
);
7306 /* Look at properties from overlays. */
7311 /* First try with room for 40 overlays. */
7313 overlay_vec
= (Lisp_Object
*) alloca (len
* sizeof (Lisp_Object
));
7314 noverlays
= overlays_at (pos
, 0, &overlay_vec
, &len
,
7315 &next_overlay
, NULL
, 0);
7317 /* If there are more than 40, make enough space for all, and try
7319 if (noverlays
> len
)
7322 overlay_vec
= (Lisp_Object
*) alloca (len
* sizeof (Lisp_Object
));
7323 noverlays
= overlays_at (pos
, 0, &overlay_vec
, &len
,
7324 &next_overlay
, NULL
, 0);
7327 if (next_overlay
< endpos
)
7328 endpos
= next_overlay
;
7333 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7335 /* Optimize common cases where we can use the default face. */
7338 && !(pos
>= region_beg
&& pos
< region_end
))
7339 return DEFAULT_FACE_ID
;
7341 /* Begin with attributes from the default face. */
7342 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7344 /* Merge in attributes specified via text properties. */
7346 merge_face_vector_with_property (f
, attrs
, prop
);
7348 /* Now merge the overlay data. */
7349 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7350 for (i
= 0; i
< noverlays
; i
++)
7355 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7357 merge_face_vector_with_property (f
, attrs
, prop
);
7359 oend
= OVERLAY_END (overlay_vec
[i
]);
7360 oendpos
= OVERLAY_POSITION (oend
);
7361 if (oendpos
< endpos
)
7365 /* If in the region, merge in the region face. */
7366 if (pos
>= region_beg
&& pos
< region_end
)
7368 Lisp_Object region_face
= lface_from_face_name (f
, Qregion
, 0);
7369 merge_face_vectors (f
, XVECTOR (region_face
)->contents
, attrs
, Qnil
);
7371 if (region_end
< endpos
)
7372 endpos
= region_end
;
7377 /* Look up a realized face with the given face attributes,
7378 or realize a new one for ASCII characters. */
7379 return lookup_face (f
, attrs
, 0, NULL
);
7383 /* Compute the face at character position POS in Lisp string STRING on
7384 window W, for ASCII characters.
7386 If STRING is an overlay string, it comes from position BUFPOS in
7387 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7388 not an overlay string. W must display the current buffer.
7389 REGION_BEG and REGION_END give the start and end positions of the
7390 region; both are -1 if no region is visible.
7392 BASE_FACE_ID is the id of a face to merge with. For strings coming
7393 from overlays or the `display' property it is the face at BUFPOS.
7395 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7397 Set *ENDPTR to the next position where to check for faces in
7398 STRING; -1 if the face is constant from POS to the end of the
7401 Value is the id of the face to use. The face returned is suitable
7402 for displaying ASCII characters. */
7405 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7406 region_end
, endptr
, base_face_id
, mouse_p
)
7410 int region_beg
, region_end
;
7412 enum face_id base_face_id
;
7415 Lisp_Object prop
, position
, end
, limit
;
7416 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7417 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7418 struct face
*base_face
;
7419 int multibyte_p
= STRING_MULTIBYTE (string
);
7420 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7422 /* Get the value of the face property at the current position within
7423 STRING. Value is nil if there is no face property. */
7424 XSETFASTINT (position
, pos
);
7425 prop
= Fget_text_property (position
, prop_name
, string
);
7427 /* Get the next position at which to check for faces. Value of end
7428 is nil if face is constant all the way to the end of the string.
7429 Otherwise it is a string position where to check faces next.
7430 Limit is the maximum position up to which to check for property
7431 changes in Fnext_single_property_change. Strings are usually
7432 short, so set the limit to the end of the string. */
7433 XSETFASTINT (limit
, SCHARS (string
));
7434 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7436 *endptr
= XFASTINT (end
);
7440 base_face
= FACE_FROM_ID (f
, base_face_id
);
7441 xassert (base_face
);
7443 /* Optimize the default case that there is no face property and we
7444 are not in the region. */
7446 && (base_face_id
!= DEFAULT_FACE_ID
7447 /* BUFPOS <= 0 means STRING is not an overlay string, so
7448 that the region doesn't have to be taken into account. */
7450 || bufpos
< region_beg
7451 || bufpos
>= region_end
)
7453 /* We can't realize faces for different charsets differently
7454 if we don't have fonts, so we can stop here if not working
7455 on a window-system frame. */
7456 || !FRAME_WINDOW_P (f
)
7457 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7458 return base_face
->id
;
7460 /* Begin with attributes from the base face. */
7461 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7463 /* Merge in attributes specified via text properties. */
7465 merge_face_vector_with_property (f
, attrs
, prop
);
7467 /* If in the region, merge in the region face. */
7469 && bufpos
>= region_beg
7470 && bufpos
< region_end
)
7472 Lisp_Object region_face
= lface_from_face_name (f
, Qregion
, 0);
7473 merge_face_vectors (f
, XVECTOR (region_face
)->contents
, attrs
, Qnil
);
7476 /* Look up a realized face with the given face attributes,
7477 or realize a new one for ASCII characters. */
7478 return lookup_face (f
, attrs
, 0, NULL
);
7483 /***********************************************************************
7485 ***********************************************************************/
7489 /* Print the contents of the realized face FACE to stderr. */
7492 dump_realized_face (face
)
7495 fprintf (stderr
, "ID: %d\n", face
->id
);
7496 #ifdef HAVE_X_WINDOWS
7497 fprintf (stderr
, "gc: %d\n", (int) face
->gc
);
7499 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7501 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7502 fprintf (stderr
, "background: 0x%lx (%s)\n",
7504 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7505 fprintf (stderr
, "font_name: %s (%s)\n",
7507 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7508 #ifdef HAVE_X_WINDOWS
7509 fprintf (stderr
, "font = %p\n", face
->font
);
7511 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7512 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7513 fprintf (stderr
, "underline: %d (%s)\n",
7515 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7516 fprintf (stderr
, "hash: %d\n", face
->hash
);
7517 fprintf (stderr
, "charset: %d\n", face
->charset
);
7521 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7529 fprintf (stderr
, "font selection order: ");
7530 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7531 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7532 fprintf (stderr
, "\n");
7534 fprintf (stderr
, "alternative fonts: ");
7535 debug_print (Vface_alternative_font_family_alist
);
7536 fprintf (stderr
, "\n");
7538 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7539 Fdump_face (make_number (i
));
7545 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7547 error ("Not a valid face");
7548 dump_realized_face (face
);
7555 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7556 0, 0, 0, doc
: /* */)
7559 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7560 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7561 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7565 #endif /* GLYPH_DEBUG != 0 */
7569 /***********************************************************************
7571 ***********************************************************************/
7576 Qface
= intern ("face");
7578 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7579 staticpro (&Qbitmap_spec_p
);
7580 Qframe_update_face_colors
= intern ("frame-update-face-colors");
7581 staticpro (&Qframe_update_face_colors
);
7583 /* Lisp face attribute keywords. */
7584 QCfamily
= intern (":family");
7585 staticpro (&QCfamily
);
7586 QCheight
= intern (":height");
7587 staticpro (&QCheight
);
7588 QCweight
= intern (":weight");
7589 staticpro (&QCweight
);
7590 QCslant
= intern (":slant");
7591 staticpro (&QCslant
);
7592 QCunderline
= intern (":underline");
7593 staticpro (&QCunderline
);
7594 QCinverse_video
= intern (":inverse-video");
7595 staticpro (&QCinverse_video
);
7596 QCreverse_video
= intern (":reverse-video");
7597 staticpro (&QCreverse_video
);
7598 QCforeground
= intern (":foreground");
7599 staticpro (&QCforeground
);
7600 QCbackground
= intern (":background");
7601 staticpro (&QCbackground
);
7602 QCstipple
= intern (":stipple");;
7603 staticpro (&QCstipple
);
7604 QCwidth
= intern (":width");
7605 staticpro (&QCwidth
);
7606 QCfont
= intern (":font");
7607 staticpro (&QCfont
);
7608 QCbold
= intern (":bold");
7609 staticpro (&QCbold
);
7610 QCitalic
= intern (":italic");
7611 staticpro (&QCitalic
);
7612 QCoverline
= intern (":overline");
7613 staticpro (&QCoverline
);
7614 QCstrike_through
= intern (":strike-through");
7615 staticpro (&QCstrike_through
);
7616 QCbox
= intern (":box");
7618 QCinherit
= intern (":inherit");
7619 staticpro (&QCinherit
);
7621 /* Symbols used for Lisp face attribute values. */
7622 QCcolor
= intern (":color");
7623 staticpro (&QCcolor
);
7624 QCline_width
= intern (":line-width");
7625 staticpro (&QCline_width
);
7626 QCstyle
= intern (":style");
7627 staticpro (&QCstyle
);
7628 Qreleased_button
= intern ("released-button");
7629 staticpro (&Qreleased_button
);
7630 Qpressed_button
= intern ("pressed-button");
7631 staticpro (&Qpressed_button
);
7632 Qnormal
= intern ("normal");
7633 staticpro (&Qnormal
);
7634 Qultra_light
= intern ("ultra-light");
7635 staticpro (&Qultra_light
);
7636 Qextra_light
= intern ("extra-light");
7637 staticpro (&Qextra_light
);
7638 Qlight
= intern ("light");
7639 staticpro (&Qlight
);
7640 Qsemi_light
= intern ("semi-light");
7641 staticpro (&Qsemi_light
);
7642 Qsemi_bold
= intern ("semi-bold");
7643 staticpro (&Qsemi_bold
);
7644 Qbold
= intern ("bold");
7646 Qextra_bold
= intern ("extra-bold");
7647 staticpro (&Qextra_bold
);
7648 Qultra_bold
= intern ("ultra-bold");
7649 staticpro (&Qultra_bold
);
7650 Qoblique
= intern ("oblique");
7651 staticpro (&Qoblique
);
7652 Qitalic
= intern ("italic");
7653 staticpro (&Qitalic
);
7654 Qreverse_oblique
= intern ("reverse-oblique");
7655 staticpro (&Qreverse_oblique
);
7656 Qreverse_italic
= intern ("reverse-italic");
7657 staticpro (&Qreverse_italic
);
7658 Qultra_condensed
= intern ("ultra-condensed");
7659 staticpro (&Qultra_condensed
);
7660 Qextra_condensed
= intern ("extra-condensed");
7661 staticpro (&Qextra_condensed
);
7662 Qcondensed
= intern ("condensed");
7663 staticpro (&Qcondensed
);
7664 Qsemi_condensed
= intern ("semi-condensed");
7665 staticpro (&Qsemi_condensed
);
7666 Qsemi_expanded
= intern ("semi-expanded");
7667 staticpro (&Qsemi_expanded
);
7668 Qexpanded
= intern ("expanded");
7669 staticpro (&Qexpanded
);
7670 Qextra_expanded
= intern ("extra-expanded");
7671 staticpro (&Qextra_expanded
);
7672 Qultra_expanded
= intern ("ultra-expanded");
7673 staticpro (&Qultra_expanded
);
7674 Qbackground_color
= intern ("background-color");
7675 staticpro (&Qbackground_color
);
7676 Qforeground_color
= intern ("foreground-color");
7677 staticpro (&Qforeground_color
);
7678 Qunspecified
= intern ("unspecified");
7679 staticpro (&Qunspecified
);
7681 Qface_alias
= intern ("face-alias");
7682 staticpro (&Qface_alias
);
7683 Qdefault
= intern ("default");
7684 staticpro (&Qdefault
);
7685 Qtool_bar
= intern ("tool-bar");
7686 staticpro (&Qtool_bar
);
7687 Qregion
= intern ("region");
7688 staticpro (&Qregion
);
7689 Qfringe
= intern ("fringe");
7690 staticpro (&Qfringe
);
7691 Qheader_line
= intern ("header-line");
7692 staticpro (&Qheader_line
);
7693 Qscroll_bar
= intern ("scroll-bar");
7694 staticpro (&Qscroll_bar
);
7695 Qmenu
= intern ("menu");
7697 Qcursor
= intern ("cursor");
7698 staticpro (&Qcursor
);
7699 Qborder
= intern ("border");
7700 staticpro (&Qborder
);
7701 Qmouse
= intern ("mouse");
7702 staticpro (&Qmouse
);
7703 Qmode_line_inactive
= intern ("mode-line-inactive");
7704 staticpro (&Qmode_line_inactive
);
7705 Qtty_color_desc
= intern ("tty-color-desc");
7706 staticpro (&Qtty_color_desc
);
7707 Qtty_color_standard_values
= intern ("tty-color-standard-values");
7708 staticpro (&Qtty_color_standard_values
);
7709 Qtty_color_by_index
= intern ("tty-color-by-index");
7710 staticpro (&Qtty_color_by_index
);
7711 Qtty_color_alist
= intern ("tty-color-alist");
7712 staticpro (&Qtty_color_alist
);
7713 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
7714 staticpro (&Qscalable_fonts_allowed
);
7716 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
7717 staticpro (&Vparam_value_alist
);
7718 Vface_alternative_font_family_alist
= Qnil
;
7719 staticpro (&Vface_alternative_font_family_alist
);
7720 Vface_alternative_font_registry_alist
= Qnil
;
7721 staticpro (&Vface_alternative_font_registry_alist
);
7723 defsubr (&Sinternal_make_lisp_face
);
7724 defsubr (&Sinternal_lisp_face_p
);
7725 defsubr (&Sinternal_set_lisp_face_attribute
);
7726 #ifdef HAVE_WINDOW_SYSTEM
7727 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
7729 defsubr (&Scolor_gray_p
);
7730 defsubr (&Scolor_supported_p
);
7731 defsubr (&Sface_attribute_relative_p
);
7732 defsubr (&Smerge_face_attribute
);
7733 defsubr (&Sinternal_get_lisp_face_attribute
);
7734 defsubr (&Sinternal_lisp_face_attribute_values
);
7735 defsubr (&Sinternal_lisp_face_equal_p
);
7736 defsubr (&Sinternal_lisp_face_empty_p
);
7737 defsubr (&Sinternal_copy_lisp_face
);
7738 defsubr (&Sinternal_merge_in_global_face
);
7739 defsubr (&Sface_font
);
7740 defsubr (&Sframe_face_alist
);
7741 defsubr (&Stty_supports_face_attributes_p
);
7742 defsubr (&Scolor_distance
);
7743 defsubr (&Sinternal_set_font_selection_order
);
7744 defsubr (&Sinternal_set_alternative_font_family_alist
);
7745 defsubr (&Sinternal_set_alternative_font_registry_alist
);
7746 defsubr (&Sface_attributes_as_vector
);
7748 defsubr (&Sdump_face
);
7749 defsubr (&Sshow_face_resources
);
7750 #endif /* GLYPH_DEBUG */
7751 defsubr (&Sclear_face_cache
);
7752 defsubr (&Stty_suppress_bold_inverse_default_colors
);
7754 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
7755 defsubr (&Sdump_colors
);
7758 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
7759 doc
: /* *Limit for font matching.
7760 If an integer > 0, font matching functions won't load more than
7761 that number of fonts when searching for a matching font. */);
7762 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
7764 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
7765 doc
: /* List of global face definitions (for internal use only.) */);
7766 Vface_new_frame_defaults
= Qnil
;
7768 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
7769 doc
: /* *Default stipple pattern used on monochrome displays.
7770 This stipple pattern is used on monochrome displays
7771 instead of shades of gray for a face background color.
7772 See `set-face-stipple' for possible values for this variable. */);
7773 Vface_default_stipple
= build_string ("gray3");
7775 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
7776 doc
: /* An alist of defined terminal colors and their RGB values. */);
7777 Vtty_defined_color_alist
= Qnil
;
7779 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
7780 doc
: /* Allowed scalable fonts.
7781 A value of nil means don't allow any scalable fonts.
7782 A value of t means allow any scalable font.
7783 Otherwise, value must be a list of regular expressions. A font may be
7784 scaled if its name matches a regular expression in the list.
7785 Note that if value is nil, a scalable font might still be used, if no
7786 other font of the appropriate family and registry is available. */);
7787 Vscalable_fonts_allowed
= Qnil
;
7789 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
7790 doc
: /* List of ignored fonts.
7791 Each element is a regular expression that matches names of fonts to
7793 Vface_ignored_fonts
= Qnil
;
7795 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
7796 doc
: /* Alist of fonts vs the rescaling factors.
7797 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
7798 FONT-NAME-PATTERN is a regular expression matching a font name, and
7799 RESCALE-RATIO is a floating point number to specify how much larger
7800 \(or smaller) font we should use. For instance, if a face requests
7801 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
7802 Vface_font_rescale_alist
= Qnil
;
7804 #ifdef HAVE_WINDOW_SYSTEM
7805 defsubr (&Sbitmap_spec_p
);
7806 defsubr (&Sx_list_fonts
);
7807 defsubr (&Sinternal_face_x_get_resource
);
7808 defsubr (&Sx_family_fonts
);
7809 defsubr (&Sx_font_family_list
);
7810 #endif /* HAVE_WINDOW_SYSTEM */
7813 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
7814 (do not change this comment) */