1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003
3 Free Software Foundation.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font or fontset pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
75 Faces are frame-local by nature because Emacs allows to define the
76 same named face (face names are symbols) differently for different
77 frames. Each frame has an alist of face definitions for all named
78 faces. The value of a named face in such an alist is a Lisp vector
79 with the symbol `face' in slot 0, and a slot for each of the face
80 attributes mentioned above.
82 There is also a global face alist `Vface_new_frame_defaults'. Face
83 definitions from this list are used to initialize faces of newly
86 A face doesn't have to specify all attributes. Those not specified
87 have a value of `unspecified'. Faces specifying all attributes but
88 the 14th are called `fully-specified'.
93 The display style of a given character in the text is determined by
94 combining several faces. This process is called `face merging'.
95 Any aspect of the display style that isn't specified by overlays or
96 text properties is taken from the `default' face. Since it is made
97 sure that the default face is always fully-specified, face merging
98 always results in a fully-specified face.
103 After all face attributes for a character have been determined by
104 merging faces of that character, that face is `realized'. The
105 realization process maps face attributes to what is physically
106 available on the system where Emacs runs. The result is a
107 `realized face' in form of a struct face which is stored in the
108 face cache of the frame on which it was realized.
110 Face realization is done in the context of the character to display
111 because different fonts may be used for different characters. In
112 other words, for characters that have different font
113 specifications, different realized faces are needed to display
116 Font specification is done by fontsets. See the comment in
117 fontset.c for the details. In the current implementation, all ASCII
118 characters share the same font in a fontset.
120 Faces are at first realized for ASCII characters, and, at that
121 time, assigned a specific realized fontset. Hereafter, we call
122 such a face as `ASCII face'. When a face for a multibyte character
123 is realized, it inherits (thus shares) a fontset of an ASCII face
124 that has the same attributes other than font-related ones.
126 Thus, all realized face have a realized fontset.
131 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
132 font as ASCII characters. That is because it is expected that
133 unibyte text users specify a font that is suitable both for ASCII
134 and raw 8-bit characters.
139 Font selection tries to find the best available matching font for a
140 given (character, face) combination.
142 If the face specifies a fontset name, that fontset determines a
143 pattern for fonts of the given character. If the face specifies a
144 font name or the other font-related attributes, a fontset is
145 realized from the default fontset. In that case, that
146 specification determines a pattern for ASCII characters and the
147 default fontset determines a pattern for multibyte characters.
149 Available fonts on the system on which Emacs runs are then matched
150 against the font pattern. The result of font selection is the best
151 match for the given face attributes in this font list.
153 Font selection can be influenced by the user.
155 1. The user can specify the relative importance he gives the face
156 attributes width, height, weight, and slant by setting
157 face-font-selection-order (faces.el) to a list of face attribute
158 names. The default is '(:width :height :weight :slant), and means
159 that font selection first tries to find a good match for the font
160 width specified by a face, then---within fonts with that
161 width---tries to find a best match for the specified font height,
164 2. Setting face-font-family-alternatives allows the user to
165 specify alternative font families to try if a family specified by a
168 3. Setting face-font-registry-alternatives allows the user to
169 specify all alternative font registries to try for a face
170 specifying a registry.
172 4. Setting face-ignored-fonts allows the user to ignore specific
176 Character composition.
178 Usually, the realization process is already finished when Emacs
179 actually reflects the desired glyph matrix on the screen. However,
180 on displaying a composition (sequence of characters to be composed
181 on the screen), a suitable font for the components of the
182 composition is selected and realized while drawing them on the
183 screen, i.e. the realization process is delayed but in principle
187 Initialization of basic faces.
189 The faces `default', `modeline' are considered `basic faces'.
190 When redisplay happens the first time for a newly created frame,
191 basic faces are realized for CHARSET_ASCII. Frame parameters are
192 used to fill in unspecified attributes of the default face. */
195 #include <sys/types.h>
196 #include <sys/stat.h>
200 #include "keyboard.h"
203 #ifdef HAVE_WINDOW_SYSTEM
205 #endif /* HAVE_WINDOW_SYSTEM */
207 #ifdef HAVE_X_WINDOWS
211 #include <Xm/XmStrDefs.h>
212 #endif /* USE_MOTIF */
213 #endif /* HAVE_X_WINDOWS */
222 /* Redefine X specifics to W32 equivalents to avoid cluttering the
223 code with #ifdef blocks. */
224 #undef FRAME_X_DISPLAY_INFO
225 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
226 #define x_display_info w32_display_info
227 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
228 #define check_x check_w32
229 #define x_list_fonts w32_list_fonts
230 #define GCGraphicsExposures 0
231 #endif /* WINDOWSNT */
235 #define x_display_info mac_display_info
236 #define check_x check_mac
240 #include "dispextern.h"
241 #include "blockinput.h"
243 #include "intervals.h"
245 #ifdef HAVE_X_WINDOWS
247 /* Compensate for a bug in Xos.h on some systems, on which it requires
248 time.h. On some such systems, Xos.h tries to redefine struct
249 timeval and struct timezone if USG is #defined while it is
252 #ifdef XOS_NEEDS_TIME_H
258 #else /* not XOS_NEEDS_TIME_H */
260 #endif /* not XOS_NEEDS_TIME_H */
262 #endif /* HAVE_X_WINDOWS */
267 #define abs(X) ((X) < 0 ? -(X) : (X))
269 /* Number of pt per inch (from the TeXbook). */
271 #define PT_PER_INCH 72.27
273 /* Non-zero if face attribute ATTR is unspecified. */
275 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
277 /* Value is the number of elements of VECTOR. */
279 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
281 /* Make a copy of string S on the stack using alloca. Value is a pointer
284 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
286 /* Make a copy of the contents of Lisp string S on the stack using
287 alloca. Value is a pointer to the copy. */
289 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
291 /* Size of hash table of realized faces in face caches (should be a
294 #define FACE_CACHE_BUCKETS_SIZE 1001
296 /* Keyword symbols used for face attribute names. */
298 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
299 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
300 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
301 Lisp_Object QCreverse_video
;
302 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
304 /* Symbols used for attribute values. */
306 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
307 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
308 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
309 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
310 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
311 Lisp_Object Qultra_expanded
;
312 Lisp_Object Qreleased_button
, Qpressed_button
;
313 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
314 Lisp_Object Qunspecified
;
316 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
318 /* The name of the function to call when the background of the frame
319 has changed, frame_update_face_colors. */
321 Lisp_Object Qframe_update_face_colors
;
323 /* Names of basic faces. */
325 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
326 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
327 Lisp_Object Qmode_line_inactive
;
328 extern Lisp_Object Qmode_line
;
330 /* The symbol `face-alias'. A symbols having that property is an
331 alias for another face. Value of the property is the name of
334 Lisp_Object Qface_alias
;
336 /* Default stipple pattern used on monochrome displays. This stipple
337 pattern is used on monochrome displays instead of shades of gray
338 for a face background color. See `set-face-stipple' for possible
339 values for this variable. */
341 Lisp_Object Vface_default_stipple
;
343 /* Alist of alternative font families. Each element is of the form
344 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
345 try FAMILY1, then FAMILY2, ... */
347 Lisp_Object Vface_alternative_font_family_alist
;
349 /* Alist of alternative font registries. Each element is of the form
350 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
351 loaded, try REGISTRY1, then REGISTRY2, ... */
353 Lisp_Object Vface_alternative_font_registry_alist
;
355 /* Allowed scalable fonts. A value of nil means don't allow any
356 scalable fonts. A value of t means allow the use of any scalable
357 font. Otherwise, value must be a list of regular expressions. A
358 font may be scaled if its name matches a regular expression in the
361 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
363 /* List of regular expressions that matches names of fonts to ignore. */
365 Lisp_Object Vface_ignored_fonts
;
367 /* Alist of font name patterns vs the rescaling factor. */
369 Lisp_Object Vface_font_rescale_alist
;
371 /* Maximum number of fonts to consider in font_list. If not an
372 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
374 Lisp_Object Vfont_list_limit
;
375 #define DEFAULT_FONT_LIST_LIMIT 100
377 /* The symbols `foreground-color' and `background-color' which can be
378 used as part of a `face' property. This is for compatibility with
381 Lisp_Object Qforeground_color
, Qbackground_color
;
383 /* The symbols `face' and `mouse-face' used as text properties. */
386 extern Lisp_Object Qmouse_face
;
388 /* Error symbol for wrong_type_argument in load_pixmap. */
390 Lisp_Object Qbitmap_spec_p
;
392 /* Alist of global face definitions. Each element is of the form
393 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
394 is a Lisp vector of face attributes. These faces are used
395 to initialize faces for new frames. */
397 Lisp_Object Vface_new_frame_defaults
;
399 /* The next ID to assign to Lisp faces. */
401 static int next_lface_id
;
403 /* A vector mapping Lisp face Id's to face names. */
405 static Lisp_Object
*lface_id_to_name
;
406 static int lface_id_to_name_size
;
408 /* TTY color-related functions (defined in tty-colors.el). */
410 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
412 /* The name of the function used to compute colors on TTYs. */
414 Lisp_Object Qtty_color_alist
;
416 /* An alist of defined terminal colors and their RGB values. */
418 Lisp_Object Vtty_defined_color_alist
;
420 /* Counter for calls to clear_face_cache. If this counter reaches
421 CLEAR_FONT_TABLE_COUNT, and a frame has more than
422 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
424 static int clear_font_table_count
;
425 #define CLEAR_FONT_TABLE_COUNT 100
426 #define CLEAR_FONT_TABLE_NFONTS 10
428 /* Non-zero means face attributes have been changed since the last
429 redisplay. Used in redisplay_internal. */
431 int face_change_count
;
433 /* Non-zero means don't display bold text if a face's foreground
434 and background colors are the inverse of the default colors of the
435 display. This is a kluge to suppress `bold black' foreground text
436 which is hard to read on an LCD monitor. */
438 int tty_suppress_bold_inverse_default_colors_p
;
440 /* A list of the form `((x . y))' used to avoid consing in
441 Finternal_set_lisp_face_attribute. */
443 static Lisp_Object Vparam_value_alist
;
445 /* The total number of colors currently allocated. */
448 static int ncolors_allocated
;
449 static int npixmaps_allocated
;
453 /* Non-zero means the definition of the `menu' face for new frames has
456 int menu_face_changed_default
;
459 /* Function prototypes. */
464 static void map_tty_color
P_ ((struct frame
*, struct face
*,
465 enum lface_attribute_index
, int *));
466 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
));
467 static int may_use_scalable_font_p
P_ ((const char *));
468 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
469 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
471 static int x_face_list_fonts
P_ ((struct frame
*, char *,
472 struct font_name
**, int, int));
473 static int font_scalable_p
P_ ((struct font_name
*));
474 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
475 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
476 static unsigned char *xstrlwr
P_ ((unsigned char *));
477 static void signal_error
P_ ((char *, Lisp_Object
));
478 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
479 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
480 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
481 static void free_face_colors
P_ ((struct frame
*, struct face
*));
482 static int face_color_gray_p
P_ ((struct frame
*, char *));
483 static char *build_font_name
P_ ((struct font_name
*));
484 static void free_font_names
P_ ((struct font_name
*, int));
485 static int sorted_font_list
P_ ((struct frame
*, char *,
486 int (*cmpfn
) P_ ((const void *, const void *)),
487 struct font_name
**));
488 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
489 Lisp_Object
, struct font_name
**));
490 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
491 Lisp_Object
, struct font_name
**));
492 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
493 Lisp_Object
, Lisp_Object
, struct font_name
**,
495 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
496 Lisp_Object
, struct font_name
**));
497 static int cmp_font_names
P_ ((const void *, const void *));
498 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
499 struct face
*, int));
500 static struct face
*realize_x_face
P_ ((struct face_cache
*,
501 Lisp_Object
*, int, struct face
*));
502 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
503 Lisp_Object
*, int));
504 static int realize_basic_faces
P_ ((struct frame
*));
505 static int realize_default_face
P_ ((struct frame
*));
506 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
507 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
508 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
509 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
510 static unsigned lface_hash
P_ ((Lisp_Object
*));
511 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
512 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
513 static void free_realized_face
P_ ((struct frame
*, struct face
*));
514 static void clear_face_gcs
P_ ((struct face_cache
*));
515 static void free_face_cache
P_ ((struct face_cache
*));
516 static int face_numeric_weight
P_ ((Lisp_Object
));
517 static int face_numeric_slant
P_ ((Lisp_Object
));
518 static int face_numeric_swidth
P_ ((Lisp_Object
));
519 static int face_fontset
P_ ((Lisp_Object
*));
520 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
521 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*, Lisp_Object
));
522 static void merge_face_inheritance
P_ ((struct frame
*f
, Lisp_Object
,
523 Lisp_Object
*, Lisp_Object
));
524 static void merge_face_vector_with_property
P_ ((struct frame
*, Lisp_Object
*,
526 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
527 Lisp_Object
, int, int));
528 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
529 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
530 static void free_realized_faces
P_ ((struct face_cache
*));
531 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
532 struct font_name
*, int, int, int *));
533 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
534 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
535 static int xlfd_numeric_slant
P_ ((struct font_name
*));
536 static int xlfd_numeric_weight
P_ ((struct font_name
*));
537 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
538 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
539 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
540 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
541 static int xlfd_fixed_p
P_ ((struct font_name
*));
542 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
544 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
545 struct font_name
*, int,
547 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
548 struct font_name
*, int));
550 #ifdef HAVE_WINDOW_SYSTEM
552 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
553 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
554 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
555 int (*cmpfn
) P_ ((const void *, const void *))));
556 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
557 static void x_free_gc
P_ ((struct frame
*, GC
));
558 static void clear_font_table
P_ ((struct x_display_info
*));
561 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
562 #endif /* WINDOWSNT */
565 static void x_update_menu_appearance
P_ ((struct frame
*));
567 extern void free_frame_menubar
P_ ((struct frame
*));
568 #endif /* USE_X_TOOLKIT */
570 #endif /* HAVE_WINDOW_SYSTEM */
573 /***********************************************************************
575 ***********************************************************************/
577 #ifdef HAVE_X_WINDOWS
579 #ifdef DEBUG_X_COLORS
581 /* The following is a poor mans infrastructure for debugging X color
582 allocation problems on displays with PseudoColor-8. Some X servers
583 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
584 color reference counts completely so that they don't signal an
585 error when a color is freed whose reference count is already 0.
586 Other X servers do. To help me debug this, the following code
587 implements a simple reference counting schema of its own, for a
588 single display/screen. --gerd. */
590 /* Reference counts for pixel colors. */
592 int color_count
[256];
594 /* Register color PIXEL as allocated. */
597 register_color (pixel
)
600 xassert (pixel
< 256);
601 ++color_count
[pixel
];
605 /* Register color PIXEL as deallocated. */
608 unregister_color (pixel
)
611 xassert (pixel
< 256);
612 if (color_count
[pixel
] > 0)
613 --color_count
[pixel
];
619 /* Register N colors from PIXELS as deallocated. */
622 unregister_colors (pixels
, n
)
623 unsigned long *pixels
;
627 for (i
= 0; i
< n
; ++i
)
628 unregister_color (pixels
[i
]);
632 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
633 doc
: /* Dump currently allocated colors to stderr. */)
638 fputc ('\n', stderr
);
640 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
643 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
646 fputc ('\n', stderr
);
648 fputc ('\t', stderr
);
652 fputc ('\n', stderr
);
656 #endif /* DEBUG_X_COLORS */
659 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
660 color values. Interrupt input must be blocked when this function
664 x_free_colors (f
, pixels
, npixels
)
666 unsigned long *pixels
;
669 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
671 /* If display has an immutable color map, freeing colors is not
672 necessary and some servers don't allow it. So don't do it. */
673 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
675 #ifdef DEBUG_X_COLORS
676 unregister_colors (pixels
, npixels
);
678 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
684 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
685 color values. Interrupt input must be blocked when this function
689 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
693 unsigned long *pixels
;
696 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
697 int class = dpyinfo
->visual
->class;
699 /* If display has an immutable color map, freeing colors is not
700 necessary and some servers don't allow it. So don't do it. */
701 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
703 #ifdef DEBUG_X_COLORS
704 unregister_colors (pixels
, npixels
);
706 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
711 /* Create and return a GC for use on frame F. GC values and mask
712 are given by XGCV and MASK. */
715 x_create_gc (f
, mask
, xgcv
)
722 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
729 /* Free GC which was used on frame F. */
737 xassert (--ngcs
>= 0);
738 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
742 #endif /* HAVE_X_WINDOWS */
745 /* W32 emulation of GCs */
748 x_create_gc (f
, mask
, xgcv
)
755 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
762 /* Free GC which was used on frame F. */
770 xassert (--ngcs
>= 0);
775 #endif /* WINDOWSNT */
778 /* Mac OS emulation of GCs */
780 extern XGCValues
*XCreateGC (void *, Window
, unsigned long, XGCValues
*);
783 x_create_gc (f
, mask
, xgcv
)
789 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
798 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
803 /* Like stricmp. Used to compare parts of font names which are in
808 const unsigned char *s1
, *s2
;
812 unsigned char c1
= tolower (*s1
);
813 unsigned char c2
= tolower (*s2
);
815 return c1
< c2
? -1 : 1;
820 return *s2
== 0 ? 0 : -1;
825 /* Like strlwr, which might not always be available. */
827 static unsigned char *
831 unsigned char *p
= s
;
840 /* Signal `error' with message S, and additional argument ARG. */
843 signal_error (s
, arg
)
847 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
851 /* If FRAME is nil, return a pointer to the selected frame.
852 Otherwise, check that FRAME is a live frame, and return a pointer
853 to it. NPARAM is the parameter number of FRAME, for
854 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
855 Lisp function definitions. */
857 static INLINE
struct frame
*
858 frame_or_selected_frame (frame
, nparam
)
863 frame
= selected_frame
;
865 CHECK_LIVE_FRAME (frame
);
866 return XFRAME (frame
);
870 /***********************************************************************
872 ***********************************************************************/
874 /* Initialize face cache and basic faces for frame F. */
880 /* Make a face cache, if F doesn't have one. */
881 if (FRAME_FACE_CACHE (f
) == NULL
)
882 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
884 #ifdef HAVE_WINDOW_SYSTEM
885 /* Make the image cache. */
886 if (FRAME_WINDOW_P (f
))
888 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
889 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
890 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
892 #endif /* HAVE_WINDOW_SYSTEM */
894 /* Realize basic faces. Must have enough information in frame
895 parameters to realize basic faces at this point. */
896 #ifdef HAVE_X_WINDOWS
897 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
900 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
903 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
905 if (!realize_basic_faces (f
))
910 /* Free face cache of frame F. Called from Fdelete_frame. */
916 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
920 free_face_cache (face_cache
);
921 FRAME_FACE_CACHE (f
) = NULL
;
924 #ifdef HAVE_WINDOW_SYSTEM
925 if (FRAME_WINDOW_P (f
))
927 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
930 --image_cache
->refcount
;
931 if (image_cache
->refcount
== 0)
932 free_image_cache (f
);
935 #endif /* HAVE_WINDOW_SYSTEM */
939 /* Clear face caches, and recompute basic faces for frame F. Call
940 this after changing frame parameters on which those faces depend,
941 or when realized faces have been freed due to changing attributes
945 recompute_basic_faces (f
)
948 if (FRAME_FACE_CACHE (f
))
950 clear_face_cache (0);
951 if (!realize_basic_faces (f
))
957 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
958 try to free unused fonts, too. */
961 clear_face_cache (clear_fonts_p
)
964 #ifdef HAVE_WINDOW_SYSTEM
965 Lisp_Object tail
, frame
;
969 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
971 struct x_display_info
*dpyinfo
;
973 /* Fonts are common for frames on one display, i.e. on
975 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
976 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
977 clear_font_table (dpyinfo
);
979 /* From time to time see if we can unload some fonts. This also
980 frees all realized faces on all frames. Fonts needed by
981 faces will be loaded again when faces are realized again. */
982 clear_font_table_count
= 0;
984 FOR_EACH_FRAME (tail
, frame
)
986 struct frame
*f
= XFRAME (frame
);
987 if (FRAME_WINDOW_P (f
)
988 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
989 free_all_realized_faces (frame
);
994 /* Clear GCs of realized faces. */
995 FOR_EACH_FRAME (tail
, frame
)
998 if (FRAME_WINDOW_P (f
))
1000 clear_face_gcs (FRAME_FACE_CACHE (f
));
1001 clear_image_cache (f
, 0);
1005 #endif /* HAVE_WINDOW_SYSTEM */
1009 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1010 doc
: /* Clear face caches on all frames.
1011 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1013 Lisp_Object thoroughly
;
1015 clear_face_cache (!NILP (thoroughly
));
1016 ++face_change_count
;
1017 ++windows_or_buffers_changed
;
1023 #ifdef HAVE_WINDOW_SYSTEM
1026 /* Remove fonts from the font table of DPYINFO except for the default
1027 ASCII fonts of frames on that display. Called from clear_face_cache
1028 from time to time. */
1031 clear_font_table (dpyinfo
)
1032 struct x_display_info
*dpyinfo
;
1036 /* Free those fonts that are not used by frames on DPYINFO. */
1037 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1039 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1040 Lisp_Object tail
, frame
;
1042 /* Check if slot is already free. */
1043 if (font_info
->name
== NULL
)
1046 /* Don't free a default font of some frame. */
1047 FOR_EACH_FRAME (tail
, frame
)
1049 struct frame
*f
= XFRAME (frame
);
1050 if (FRAME_WINDOW_P (f
)
1051 && font_info
->font
== FRAME_FONT (f
))
1059 if (font_info
->full_name
!= font_info
->name
)
1060 xfree (font_info
->full_name
);
1061 xfree (font_info
->name
);
1063 /* Free the font. */
1065 #ifdef HAVE_X_WINDOWS
1066 XFreeFont (dpyinfo
->display
, font_info
->font
);
1069 w32_unload_font (dpyinfo
, font_info
->font
);
1073 /* Mark font table slot free. */
1074 font_info
->font
= NULL
;
1075 font_info
->name
= font_info
->full_name
= NULL
;
1079 #endif /* HAVE_WINDOW_SYSTEM */
1083 /***********************************************************************
1085 ***********************************************************************/
1087 #ifdef HAVE_WINDOW_SYSTEM
1089 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1090 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1091 A bitmap specification is either a string, a file name, or a list
1092 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1093 HEIGHT is its height, and DATA is a string containing the bits of
1094 the pixmap. Bits are stored row by row, each row occupies
1095 \(WIDTH + 7)/8 bytes. */)
1101 if (STRINGP (object
))
1102 /* If OBJECT is a string, it's a file name. */
1104 else if (CONSP (object
))
1106 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1107 HEIGHT must be integers > 0, and DATA must be string large
1108 enough to hold a bitmap of the specified size. */
1109 Lisp_Object width
, height
, data
;
1111 height
= width
= data
= Qnil
;
1115 width
= XCAR (object
);
1116 object
= XCDR (object
);
1119 height
= XCAR (object
);
1120 object
= XCDR (object
);
1122 data
= XCAR (object
);
1126 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1128 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1130 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1135 return pixmap_p
? Qt
: Qnil
;
1139 /* Load a bitmap according to NAME (which is either a file name or a
1140 pixmap spec) for use on frame F. Value is the bitmap_id (see
1141 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1142 bitmap cannot be loaded, display a message saying so, and return
1143 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1144 if these pointers are not null. */
1147 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1150 unsigned int *w_ptr
, *h_ptr
;
1158 tem
= Fbitmap_spec_p (name
);
1160 wrong_type_argument (Qbitmap_spec_p
, name
);
1165 /* Decode a bitmap spec into a bitmap. */
1170 w
= XINT (Fcar (name
));
1171 h
= XINT (Fcar (Fcdr (name
)));
1172 bits
= Fcar (Fcdr (Fcdr (name
)));
1174 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1179 /* It must be a string -- a file name. */
1180 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1186 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1197 ++npixmaps_allocated
;
1200 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1203 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1209 #endif /* HAVE_WINDOW_SYSTEM */
1213 /***********************************************************************
1215 ***********************************************************************/
1217 #ifdef HAVE_WINDOW_SYSTEM
1219 /* Load font of face FACE which is used on frame F to display
1220 character C. The name of the font to load is determined by lface
1221 and fontset of FACE. */
1224 load_face_font (f
, face
, c
)
1229 struct font_info
*font_info
= NULL
;
1231 int needs_overstrike
;
1233 face
->font_info_id
= -1;
1236 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1242 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1247 face
->font_info_id
= font_info
->font_idx
;
1248 face
->font
= font_info
->font
;
1249 face
->font_name
= font_info
->full_name
;
1250 face
->overstrike
= needs_overstrike
;
1253 x_free_gc (f
, face
->gc
);
1258 add_to_log ("Unable to load font %s",
1259 build_string (font_name
), Qnil
);
1263 #endif /* HAVE_WINDOW_SYSTEM */
1267 /***********************************************************************
1269 ***********************************************************************/
1271 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1272 RGB_LIST should contain (at least) 3 lisp integers.
1273 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1276 parse_rgb_list (rgb_list
, color
)
1277 Lisp_Object rgb_list
;
1280 #define PARSE_RGB_LIST_FIELD(field) \
1281 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1283 color->field = XINT (XCAR (rgb_list)); \
1284 rgb_list = XCDR (rgb_list); \
1289 PARSE_RGB_LIST_FIELD (red
);
1290 PARSE_RGB_LIST_FIELD (green
);
1291 PARSE_RGB_LIST_FIELD (blue
);
1297 /* Lookup on frame F the color described by the lisp string COLOR.
1298 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1299 non-zero, then the `standard' definition of the same color is
1303 tty_lookup_color (f
, color
, tty_color
, std_color
)
1306 XColor
*tty_color
, *std_color
;
1308 Lisp_Object frame
, color_desc
;
1310 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1313 XSETFRAME (frame
, f
);
1315 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1316 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1320 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1323 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1325 rgb
= XCDR (XCDR (color_desc
));
1326 if (! parse_rgb_list (rgb
, tty_color
))
1329 /* Should we fill in STD_COLOR too? */
1332 /* Default STD_COLOR to the same as TTY_COLOR. */
1333 *std_color
= *tty_color
;
1335 /* Do a quick check to see if the returned descriptor is
1336 actually _exactly_ equal to COLOR, otherwise we have to
1337 lookup STD_COLOR separately. If it's impossible to lookup
1338 a standard color, we just give up and use TTY_COLOR. */
1339 if ((!STRINGP (XCAR (color_desc
))
1340 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1341 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1343 /* Look up STD_COLOR separately. */
1344 rgb
= call1 (Qtty_color_standard_values
, color
);
1345 if (! parse_rgb_list (rgb
, std_color
))
1352 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1353 /* We were called early during startup, and the colors are not
1354 yet set up in tty-defined-color-alist. Don't return a failure
1355 indication, since this produces the annoying "Unable to
1356 load color" messages in the *Messages* buffer. */
1359 /* tty-color-desc seems to have returned a bad value. */
1363 /* A version of defined_color for non-X frames. */
1366 tty_defined_color (f
, color_name
, color_def
, alloc
)
1375 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1377 color_def
->blue
= 0;
1378 color_def
->green
= 0;
1381 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1383 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1385 if (strcmp (color_name
, "unspecified-fg") == 0)
1386 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1387 else if (strcmp (color_name
, "unspecified-bg") == 0)
1388 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1391 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1398 /* Decide if color named COLOR_NAME is valid for the display
1399 associated with the frame F; if so, return the rgb values in
1400 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1402 This does the right thing for any type of frame. */
1405 defined_color (f
, color_name
, color_def
, alloc
)
1411 if (!FRAME_WINDOW_P (f
))
1412 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1413 #ifdef HAVE_X_WINDOWS
1414 else if (FRAME_X_P (f
))
1415 return x_defined_color (f
, color_name
, color_def
, alloc
);
1418 else if (FRAME_W32_P (f
))
1419 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1422 else if (FRAME_MAC_P (f
))
1423 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1430 /* Given the index IDX of a tty color on frame F, return its name, a
1434 tty_color_name (f
, idx
)
1438 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1441 Lisp_Object coldesc
;
1443 XSETFRAME (frame
, f
);
1444 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1446 if (!NILP (coldesc
))
1447 return XCAR (coldesc
);
1450 /* We can have an MSDOG frame under -nw for a short window of
1451 opportunity before internal_terminal_init is called. DTRT. */
1452 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1453 return msdos_stdcolor_name (idx
);
1456 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1457 return build_string (unspecified_fg
);
1458 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1459 return build_string (unspecified_bg
);
1462 return vga_stdcolor_name (idx
);
1465 return Qunspecified
;
1469 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1470 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1473 face_color_gray_p (f
, color_name
)
1480 if (defined_color (f
, color_name
, &color
, 0))
1481 gray_p
= ((abs (color
.red
- color
.green
)
1482 < max (color
.red
, color
.green
) / 20)
1483 && (abs (color
.green
- color
.blue
)
1484 < max (color
.green
, color
.blue
) / 20)
1485 && (abs (color
.blue
- color
.red
)
1486 < max (color
.blue
, color
.red
) / 20));
1494 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1495 BACKGROUND_P non-zero means the color will be used as background
1499 face_color_supported_p (f
, color_name
, background_p
)
1507 XSETFRAME (frame
, f
);
1508 return (FRAME_WINDOW_P (f
)
1509 ? (!NILP (Fxw_display_color_p (frame
))
1510 || xstricmp (color_name
, "black") == 0
1511 || xstricmp (color_name
, "white") == 0
1513 && face_color_gray_p (f
, color_name
))
1514 || (!NILP (Fx_display_grayscale_p (frame
))
1515 && face_color_gray_p (f
, color_name
)))
1516 : tty_defined_color (f
, color_name
, ¬_used
, 0));
1520 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1521 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1522 FRAME specifies the frame and thus the display for interpreting COLOR.
1523 If FRAME is nil or omitted, use the selected frame. */)
1525 Lisp_Object color
, frame
;
1529 CHECK_STRING (color
);
1531 frame
= selected_frame
;
1533 CHECK_FRAME (frame
);
1535 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1539 DEFUN ("color-supported-p", Fcolor_supported_p
,
1540 Scolor_supported_p
, 1, 3, 0,
1541 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1542 BACKGROUND-P non-nil means COLOR is used as a background.
1543 If FRAME is nil or omitted, use the selected frame.
1544 COLOR must be a valid color name. */)
1545 (color
, frame
, background_p
)
1546 Lisp_Object frame
, color
, background_p
;
1550 CHECK_STRING (color
);
1552 frame
= selected_frame
;
1554 CHECK_FRAME (frame
);
1556 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1562 /* Load color with name NAME for use by face FACE on frame F.
1563 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1564 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1565 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1566 pixel color. If color cannot be loaded, display a message, and
1567 return the foreground, background or underline color of F, but
1568 record that fact in flags of the face so that we don't try to free
1572 load_color (f
, face
, name
, target_index
)
1576 enum lface_attribute_index target_index
;
1580 xassert (STRINGP (name
));
1581 xassert (target_index
== LFACE_FOREGROUND_INDEX
1582 || target_index
== LFACE_BACKGROUND_INDEX
1583 || target_index
== LFACE_UNDERLINE_INDEX
1584 || target_index
== LFACE_OVERLINE_INDEX
1585 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1586 || target_index
== LFACE_BOX_INDEX
);
1588 /* if the color map is full, defined_color will return a best match
1589 to the values in an existing cell. */
1590 if (!defined_color (f
, SDATA (name
), &color
, 1))
1592 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1594 switch (target_index
)
1596 case LFACE_FOREGROUND_INDEX
:
1597 face
->foreground_defaulted_p
= 1;
1598 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1601 case LFACE_BACKGROUND_INDEX
:
1602 face
->background_defaulted_p
= 1;
1603 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1606 case LFACE_UNDERLINE_INDEX
:
1607 face
->underline_defaulted_p
= 1;
1608 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1611 case LFACE_OVERLINE_INDEX
:
1612 face
->overline_color_defaulted_p
= 1;
1613 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1616 case LFACE_STRIKE_THROUGH_INDEX
:
1617 face
->strike_through_color_defaulted_p
= 1;
1618 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1621 case LFACE_BOX_INDEX
:
1622 face
->box_color_defaulted_p
= 1;
1623 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1632 ++ncolors_allocated
;
1639 #ifdef HAVE_WINDOW_SYSTEM
1641 /* Load colors for face FACE which is used on frame F. Colors are
1642 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1643 of ATTRS. If the background color specified is not supported on F,
1644 try to emulate gray colors with a stipple from Vface_default_stipple. */
1647 load_face_colors (f
, face
, attrs
)
1654 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1655 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1657 /* Swap colors if face is inverse-video. */
1658 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1666 /* Check for support for foreground, not for background because
1667 face_color_supported_p is smart enough to know that grays are
1668 "supported" as background because we are supposed to use stipple
1670 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1671 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1673 x_destroy_bitmap (f
, face
->stipple
);
1674 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1675 &face
->pixmap_w
, &face
->pixmap_h
);
1678 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1679 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1683 /* Free color PIXEL on frame F. */
1686 unload_color (f
, pixel
)
1688 unsigned long pixel
;
1690 #ifdef HAVE_X_WINDOWS
1694 x_free_colors (f
, &pixel
, 1);
1701 /* Free colors allocated for FACE. */
1704 free_face_colors (f
, face
)
1708 #ifdef HAVE_X_WINDOWS
1709 if (face
->colors_copied_bitwise_p
)
1714 if (!face
->foreground_defaulted_p
)
1716 x_free_colors (f
, &face
->foreground
, 1);
1717 IF_DEBUG (--ncolors_allocated
);
1720 if (!face
->background_defaulted_p
)
1722 x_free_colors (f
, &face
->background
, 1);
1723 IF_DEBUG (--ncolors_allocated
);
1726 if (face
->underline_p
1727 && !face
->underline_defaulted_p
)
1729 x_free_colors (f
, &face
->underline_color
, 1);
1730 IF_DEBUG (--ncolors_allocated
);
1733 if (face
->overline_p
1734 && !face
->overline_color_defaulted_p
)
1736 x_free_colors (f
, &face
->overline_color
, 1);
1737 IF_DEBUG (--ncolors_allocated
);
1740 if (face
->strike_through_p
1741 && !face
->strike_through_color_defaulted_p
)
1743 x_free_colors (f
, &face
->strike_through_color
, 1);
1744 IF_DEBUG (--ncolors_allocated
);
1747 if (face
->box
!= FACE_NO_BOX
1748 && !face
->box_color_defaulted_p
)
1750 x_free_colors (f
, &face
->box_color
, 1);
1751 IF_DEBUG (--ncolors_allocated
);
1755 #endif /* HAVE_X_WINDOWS */
1758 #endif /* HAVE_WINDOW_SYSTEM */
1762 /***********************************************************************
1764 ***********************************************************************/
1766 /* An enumerator for each field of an XLFD font name. */
1787 /* An enumerator for each possible slant value of a font. Taken from
1788 the XLFD specification. */
1796 XLFD_SLANT_REVERSE_ITALIC
,
1797 XLFD_SLANT_REVERSE_OBLIQUE
,
1801 /* Relative font weight according to XLFD documentation. */
1805 XLFD_WEIGHT_UNKNOWN
,
1806 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1807 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1808 XLFD_WEIGHT_LIGHT
, /* 30 */
1809 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1810 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1811 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1812 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1813 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1814 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1817 /* Relative proportionate width. */
1821 XLFD_SWIDTH_UNKNOWN
,
1822 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1823 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1824 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1825 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1826 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1827 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1828 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1829 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1830 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1833 /* Structure used for tables mapping XLFD weight, slant, and width
1834 names to numeric and symbolic values. */
1840 Lisp_Object
*symbol
;
1843 /* Table of XLFD slant names and their numeric and symbolic
1844 representations. This table must be sorted by slant names in
1847 static struct table_entry slant_table
[] =
1849 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1850 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1851 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1852 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1853 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1854 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1857 /* Table of XLFD weight names. This table must be sorted by weight
1858 names in ascending order. */
1860 static struct table_entry weight_table
[] =
1862 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1863 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1864 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1865 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1866 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1867 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1868 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1869 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1870 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1871 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1872 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1873 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1874 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1875 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1876 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1877 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1880 /* Table of XLFD width names. This table must be sorted by width
1881 names in ascending order. */
1883 static struct table_entry swidth_table
[] =
1885 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1886 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1887 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1888 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1889 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1890 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1891 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1892 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1893 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1894 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1895 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1896 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1897 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1898 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1899 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1902 /* Structure used to hold the result of splitting font names in XLFD
1903 format into their fields. */
1907 /* The original name which is modified destructively by
1908 split_font_name. The pointer is kept here to be able to free it
1909 if it was allocated from the heap. */
1912 /* Font name fields. Each vector element points into `name' above.
1913 Fields are NUL-terminated. */
1914 char *fields
[XLFD_LAST
];
1916 /* Numeric values for those fields that interest us. See
1917 split_font_name for which these are. */
1918 int numeric
[XLFD_LAST
];
1920 /* If the original name matches one of Vface_font_rescale_alist,
1921 the value is the corresponding rescale ratio. Otherwise, the
1923 double rescale_ratio
;
1925 /* Lower value mean higher priority. */
1926 int registry_priority
;
1929 /* The frame in effect when sorting font names. Set temporarily in
1930 sort_fonts so that it is available in font comparison functions. */
1932 static struct frame
*font_frame
;
1934 /* Order by which font selection chooses fonts. The default values
1935 mean `first, find a best match for the font width, then for the
1936 font height, then for weight, then for slant.' This variable can be
1937 set via set-face-font-sort-order. */
1940 static int font_sort_order
[4] = {
1941 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1944 static int font_sort_order
[4];
1947 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1948 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1949 is a pointer to the matching table entry or null if no table entry
1952 static struct table_entry
*
1953 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1954 struct table_entry
*table
;
1956 struct font_name
*font
;
1959 /* Function split_font_name converts fields to lower-case, so there
1960 is no need to use xstrlwr or xstricmp here. */
1961 char *s
= font
->fields
[field_index
];
1962 int low
, mid
, high
, cmp
;
1969 mid
= (low
+ high
) / 2;
1970 cmp
= strcmp (table
[mid
].name
, s
);
1984 /* Return a numeric representation for font name field
1985 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
1986 has DIM entries. Value is the numeric value found or DFLT if no
1987 table entry matches. This function is used to translate weight,
1988 slant, and swidth names of XLFD font names to numeric values. */
1991 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
1992 struct table_entry
*table
;
1994 struct font_name
*font
;
1998 struct table_entry
*p
;
1999 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2000 return p
? p
->numeric
: dflt
;
2004 /* Return a symbolic representation for font name field
2005 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2006 has DIM entries. Value is the symbolic value found or DFLT if no
2007 table entry matches. This function is used to translate weight,
2008 slant, and swidth names of XLFD font names to symbols. */
2010 static INLINE Lisp_Object
2011 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2012 struct table_entry
*table
;
2014 struct font_name
*font
;
2018 struct table_entry
*p
;
2019 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2020 return p
? *p
->symbol
: dflt
;
2024 /* Return a numeric value for the slant of the font given by FONT. */
2027 xlfd_numeric_slant (font
)
2028 struct font_name
*font
;
2030 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2031 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2035 /* Return a symbol representing the weight of the font given by FONT. */
2037 static INLINE Lisp_Object
2038 xlfd_symbolic_slant (font
)
2039 struct font_name
*font
;
2041 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2042 font
, XLFD_SLANT
, Qnormal
);
2046 /* Return a numeric value for the weight of the font given by FONT. */
2049 xlfd_numeric_weight (font
)
2050 struct font_name
*font
;
2052 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2053 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2057 /* Return a symbol representing the slant of the font given by FONT. */
2059 static INLINE Lisp_Object
2060 xlfd_symbolic_weight (font
)
2061 struct font_name
*font
;
2063 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2064 font
, XLFD_WEIGHT
, Qnormal
);
2068 /* Return a numeric value for the swidth of the font whose XLFD font
2069 name fields are found in FONT. */
2072 xlfd_numeric_swidth (font
)
2073 struct font_name
*font
;
2075 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2076 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2080 /* Return a symbolic value for the swidth of FONT. */
2082 static INLINE Lisp_Object
2083 xlfd_symbolic_swidth (font
)
2084 struct font_name
*font
;
2086 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2087 font
, XLFD_SWIDTH
, Qnormal
);
2091 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2092 entries. Value is a pointer to the matching table entry or null if
2093 no element of TABLE contains SYMBOL. */
2095 static struct table_entry
*
2096 face_value (table
, dim
, symbol
)
2097 struct table_entry
*table
;
2103 xassert (SYMBOLP (symbol
));
2105 for (i
= 0; i
< dim
; ++i
)
2106 if (EQ (*table
[i
].symbol
, symbol
))
2109 return i
< dim
? table
+ i
: NULL
;
2113 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2114 entries. Value is -1 if SYMBOL is not found in TABLE. */
2117 face_numeric_value (table
, dim
, symbol
)
2118 struct table_entry
*table
;
2122 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2123 return p
? p
->numeric
: -1;
2127 /* Return a numeric value representing the weight specified by Lisp
2128 symbol WEIGHT. Value is one of the enumerators of enum
2132 face_numeric_weight (weight
)
2135 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2139 /* Return a numeric value representing the slant specified by Lisp
2140 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2143 face_numeric_slant (slant
)
2146 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2150 /* Return a numeric value representing the swidth specified by Lisp
2151 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2154 face_numeric_swidth (width
)
2157 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2161 #ifdef HAVE_WINDOW_SYSTEM
2163 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2167 struct font_name
*font
;
2169 /* Function split_font_name converts fields to lower-case, so there
2170 is no need to use tolower here. */
2171 return *font
->fields
[XLFD_SPACING
] != 'p';
2175 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2177 The actual height of the font when displayed on F depends on the
2178 resolution of both the font and frame. For example, a 10pt font
2179 designed for a 100dpi display will display larger than 10pt on a
2180 75dpi display. (It's not unusual to use fonts not designed for the
2181 display one is using. For example, some intlfonts are available in
2182 72dpi versions, only.)
2184 Value is the real point size of FONT on frame F, or 0 if it cannot
2188 xlfd_point_size (f
, font
)
2190 struct font_name
*font
;
2192 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2193 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2197 if (*pixel_field
== '[')
2199 /* The pixel size field is `[A B C D]' which specifies
2200 a transformation matrix.
2206 by which all glyphs of the font are transformed. The spec
2207 says that s scalar value N for the pixel size is equivalent
2208 to A = N * resx/resy, B = C = 0, D = N. */
2209 char *start
= pixel_field
+ 1, *end
;
2213 for (i
= 0; i
< 4; ++i
)
2215 matrix
[i
] = strtod (start
, &end
);
2222 pixel
= atoi (pixel_field
);
2227 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2233 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2234 of frame F. This function is used to guess a point size of font
2235 when only the pixel height of the font is available. */
2238 pixel_point_size (f
, pixel
)
2242 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2246 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2247 point size of one dot. */
2248 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2249 int_pt
= real_pt
+ 0.5;
2255 /* Return a rescaling ratio of a font of NAME. */
2258 font_rescale_ratio (name
)
2261 Lisp_Object tail
, elt
;
2263 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2266 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2267 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2268 return XFLOAT_DATA (XCDR (elt
));
2274 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2275 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2276 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2277 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2278 zero if the font name doesn't have the format we expect. The
2279 expected format is a font name that starts with a `-' and has
2280 XLFD_LAST fields separated by `-'. */
2283 split_font_name (f
, font
, numeric_p
)
2285 struct font_name
*font
;
2290 double rescale_ratio
;
2293 /* This must be done before splitting the font name. */
2294 rescale_ratio
= font_rescale_ratio (font
->name
);
2296 if (*font
->name
== '-')
2298 char *p
= xstrlwr (font
->name
) + 1;
2300 while (i
< XLFD_LAST
)
2302 font
->fields
[i
] = p
;
2305 /* Pixel and point size may be of the form `[....]'. For
2306 BNF, see XLFD spec, chapter 4. Negative values are
2307 indicated by tilde characters which we replace with
2308 `-' characters, here. */
2310 && (i
- 1 == XLFD_PIXEL_SIZE
2311 || i
- 1 == XLFD_POINT_SIZE
))
2316 for (++p
; *p
&& *p
!= ']'; ++p
)
2320 /* Check that the matrix contains 4 floating point
2322 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2325 if (strtod (start
, &end
) == 0 && start
== end
)
2332 while (*p
&& *p
!= '-')
2342 success_p
= i
== XLFD_LAST
;
2344 /* If requested, and font name was in the expected format,
2345 compute numeric values for some fields. */
2346 if (numeric_p
&& success_p
)
2348 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2349 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2350 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2351 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2352 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2353 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2354 font
->rescale_ratio
= rescale_ratio
;
2357 /* Initialize it to zero. It will be overridden by font_list while
2358 trying alternate registries. */
2359 font
->registry_priority
= 0;
2365 /* Build an XLFD font name from font name fields in FONT. Value is a
2366 pointer to the font name, which is allocated via xmalloc. */
2369 build_font_name (font
)
2370 struct font_name
*font
;
2374 char *font_name
= (char *) xmalloc (size
);
2375 int total_length
= 0;
2377 for (i
= 0; i
< XLFD_LAST
; ++i
)
2379 /* Add 1 because of the leading `-'. */
2380 int len
= strlen (font
->fields
[i
]) + 1;
2382 /* Reallocate font_name if necessary. Add 1 for the final
2384 if (total_length
+ len
+ 1 >= size
)
2386 int new_size
= max (2 * size
, size
+ len
+ 1);
2387 int sz
= new_size
* sizeof *font_name
;
2388 font_name
= (char *) xrealloc (font_name
, sz
);
2392 font_name
[total_length
] = '-';
2393 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2394 total_length
+= len
;
2397 font_name
[total_length
] = 0;
2402 /* Free an array FONTS of N font_name structures. This frees FONTS
2403 itself and all `name' fields in its elements. */
2406 free_font_names (fonts
, n
)
2407 struct font_name
*fonts
;
2411 xfree (fonts
[--n
].name
);
2416 /* Sort vector FONTS of font_name structures which contains NFONTS
2417 elements using qsort and comparison function CMPFN. F is the frame
2418 on which the fonts will be used. The global variable font_frame
2419 is temporarily set to F to make it available in CMPFN. */
2422 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2424 struct font_name
*fonts
;
2426 int (*cmpfn
) P_ ((const void *, const void *));
2429 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2434 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2435 display in x_display_list. FONTS is a pointer to a vector of
2436 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2437 alternative patterns from Valternate_fontname_alist if no fonts are
2438 found matching PATTERN.
2440 For all fonts found, set FONTS[i].name to the name of the font,
2441 allocated via xmalloc, and split font names into fields. Ignore
2442 fonts that we can't parse. Value is the number of fonts found. */
2445 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2448 struct font_name
**pfonts
;
2449 int nfonts
, try_alternatives_p
;
2453 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2454 better to do it the other way around. */
2456 Lisp_Object lpattern
, tem
;
2457 struct font_name
*fonts
= 0;
2458 int num_fonts
= nfonts
;
2461 lpattern
= build_string (pattern
);
2463 /* Get the list of fonts matching PATTERN. */
2466 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2469 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2472 if (nfonts
< 0 && CONSP (lfonts
))
2473 num_fonts
= XFASTINT (Flength (lfonts
));
2475 /* Make a copy of the font names we got from X, and
2476 split them into fields. */
2478 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2480 Lisp_Object elt
, tail
;
2481 const char *name
= SDATA (XCAR (tem
));
2483 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2484 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2488 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2499 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2503 /* Make a copy of the font name. */
2504 fonts
[n
].name
= xstrdup (name
);
2506 if (split_font_name (f
, fonts
+ n
, 1))
2508 if (font_scalable_p (fonts
+ n
)
2509 && !may_use_scalable_font_p (name
))
2512 xfree (fonts
[n
].name
);
2518 xfree (fonts
[n
].name
);
2521 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2522 if (n
== 0 && try_alternatives_p
)
2524 Lisp_Object list
= Valternate_fontname_alist
;
2532 while (CONSP (list
))
2534 Lisp_Object entry
= XCAR (list
);
2536 && STRINGP (XCAR (entry
))
2537 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2544 Lisp_Object patterns
= XCAR (list
);
2547 while (CONSP (patterns
)
2548 /* If list is screwed up, give up. */
2549 && (name
= XCAR (patterns
),
2551 /* Ignore patterns equal to PATTERN because we tried that
2552 already with no success. */
2553 && (strcmp (SDATA (name
), pattern
) == 0
2554 || (n
= x_face_list_fonts (f
, SDATA (name
),
2557 patterns
= XCDR (patterns
);
2565 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2566 using comparison function CMPFN. Value is the number of fonts
2567 found. If value is non-zero, *FONTS is set to a vector of
2568 font_name structures allocated from the heap containing matching
2569 fonts. Each element of *FONTS contains a name member that is also
2570 allocated from the heap. Font names in these structures are split
2571 into fields. Use free_font_names to free such an array. */
2574 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2577 int (*cmpfn
) P_ ((const void *, const void *));
2578 struct font_name
**fonts
;
2582 /* Get the list of fonts matching pattern. 100 should suffice. */
2583 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2584 if (INTEGERP (Vfont_list_limit
))
2585 nfonts
= XINT (Vfont_list_limit
);
2588 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2590 /* Sort the resulting array and return it in *FONTS. If no
2591 fonts were found, make sure to set *FONTS to null. */
2593 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2604 /* Compare two font_name structures *A and *B. Value is analogous to
2605 strcmp. Sort order is given by the global variable
2606 font_sort_order. Font names are sorted so that, everything else
2607 being equal, fonts with a resolution closer to that of the frame on
2608 which they are used are listed first. The global variable
2609 font_frame is the frame on which we operate. */
2612 cmp_font_names (a
, b
)
2615 struct font_name
*x
= (struct font_name
*) a
;
2616 struct font_name
*y
= (struct font_name
*) b
;
2619 /* All strings have been converted to lower-case by split_font_name,
2620 so we can use strcmp here. */
2621 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2626 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2628 int j
= font_sort_order
[i
];
2629 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2634 /* Everything else being equal, we prefer fonts with an
2635 y-resolution closer to that of the frame. */
2636 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2637 int x_resy
= x
->numeric
[XLFD_RESY
];
2638 int y_resy
= y
->numeric
[XLFD_RESY
];
2639 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2647 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2648 is non-nil list fonts matching that pattern. Otherwise, if
2649 REGISTRY is non-nil return only fonts with that registry, otherwise
2650 return fonts of any registry. Set *FONTS to a vector of font_name
2651 structures allocated from the heap containing the fonts found.
2652 Value is the number of fonts found. */
2655 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2657 Lisp_Object pattern
, family
, registry
;
2658 struct font_name
**fonts
;
2660 char *pattern_str
, *family_str
, *registry_str
;
2664 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2665 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2667 pattern_str
= (char *) alloca (strlen (family_str
)
2668 + strlen (registry_str
)
2670 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2671 strcat (pattern_str
, family_str
);
2672 strcat (pattern_str
, "-*-");
2673 strcat (pattern_str
, registry_str
);
2674 if (!index (registry_str
, '-'))
2676 if (registry_str
[strlen (registry_str
) - 1] == '*')
2677 strcat (pattern_str
, "-*");
2679 strcat (pattern_str
, "*-*");
2683 pattern_str
= (char *) SDATA (pattern
);
2685 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2689 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2690 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2691 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2694 static struct font_name
*
2695 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2696 struct font_name
*fonts1
, *fonts2
;
2697 int nfonts1
, nfonts2
;
2699 int new_nfonts
= nfonts1
+ nfonts2
;
2700 struct font_name
*new_fonts
;
2702 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2703 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2704 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2711 /* Get a sorted list of fonts of family FAMILY on frame F.
2713 If PATTERN is non-nil list fonts matching that pattern.
2715 If REGISTRY is non-nil, return fonts with that registry and the
2716 alternative registries from Vface_alternative_font_registry_alist.
2718 If REGISTRY is nil return fonts of any registry.
2720 Set *FONTS to a vector of font_name structures allocated from the
2721 heap containing the fonts found. Value is the number of fonts
2725 font_list (f
, pattern
, family
, registry
, fonts
)
2727 Lisp_Object pattern
, family
, registry
;
2728 struct font_name
**fonts
;
2730 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2732 if (!NILP (registry
)
2733 && CONSP (Vface_alternative_font_registry_alist
))
2737 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2742 for (alter
= XCDR (alter
), reg_prio
= 1;
2744 alter
= XCDR (alter
), reg_prio
++)
2745 if (STRINGP (XCAR (alter
)))
2748 struct font_name
*fonts2
;
2750 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2752 for (i
= 0; i
< nfonts2
; i
++)
2753 fonts2
[i
].registry_priority
= reg_prio
;
2754 *fonts
= (nfonts
> 0
2755 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2766 /* Remove elements from LIST whose cars are `equal'. Called from
2767 x-family-fonts and x-font-family-list to remove duplicate font
2771 remove_duplicates (list
)
2774 Lisp_Object tail
= list
;
2776 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2778 Lisp_Object next
= XCDR (tail
);
2779 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2780 XSETCDR (tail
, XCDR (next
));
2787 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2788 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2789 If FAMILY is omitted or nil, list all families.
2790 Otherwise, FAMILY must be a string, possibly containing wildcards
2792 If FRAME is omitted or nil, use the selected frame.
2793 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2794 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2795 FAMILY is the font family name. POINT-SIZE is the size of the
2796 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2797 width, weight and slant of the font. These symbols are the same as for
2798 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2799 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2800 giving the registry and encoding of the font.
2801 The result list is sorted according to the current setting of
2802 the face font sort order. */)
2804 Lisp_Object family
, frame
;
2806 struct frame
*f
= check_x_frame (frame
);
2807 struct font_name
*fonts
;
2810 struct gcpro gcpro1
;
2813 CHECK_STRING (family
);
2817 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2818 for (i
= nfonts
- 1; i
>= 0; --i
)
2820 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2823 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2824 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2825 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2826 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2827 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2828 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2829 tem
= build_font_name (fonts
+ i
);
2830 ASET (v
, 6, build_string (tem
));
2831 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2832 fonts
[i
].fields
[XLFD_ENCODING
]);
2833 ASET (v
, 7, build_string (tem
));
2836 result
= Fcons (v
, result
);
2839 remove_duplicates (result
);
2840 free_font_names (fonts
, nfonts
);
2846 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2848 doc
: /* Return a list of available font families on FRAME.
2849 If FRAME is omitted or nil, use the selected frame.
2850 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2851 is a font family, and FIXED-P is non-nil if fonts of that family
2852 are fixed-pitch. */)
2856 struct frame
*f
= check_x_frame (frame
);
2858 struct font_name
*fonts
;
2860 struct gcpro gcpro1
;
2861 int count
= SPECPDL_INDEX ();
2863 /* Let's consider all fonts. */
2864 specbind (intern ("font-list-limit"), make_number (-1));
2865 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2869 for (i
= nfonts
- 1; i
>= 0; --i
)
2870 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2871 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2874 remove_duplicates (result
);
2875 free_font_names (fonts
, nfonts
);
2877 return unbind_to (count
, result
);
2881 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2882 doc
: /* Return a list of the names of available fonts matching PATTERN.
2883 If optional arguments FACE and FRAME are specified, return only fonts
2884 the same size as FACE on FRAME.
2885 PATTERN is a string, perhaps with wildcard characters;
2886 the * character matches any substring, and
2887 the ? character matches any single character.
2888 PATTERN is case-insensitive.
2889 FACE is a face name--a symbol.
2891 The return value is a list of strings, suitable as arguments to
2894 Fonts Emacs can't use may or may not be excluded
2895 even if they match PATTERN and FACE.
2896 The optional fourth argument MAXIMUM sets a limit on how many
2897 fonts to match. The first MAXIMUM fonts are reported.
2898 The optional fifth argument WIDTH, if specified, is a number of columns
2899 occupied by a character of a font. In that case, return only fonts
2900 the WIDTH times as wide as FACE on FRAME. */)
2901 (pattern
, face
, frame
, maximum
, width
)
2902 Lisp_Object pattern
, face
, frame
, maximum
, width
;
2909 CHECK_STRING (pattern
);
2915 CHECK_NATNUM (maximum
);
2916 maxnames
= XINT (maximum
);
2920 CHECK_NUMBER (width
);
2922 /* We can't simply call check_x_frame because this function may be
2923 called before any frame is created. */
2924 f
= frame_or_selected_frame (frame
, 2);
2925 if (!FRAME_WINDOW_P (f
))
2927 /* Perhaps we have not yet created any frame. */
2932 /* Determine the width standard for comparison with the fonts we find. */
2938 /* This is of limited utility since it works with character
2939 widths. Keep it for compatibility. --gerd. */
2940 int face_id
= lookup_named_face (f
, face
, 0);
2941 struct face
*face
= (face_id
< 0
2943 : FACE_FROM_ID (f
, face_id
));
2946 /* For historic reasons, FONT_WIDTH refers to average width on W32,
2947 not maximum as on X. Redefine here. */
2949 #define FONT_WIDTH FONT_MAX_WIDTH
2952 if (face
&& face
->font
)
2953 size
= FONT_WIDTH (face
->font
);
2955 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
2958 size
*= XINT (width
);
2962 Lisp_Object args
[2];
2964 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
2966 /* We don't have to check fontsets. */
2968 args
[1] = list_fontsets (f
, pattern
, size
);
2969 return Fnconc (2, args
);
2973 #endif /* HAVE_WINDOW_SYSTEM */
2977 /***********************************************************************
2979 ***********************************************************************/
2981 /* Access face attributes of face LFACE, a Lisp vector. */
2983 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
2984 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
2985 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
2986 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
2987 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
2988 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
2989 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
2990 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
2991 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
2992 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
2993 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
2994 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
2995 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
2996 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
2997 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
2998 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3000 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3001 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3003 #define LFACEP(LFACE) \
3005 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3006 && EQ (AREF (LFACE, 0), Qface))
3011 /* Check consistency of Lisp face attribute vector ATTRS. */
3014 check_lface_attrs (attrs
)
3017 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3018 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3019 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3020 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3021 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3022 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3023 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3024 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3025 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3026 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3027 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3028 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3029 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3030 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3031 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3032 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3033 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3034 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3035 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3036 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3037 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3038 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3039 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3040 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3041 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3042 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3043 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3044 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3045 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3046 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3047 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3048 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3049 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3050 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3051 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3052 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3053 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3054 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3055 #ifdef HAVE_WINDOW_SYSTEM
3056 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3057 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3058 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3059 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3060 || NILP (attrs
[LFACE_FONT_INDEX
])
3061 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3066 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3074 xassert (LFACEP (lface
));
3075 check_lface_attrs (XVECTOR (lface
)->contents
);
3079 #else /* GLYPH_DEBUG == 0 */
3081 #define check_lface_attrs(attrs) (void) 0
3082 #define check_lface(lface) (void) 0
3084 #endif /* GLYPH_DEBUG == 0 */
3087 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3088 to make it a symvol. If FACE_NAME is an alias for another face,
3089 return that face's name. */
3092 resolve_face_name (face_name
)
3093 Lisp_Object face_name
;
3095 Lisp_Object aliased
;
3097 if (STRINGP (face_name
))
3098 face_name
= intern (SDATA (face_name
));
3100 while (SYMBOLP (face_name
))
3102 aliased
= Fget (face_name
, Qface_alias
);
3106 face_name
= aliased
;
3113 /* Return the face definition of FACE_NAME on frame F. F null means
3114 return the definition for new frames. FACE_NAME may be a string or
3115 a symbol (apparently Emacs 20.2 allowed strings as face names in
3116 face text properties; Ediff uses that). If FACE_NAME is an alias
3117 for another face, return that face's definition. If SIGNAL_P is
3118 non-zero, signal an error if FACE_NAME is not a valid face name.
3119 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3122 static INLINE Lisp_Object
3123 lface_from_face_name (f
, face_name
, signal_p
)
3125 Lisp_Object face_name
;
3130 face_name
= resolve_face_name (face_name
);
3133 lface
= assq_no_quit (face_name
, f
->face_alist
);
3135 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3138 lface
= XCDR (lface
);
3140 signal_error ("Invalid face", face_name
);
3142 check_lface (lface
);
3147 /* Get face attributes of face FACE_NAME from frame-local faces on
3148 frame F. Store the resulting attributes in ATTRS which must point
3149 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3150 is non-zero, signal an error if FACE_NAME does not name a face.
3151 Otherwise, value is zero if FACE_NAME is not a face. */
3154 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3156 Lisp_Object face_name
;
3163 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3166 bcopy (XVECTOR (lface
)->contents
, attrs
,
3167 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3177 /* Non-zero if all attributes in face attribute vector ATTRS are
3178 specified, i.e. are non-nil. */
3181 lface_fully_specified_p (attrs
)
3186 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3187 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3188 && i
!= LFACE_AVGWIDTH_INDEX
)
3189 if (UNSPECIFIEDP (attrs
[i
]))
3192 return i
== LFACE_VECTOR_SIZE
;
3195 #ifdef HAVE_WINDOW_SYSTEM
3197 /* Set font-related attributes of Lisp face LFACE from the fullname of
3198 the font opened by FONTNAME. If FORCE_P is zero, set only
3199 unspecified attributes of LFACE. The exception is `font'
3200 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3202 If FONTNAME is not available on frame F,
3203 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3204 If the fullname is not in a valid XLFD format,
3205 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3206 in LFACE and return 1.
3207 Otherwise, return 1. */
3210 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3213 Lisp_Object fontname
;
3214 int force_p
, may_fail_p
;
3216 struct font_name font
;
3221 char *font_name
= SDATA (fontname
);
3222 struct font_info
*font_info
;
3224 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3225 fontset
= fs_query_fontset (fontname
, 0);
3227 font_name
= SDATA (fontset_ascii (fontset
));
3229 /* Check if FONT_NAME is surely available on the system. Usually
3230 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3231 returns quickly. But, even if FONT_NAME is not yet cached,
3232 caching it now is not futail because we anyway load the font
3235 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3245 font
.name
= STRDUPA (font_info
->full_name
);
3246 have_xlfd_p
= split_font_name (f
, &font
, 1);
3248 /* Set attributes only if unspecified, otherwise face defaults for
3249 new frames would never take effect. If we couldn't get a font
3250 name conforming to XLFD, set normal values. */
3252 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3257 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3258 + strlen (font
.fields
[XLFD_FOUNDRY
])
3260 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3261 font
.fields
[XLFD_FAMILY
]);
3262 val
= build_string (buffer
);
3265 val
= build_string ("*");
3266 LFACE_FAMILY (lface
) = val
;
3269 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3272 pt
= xlfd_point_size (f
, &font
);
3274 pt
= pixel_point_size (f
, font_info
->height
* 10);
3276 LFACE_HEIGHT (lface
) = make_number (pt
);
3279 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3280 LFACE_SWIDTH (lface
)
3281 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3283 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3284 LFACE_AVGWIDTH (lface
)
3286 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3289 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3290 LFACE_WEIGHT (lface
)
3291 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3293 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3295 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3297 LFACE_FONT (lface
) = fontname
;
3302 #endif /* HAVE_WINDOW_SYSTEM */
3305 /* Merges the face height FROM with the face height TO, and returns the
3306 merged height. If FROM is an invalid height, then INVALID is
3307 returned instead. FROM and TO may be either absolute face heights or
3308 `relative' heights; the returned value is always an absolute height
3309 unless both FROM and TO are relative. GCPRO is a lisp value that
3310 will be protected from garbage-collection if this function makes a
3314 merge_face_heights (from
, to
, invalid
, gcpro
)
3315 Lisp_Object from
, to
, invalid
, gcpro
;
3317 Lisp_Object result
= invalid
;
3319 if (INTEGERP (from
))
3320 /* FROM is absolute, just use it as is. */
3322 else if (FLOATP (from
))
3323 /* FROM is a scale, use it to adjust TO. */
3326 /* relative X absolute => absolute */
3327 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3328 else if (FLOATP (to
))
3329 /* relative X relative => relative */
3330 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3332 else if (FUNCTIONP (from
))
3333 /* FROM is a function, which use to adjust TO. */
3335 /* Call function with current height as argument.
3336 From is the new height. */
3337 Lisp_Object args
[2];
3338 struct gcpro gcpro1
;
3344 result
= safe_call (2, args
);
3348 /* Ensure that if TO was absolute, so is the result. */
3349 if (INTEGERP (to
) && !INTEGERP (result
))
3357 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3358 store the resulting attributes in TO, which must be already be
3359 completely specified and contain only absolute attributes. Every
3360 specified attribute of FROM overrides the corresponding attribute of
3361 TO; relative attributes in FROM are merged with the absolute value in
3362 TO and replace it. CYCLE_CHECK is used internally to detect loops in
3363 face inheritance; it should be Qnil when called from other places. */
3366 merge_face_vectors (f
, from
, to
, cycle_check
)
3368 Lisp_Object
*from
, *to
;
3369 Lisp_Object cycle_check
;
3373 /* If FROM inherits from some other faces, merge their attributes into
3374 TO before merging FROM's direct attributes. Note that an :inherit
3375 attribute of `unspecified' is the same as one of nil; we never
3376 merge :inherit attributes, so nil is more correct, but lots of
3377 other code uses `unspecified' as a generic value for face attributes. */
3378 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3379 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3380 merge_face_inheritance (f
, from
[LFACE_INHERIT_INDEX
], to
, cycle_check
);
3382 /* If TO specifies a :font attribute, and FROM specifies some
3383 font-related attribute, we need to clear TO's :font attribute
3384 (because it will be inconsistent with whatever FROM specifies, and
3385 FROM takes precedence). */
3386 if (!NILP (to
[LFACE_FONT_INDEX
])
3387 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3388 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3389 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3390 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3391 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3392 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3393 to
[LFACE_FONT_INDEX
] = Qnil
;
3395 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3396 if (!UNSPECIFIEDP (from
[i
]))
3398 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3399 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
], cycle_check
);
3404 /* TO is always an absolute face, which should inherit from nothing.
3405 We blindly copy the :inherit attribute above and fix it up here. */
3406 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3410 /* Checks the `cycle check' variable CHECK to see if it indicates that
3411 EL is part of a cycle; CHECK must be either Qnil or a value returned
3412 by an earlier use of CYCLE_CHECK. SUSPICIOUS is the number of
3413 elements after which a cycle might be suspected; after that many
3414 elements, this macro begins consing in order to keep more precise
3417 Returns nil if a cycle was detected, otherwise a new value for CHECK
3420 CHECK is evaluated multiple times, EL and SUSPICIOUS 0 or 1 times, so
3421 the caller should make sure that's ok. */
3423 #define CYCLE_CHECK(check, el, suspicious) \
3426 : (INTEGERP (check) \
3427 ? (XFASTINT (check) < (suspicious) \
3428 ? make_number (XFASTINT (check) + 1) \
3429 : Fcons (el, Qnil)) \
3430 : (!NILP (Fmemq ((el), (check))) \
3432 : Fcons ((el), (check)))))
3435 /* Merge face attributes from the face on frame F whose name is
3436 INHERITS, into the vector of face attributes TO; INHERITS may also be
3437 a list of face names, in which case they are applied in order.
3438 CYCLE_CHECK is used to detect loops in face inheritance.
3439 Returns true if any of the inherited attributes are `font-related'. */
3442 merge_face_inheritance (f
, inherit
, to
, cycle_check
)
3444 Lisp_Object inherit
;
3446 Lisp_Object cycle_check
;
3448 if (SYMBOLP (inherit
) && !EQ (inherit
, Qunspecified
))
3449 /* Inherit from the named face INHERIT. */
3453 /* Make sure we're not in an inheritance loop. */
3454 cycle_check
= CYCLE_CHECK (cycle_check
, inherit
, 15);
3455 if (NILP (cycle_check
))
3456 /* Cycle detected, ignore any further inheritance. */
3459 lface
= lface_from_face_name (f
, inherit
, 0);
3461 merge_face_vectors (f
, XVECTOR (lface
)->contents
, to
, cycle_check
);
3463 else if (CONSP (inherit
))
3464 /* Handle a list of inherited faces by calling ourselves recursively
3465 on each element. Note that we only do so for symbol elements, so
3466 it's not possible to infinitely recurse. */
3468 while (CONSP (inherit
))
3470 if (SYMBOLP (XCAR (inherit
)))
3471 merge_face_inheritance (f
, XCAR (inherit
), to
, cycle_check
);
3473 /* Check for a circular inheritance list. */
3474 cycle_check
= CYCLE_CHECK (cycle_check
, inherit
, 15);
3475 if (NILP (cycle_check
))
3476 /* Cycle detected. */
3479 inherit
= XCDR (inherit
);
3485 /* Given a Lisp face attribute vector TO and a Lisp object PROP that
3486 is a face property, determine the resulting face attributes on
3487 frame F, and store them in TO. PROP may be a single face
3488 specification or a list of such specifications. Each face
3489 specification can be
3491 1. A symbol or string naming a Lisp face.
3493 2. A property list of the form (KEYWORD VALUE ...) where each
3494 KEYWORD is a face attribute name, and value is an appropriate value
3497 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3498 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3499 for compatibility with 20.2.
3501 Face specifications earlier in lists take precedence over later
3505 merge_face_vector_with_property (f
, to
, prop
)
3512 Lisp_Object first
= XCAR (prop
);
3514 if (EQ (first
, Qforeground_color
)
3515 || EQ (first
, Qbackground_color
))
3517 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3518 . COLOR). COLOR must be a string. */
3519 Lisp_Object color_name
= XCDR (prop
);
3520 Lisp_Object color
= first
;
3522 if (STRINGP (color_name
))
3524 if (EQ (color
, Qforeground_color
))
3525 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3527 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3530 add_to_log ("Invalid face color", color_name
, Qnil
);
3532 else if (SYMBOLP (first
)
3533 && *SDATA (SYMBOL_NAME (first
)) == ':')
3535 /* Assume this is the property list form. */
3536 while (CONSP (prop
) && CONSP (XCDR (prop
)))
3538 Lisp_Object keyword
= XCAR (prop
);
3539 Lisp_Object value
= XCAR (XCDR (prop
));
3541 if (EQ (keyword
, QCfamily
))
3543 if (STRINGP (value
))
3544 to
[LFACE_FAMILY_INDEX
] = value
;
3546 add_to_log ("Invalid face font family", value
, Qnil
);
3548 else if (EQ (keyword
, QCheight
))
3550 Lisp_Object new_height
=
3551 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
],
3554 if (NILP (new_height
))
3555 add_to_log ("Invalid face font height", value
, Qnil
);
3557 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3559 else if (EQ (keyword
, QCweight
))
3562 && face_numeric_weight (value
) >= 0)
3563 to
[LFACE_WEIGHT_INDEX
] = value
;
3565 add_to_log ("Invalid face weight", value
, Qnil
);
3567 else if (EQ (keyword
, QCslant
))
3570 && face_numeric_slant (value
) >= 0)
3571 to
[LFACE_SLANT_INDEX
] = value
;
3573 add_to_log ("Invalid face slant", value
, Qnil
);
3575 else if (EQ (keyword
, QCunderline
))
3580 to
[LFACE_UNDERLINE_INDEX
] = value
;
3582 add_to_log ("Invalid face underline", value
, Qnil
);
3584 else if (EQ (keyword
, QCoverline
))
3589 to
[LFACE_OVERLINE_INDEX
] = value
;
3591 add_to_log ("Invalid face overline", value
, Qnil
);
3593 else if (EQ (keyword
, QCstrike_through
))
3598 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3600 add_to_log ("Invalid face strike-through", value
, Qnil
);
3602 else if (EQ (keyword
, QCbox
))
3605 value
= make_number (1);
3606 if (INTEGERP (value
)
3610 to
[LFACE_BOX_INDEX
] = value
;
3612 add_to_log ("Invalid face box", value
, Qnil
);
3614 else if (EQ (keyword
, QCinverse_video
)
3615 || EQ (keyword
, QCreverse_video
))
3617 if (EQ (value
, Qt
) || NILP (value
))
3618 to
[LFACE_INVERSE_INDEX
] = value
;
3620 add_to_log ("Invalid face inverse-video", value
, Qnil
);
3622 else if (EQ (keyword
, QCforeground
))
3624 if (STRINGP (value
))
3625 to
[LFACE_FOREGROUND_INDEX
] = value
;
3627 add_to_log ("Invalid face foreground", value
, Qnil
);
3629 else if (EQ (keyword
, QCbackground
))
3631 if (STRINGP (value
))
3632 to
[LFACE_BACKGROUND_INDEX
] = value
;
3634 add_to_log ("Invalid face background", value
, Qnil
);
3636 else if (EQ (keyword
, QCstipple
))
3638 #ifdef HAVE_X_WINDOWS
3639 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3640 if (!NILP (pixmap_p
))
3641 to
[LFACE_STIPPLE_INDEX
] = value
;
3643 add_to_log ("Invalid face stipple", value
, Qnil
);
3646 else if (EQ (keyword
, QCwidth
))
3649 && face_numeric_swidth (value
) >= 0)
3650 to
[LFACE_SWIDTH_INDEX
] = value
;
3652 add_to_log ("Invalid face width", value
, Qnil
);
3654 else if (EQ (keyword
, QCinherit
))
3656 if (SYMBOLP (value
))
3657 to
[LFACE_INHERIT_INDEX
] = value
;
3661 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
3662 if (!SYMBOLP (XCAR (tail
)))
3665 to
[LFACE_INHERIT_INDEX
] = value
;
3667 add_to_log ("Invalid face inherit", value
, Qnil
);
3671 add_to_log ("Invalid attribute %s in face property",
3674 prop
= XCDR (XCDR (prop
));
3679 /* This is a list of face specs. Specifications at the
3680 beginning of the list take precedence over later
3681 specifications, so we have to merge starting with the
3682 last specification. */
3683 Lisp_Object next
= XCDR (prop
);
3685 merge_face_vector_with_property (f
, to
, next
);
3686 merge_face_vector_with_property (f
, to
, first
);
3691 /* PROP ought to be a face name. */
3692 Lisp_Object lface
= lface_from_face_name (f
, prop
, 0);
3694 add_to_log ("Invalid face text property value: %s", prop
, Qnil
);
3696 merge_face_vectors (f
, XVECTOR (lface
)->contents
, to
, Qnil
);
3701 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3702 Sinternal_make_lisp_face
, 1, 2, 0,
3703 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3704 If FACE was not known as a face before, create a new one.
3705 If optional argument FRAME is specified, make a frame-local face
3706 for that frame. Otherwise operate on the global face definition.
3707 Value is a vector of face attributes. */)
3709 Lisp_Object face
, frame
;
3711 Lisp_Object global_lface
, lface
;
3715 CHECK_SYMBOL (face
);
3716 global_lface
= lface_from_face_name (NULL
, face
, 0);
3720 CHECK_LIVE_FRAME (frame
);
3722 lface
= lface_from_face_name (f
, face
, 0);
3725 f
= NULL
, lface
= Qnil
;
3727 /* Add a global definition if there is none. */
3728 if (NILP (global_lface
))
3730 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3732 AREF (global_lface
, 0) = Qface
;
3733 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3734 Vface_new_frame_defaults
);
3736 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3737 face id to Lisp face is given by the vector lface_id_to_name.
3738 The mapping from Lisp face to Lisp face id is given by the
3739 property `face' of the Lisp face name. */
3740 if (next_lface_id
== lface_id_to_name_size
)
3742 int new_size
= max (50, 2 * lface_id_to_name_size
);
3743 int sz
= new_size
* sizeof *lface_id_to_name
;
3744 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3745 lface_id_to_name_size
= new_size
;
3748 lface_id_to_name
[next_lface_id
] = face
;
3749 Fput (face
, Qface
, make_number (next_lface_id
));
3753 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3754 AREF (global_lface
, i
) = Qunspecified
;
3756 /* Add a frame-local definition. */
3761 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3763 AREF (lface
, 0) = Qface
;
3764 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3767 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3768 AREF (lface
, i
) = Qunspecified
;
3771 lface
= global_lface
;
3773 /* Changing a named face means that all realized faces depending on
3774 that face are invalid. Since we cannot tell which realized faces
3775 depend on the face, make sure they are all removed. This is done
3776 by incrementing face_change_count. The next call to
3777 init_iterator will then free realized faces. */
3778 ++face_change_count
;
3779 ++windows_or_buffers_changed
;
3781 xassert (LFACEP (lface
));
3782 check_lface (lface
);
3787 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3788 Sinternal_lisp_face_p
, 1, 2, 0,
3789 doc
: /* Return non-nil if FACE names a face.
3790 If optional second parameter FRAME is non-nil, check for the
3791 existence of a frame-local face with name FACE on that frame.
3792 Otherwise check for the existence of a global face. */)
3794 Lisp_Object face
, frame
;
3800 CHECK_LIVE_FRAME (frame
);
3801 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3804 lface
= lface_from_face_name (NULL
, face
, 0);
3810 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3811 Sinternal_copy_lisp_face
, 4, 4, 0,
3812 doc
: /* Copy face FROM to TO.
3813 If FRAME it t, copy the global face definition of FROM to the
3814 global face definition of TO. Otherwise, copy the frame-local
3815 definition of FROM on FRAME to the frame-local definition of TO
3816 on NEW-FRAME, or FRAME if NEW-FRAME is nil.
3819 (from
, to
, frame
, new_frame
)
3820 Lisp_Object from
, to
, frame
, new_frame
;
3822 Lisp_Object lface
, copy
;
3824 CHECK_SYMBOL (from
);
3826 if (NILP (new_frame
))
3831 /* Copy global definition of FROM. We don't make copies of
3832 strings etc. because 20.2 didn't do it either. */
3833 lface
= lface_from_face_name (NULL
, from
, 1);
3834 copy
= Finternal_make_lisp_face (to
, Qnil
);
3838 /* Copy frame-local definition of FROM. */
3839 CHECK_LIVE_FRAME (frame
);
3840 CHECK_LIVE_FRAME (new_frame
);
3841 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3842 copy
= Finternal_make_lisp_face (to
, new_frame
);
3845 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3846 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
3848 /* Changing a named face means that all realized faces depending on
3849 that face are invalid. Since we cannot tell which realized faces
3850 depend on the face, make sure they are all removed. This is done
3851 by incrementing face_change_count. The next call to
3852 init_iterator will then free realized faces. */
3853 ++face_change_count
;
3854 ++windows_or_buffers_changed
;
3860 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
3861 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
3862 doc
: /* Set attribute ATTR of FACE to VALUE.
3863 FRAME being a frame means change the face on that frame.
3864 FRAME nil means change the face of the selected frame.
3865 FRAME t means change the default for new frames.
3866 FRAME 0 means change the face on all frames, and change the default
3868 (face
, attr
, value
, frame
)
3869 Lisp_Object face
, attr
, value
, frame
;
3872 Lisp_Object old_value
= Qnil
;
3873 /* Set 1 if ATTR is QCfont. */
3874 int font_attr_p
= 0;
3875 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
3876 int font_related_attr_p
= 0;
3878 CHECK_SYMBOL (face
);
3879 CHECK_SYMBOL (attr
);
3881 face
= resolve_face_name (face
);
3883 /* If FRAME is 0, change face on all frames, and change the
3884 default for new frames. */
3885 if (INTEGERP (frame
) && XINT (frame
) == 0)
3888 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
3889 FOR_EACH_FRAME (tail
, frame
)
3890 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
3894 /* Set lface to the Lisp attribute vector of FACE. */
3896 lface
= lface_from_face_name (NULL
, face
, 1);
3900 frame
= selected_frame
;
3902 CHECK_LIVE_FRAME (frame
);
3903 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3905 /* If a frame-local face doesn't exist yet, create one. */
3907 lface
= Finternal_make_lisp_face (face
, frame
);
3910 if (EQ (attr
, QCfamily
))
3912 if (!UNSPECIFIEDP (value
))
3914 CHECK_STRING (value
);
3915 if (SCHARS (value
) == 0)
3916 signal_error ("Invalid face family", value
);
3918 old_value
= LFACE_FAMILY (lface
);
3919 LFACE_FAMILY (lface
) = value
;
3920 font_related_attr_p
= 1;
3922 else if (EQ (attr
, QCheight
))
3924 if (!UNSPECIFIEDP (value
))
3928 test
= (EQ (face
, Qdefault
)
3930 /* The default face must have an absolute size,
3931 otherwise, we do a test merge with a random
3932 height to see if VALUE's ok. */
3933 : merge_face_heights (value
, make_number (10), Qnil
, Qnil
));
3935 if (!INTEGERP (test
) || XINT (test
) <= 0)
3936 signal_error ("Invalid face height", value
);
3939 old_value
= LFACE_HEIGHT (lface
);
3940 LFACE_HEIGHT (lface
) = value
;
3941 font_related_attr_p
= 1;
3943 else if (EQ (attr
, QCweight
))
3945 if (!UNSPECIFIEDP (value
))
3947 CHECK_SYMBOL (value
);
3948 if (face_numeric_weight (value
) < 0)
3949 signal_error ("Invalid face weight", value
);
3951 old_value
= LFACE_WEIGHT (lface
);
3952 LFACE_WEIGHT (lface
) = value
;
3953 font_related_attr_p
= 1;
3955 else if (EQ (attr
, QCslant
))
3957 if (!UNSPECIFIEDP (value
))
3959 CHECK_SYMBOL (value
);
3960 if (face_numeric_slant (value
) < 0)
3961 signal_error ("Invalid face slant", value
);
3963 old_value
= LFACE_SLANT (lface
);
3964 LFACE_SLANT (lface
) = value
;
3965 font_related_attr_p
= 1;
3967 else if (EQ (attr
, QCunderline
))
3969 if (!UNSPECIFIEDP (value
))
3970 if ((SYMBOLP (value
)
3972 && !EQ (value
, Qnil
))
3973 /* Underline color. */
3975 && SCHARS (value
) == 0))
3976 signal_error ("Invalid face underline", value
);
3978 old_value
= LFACE_UNDERLINE (lface
);
3979 LFACE_UNDERLINE (lface
) = value
;
3981 else if (EQ (attr
, QCoverline
))
3983 if (!UNSPECIFIEDP (value
))
3984 if ((SYMBOLP (value
)
3986 && !EQ (value
, Qnil
))
3987 /* Overline color. */
3989 && SCHARS (value
) == 0))
3990 signal_error ("Invalid face overline", value
);
3992 old_value
= LFACE_OVERLINE (lface
);
3993 LFACE_OVERLINE (lface
) = value
;
3995 else if (EQ (attr
, QCstrike_through
))
3997 if (!UNSPECIFIEDP (value
))
3998 if ((SYMBOLP (value
)
4000 && !EQ (value
, Qnil
))
4001 /* Strike-through color. */
4003 && SCHARS (value
) == 0))
4004 signal_error ("Invalid face strike-through", value
);
4006 old_value
= LFACE_STRIKE_THROUGH (lface
);
4007 LFACE_STRIKE_THROUGH (lface
) = value
;
4009 else if (EQ (attr
, QCbox
))
4013 /* Allow t meaning a simple box of width 1 in foreground color
4016 value
= make_number (1);
4018 if (UNSPECIFIEDP (value
))
4020 else if (NILP (value
))
4022 else if (INTEGERP (value
))
4023 valid_p
= XINT (value
) != 0;
4024 else if (STRINGP (value
))
4025 valid_p
= SCHARS (value
) > 0;
4026 else if (CONSP (value
))
4042 if (EQ (k
, QCline_width
))
4044 if (!INTEGERP (v
) || XINT (v
) == 0)
4047 else if (EQ (k
, QCcolor
))
4049 if (!STRINGP (v
) || SCHARS (v
) == 0)
4052 else if (EQ (k
, QCstyle
))
4054 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4061 valid_p
= NILP (tem
);
4067 signal_error ("Invalid face box", value
);
4069 old_value
= LFACE_BOX (lface
);
4070 LFACE_BOX (lface
) = value
;
4072 else if (EQ (attr
, QCinverse_video
)
4073 || EQ (attr
, QCreverse_video
))
4075 if (!UNSPECIFIEDP (value
))
4077 CHECK_SYMBOL (value
);
4078 if (!EQ (value
, Qt
) && !NILP (value
))
4079 signal_error ("Invalid inverse-video face attribute value", value
);
4081 old_value
= LFACE_INVERSE (lface
);
4082 LFACE_INVERSE (lface
) = value
;
4084 else if (EQ (attr
, QCforeground
))
4086 if (!UNSPECIFIEDP (value
))
4088 /* Don't check for valid color names here because it depends
4089 on the frame (display) whether the color will be valid
4090 when the face is realized. */
4091 CHECK_STRING (value
);
4092 if (SCHARS (value
) == 0)
4093 signal_error ("Empty foreground color value", value
);
4095 old_value
= LFACE_FOREGROUND (lface
);
4096 LFACE_FOREGROUND (lface
) = value
;
4098 else if (EQ (attr
, QCbackground
))
4100 if (!UNSPECIFIEDP (value
))
4102 /* Don't check for valid color names here because it depends
4103 on the frame (display) whether the color will be valid
4104 when the face is realized. */
4105 CHECK_STRING (value
);
4106 if (SCHARS (value
) == 0)
4107 signal_error ("Empty background color value", value
);
4109 old_value
= LFACE_BACKGROUND (lface
);
4110 LFACE_BACKGROUND (lface
) = value
;
4112 else if (EQ (attr
, QCstipple
))
4114 #ifdef HAVE_X_WINDOWS
4115 if (!UNSPECIFIEDP (value
)
4117 && NILP (Fbitmap_spec_p (value
)))
4118 signal_error ("Invalid stipple attribute", value
);
4119 old_value
= LFACE_STIPPLE (lface
);
4120 LFACE_STIPPLE (lface
) = value
;
4121 #endif /* HAVE_X_WINDOWS */
4123 else if (EQ (attr
, QCwidth
))
4125 if (!UNSPECIFIEDP (value
))
4127 CHECK_SYMBOL (value
);
4128 if (face_numeric_swidth (value
) < 0)
4129 signal_error ("Invalid face width", value
);
4131 old_value
= LFACE_SWIDTH (lface
);
4132 LFACE_SWIDTH (lface
) = value
;
4133 font_related_attr_p
= 1;
4135 else if (EQ (attr
, QCfont
))
4137 #ifdef HAVE_WINDOW_SYSTEM
4138 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4140 /* Set font-related attributes of the Lisp face from an XLFD
4146 f
= SELECTED_FRAME ();
4148 f
= check_x_frame (frame
);
4150 if (!UNSPECIFIEDP (value
))
4152 CHECK_STRING (value
);
4154 /* VALUE may be a fontset name or an alias of fontset. In
4155 such a case, use the base fontset name. */
4156 tmp
= Fquery_fontset (value
, Qnil
);
4160 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4161 signal_error ("Invalid font or fontset name", value
);
4166 #endif /* HAVE_WINDOW_SYSTEM */
4168 else if (EQ (attr
, QCinherit
))
4171 if (SYMBOLP (value
))
4174 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4175 if (!SYMBOLP (XCAR (tail
)))
4178 LFACE_INHERIT (lface
) = value
;
4180 signal_error ("Invalid face inheritance", value
);
4182 else if (EQ (attr
, QCbold
))
4184 old_value
= LFACE_WEIGHT (lface
);
4185 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4186 font_related_attr_p
= 1;
4188 else if (EQ (attr
, QCitalic
))
4190 old_value
= LFACE_SLANT (lface
);
4191 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4192 font_related_attr_p
= 1;
4195 signal_error ("Invalid face attribute name", attr
);
4197 if (font_related_attr_p
4198 && !UNSPECIFIEDP (value
))
4199 /* If a font-related attribute other than QCfont is specified, the
4200 original `font' attribute nor that of default face is useless
4201 to determine a new font. Thus, we set it to nil so that font
4202 selection mechanism doesn't use it. */
4203 LFACE_FONT (lface
) = Qnil
;
4205 /* Changing a named face means that all realized faces depending on
4206 that face are invalid. Since we cannot tell which realized faces
4207 depend on the face, make sure they are all removed. This is done
4208 by incrementing face_change_count. The next call to
4209 init_iterator will then free realized faces. */
4211 && (EQ (attr
, QCfont
)
4212 || NILP (Fequal (old_value
, value
))))
4214 ++face_change_count
;
4215 ++windows_or_buffers_changed
;
4218 if (!UNSPECIFIEDP (value
)
4219 && NILP (Fequal (old_value
, value
)))
4225 if (EQ (face
, Qdefault
))
4227 #ifdef HAVE_WINDOW_SYSTEM
4228 /* Changed font-related attributes of the `default' face are
4229 reflected in changed `font' frame parameters. */
4231 && (font_related_attr_p
|| font_attr_p
)
4232 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4233 set_font_frame_param (frame
, lface
);
4235 #endif /* HAVE_WINDOW_SYSTEM */
4237 if (EQ (attr
, QCforeground
))
4238 param
= Qforeground_color
;
4239 else if (EQ (attr
, QCbackground
))
4240 param
= Qbackground_color
;
4242 #ifdef HAVE_WINDOW_SYSTEM
4244 else if (EQ (face
, Qscroll_bar
))
4246 /* Changing the colors of `scroll-bar' sets frame parameters
4247 `scroll-bar-foreground' and `scroll-bar-background'. */
4248 if (EQ (attr
, QCforeground
))
4249 param
= Qscroll_bar_foreground
;
4250 else if (EQ (attr
, QCbackground
))
4251 param
= Qscroll_bar_background
;
4253 #endif /* not WINDOWSNT */
4254 else if (EQ (face
, Qborder
))
4256 /* Changing background color of `border' sets frame parameter
4258 if (EQ (attr
, QCbackground
))
4259 param
= Qborder_color
;
4261 else if (EQ (face
, Qcursor
))
4263 /* Changing background color of `cursor' sets frame parameter
4265 if (EQ (attr
, QCbackground
))
4266 param
= Qcursor_color
;
4268 else if (EQ (face
, Qmouse
))
4270 /* Changing background color of `mouse' sets frame parameter
4272 if (EQ (attr
, QCbackground
))
4273 param
= Qmouse_color
;
4275 #endif /* HAVE_WINDOW_SYSTEM */
4276 else if (EQ (face
, Qmenu
))
4278 /* Indicate that we have to update the menu bar when
4279 realizing faces on FRAME. FRAME t change the
4280 default for new frames. We do this by setting
4281 setting the flag in new face caches */
4284 struct frame
*f
= XFRAME (frame
);
4285 if (FRAME_FACE_CACHE (f
) == NULL
)
4286 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4287 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4290 menu_face_changed_default
= 1;
4296 /* Update `default-frame-alist', which is used for new frames. */
4298 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4301 /* Update the current frame's parameters. */
4304 cons
= XCAR (Vparam_value_alist
);
4305 XSETCAR (cons
, param
);
4306 XSETCDR (cons
, value
);
4307 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4316 #ifdef HAVE_WINDOW_SYSTEM
4318 /* Set the `font' frame parameter of FRAME determined from `default'
4319 face attributes LFACE. If a face or fontset name is explicitely
4320 specfied in LFACE, use it as is. Otherwise, determine a font name
4321 from the other font-related atrributes of LFACE. In that case, if
4322 there's no matching font, signals an error. */
4325 set_font_frame_param (frame
, lface
)
4326 Lisp_Object frame
, lface
;
4328 struct frame
*f
= XFRAME (frame
);
4330 if (FRAME_WINDOW_P (f
))
4332 Lisp_Object font_name
;
4335 if (STRINGP (LFACE_FONT (lface
)))
4336 font_name
= LFACE_FONT (lface
);
4339 /* Choose a font name that reflects LFACE's attributes and has
4340 the registry and encoding pattern specified in the default
4341 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4342 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4344 error ("No font matches the specified attribute");
4345 font_name
= build_string (font
);
4349 f
->default_face_done_p
= 0;
4350 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4355 /* Update the corresponding face when frame parameter PARAM on frame F
4356 has been assigned the value NEW_VALUE. */
4359 update_face_from_frame_parameter (f
, param
, new_value
)
4361 Lisp_Object param
, new_value
;
4365 /* If there are no faces yet, give up. This is the case when called
4366 from Fx_create_frame, and we do the necessary things later in
4367 face-set-after-frame-defaults. */
4368 if (NILP (f
->face_alist
))
4371 /* Changing a named face means that all realized faces depending on
4372 that face are invalid. Since we cannot tell which realized faces
4373 depend on the face, make sure they are all removed. This is done
4374 by incrementing face_change_count. The next call to
4375 init_iterator will then free realized faces. */
4376 ++face_change_count
;
4377 ++windows_or_buffers_changed
;
4379 if (EQ (param
, Qforeground_color
))
4381 lface
= lface_from_face_name (f
, Qdefault
, 1);
4382 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4383 ? new_value
: Qunspecified
);
4384 realize_basic_faces (f
);
4386 else if (EQ (param
, Qbackground_color
))
4390 /* Changing the background color might change the background
4391 mode, so that we have to load new defface specs. Call
4392 frame-update-face-colors to do that. */
4393 XSETFRAME (frame
, f
);
4394 call1 (Qframe_update_face_colors
, frame
);
4396 lface
= lface_from_face_name (f
, Qdefault
, 1);
4397 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4398 ? new_value
: Qunspecified
);
4399 realize_basic_faces (f
);
4401 if (EQ (param
, Qborder_color
))
4403 lface
= lface_from_face_name (f
, Qborder
, 1);
4404 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4405 ? new_value
: Qunspecified
);
4407 else if (EQ (param
, Qcursor_color
))
4409 lface
= lface_from_face_name (f
, Qcursor
, 1);
4410 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4411 ? new_value
: Qunspecified
);
4413 else if (EQ (param
, Qmouse_color
))
4415 lface
= lface_from_face_name (f
, Qmouse
, 1);
4416 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4417 ? new_value
: Qunspecified
);
4422 /* Get the value of X resource RESOURCE, class CLASS for the display
4423 of frame FRAME. This is here because ordinary `x-get-resource'
4424 doesn't take a frame argument. */
4426 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4427 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4428 (resource
, class, frame
)
4429 Lisp_Object resource
, class, frame
;
4431 Lisp_Object value
= Qnil
;
4432 CHECK_STRING (resource
);
4433 CHECK_STRING (class);
4434 CHECK_LIVE_FRAME (frame
);
4436 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4437 resource
, class, Qnil
, Qnil
);
4443 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4444 If VALUE is "on" or "true", return t. If VALUE is "off" or
4445 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4446 error; if SIGNAL_P is zero, return 0. */
4449 face_boolean_x_resource_value (value
, signal_p
)
4453 Lisp_Object result
= make_number (0);
4455 xassert (STRINGP (value
));
4457 if (xstricmp (SDATA (value
), "on") == 0
4458 || xstricmp (SDATA (value
), "true") == 0)
4460 else if (xstricmp (SDATA (value
), "off") == 0
4461 || xstricmp (SDATA (value
), "false") == 0)
4463 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4464 result
= Qunspecified
;
4466 signal_error ("Invalid face attribute value from X resource", value
);
4472 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4473 Finternal_set_lisp_face_attribute_from_resource
,
4474 Sinternal_set_lisp_face_attribute_from_resource
,
4475 3, 4, 0, doc
: /* */)
4476 (face
, attr
, value
, frame
)
4477 Lisp_Object face
, attr
, value
, frame
;
4479 CHECK_SYMBOL (face
);
4480 CHECK_SYMBOL (attr
);
4481 CHECK_STRING (value
);
4483 if (xstricmp (SDATA (value
), "unspecified") == 0)
4484 value
= Qunspecified
;
4485 else if (EQ (attr
, QCheight
))
4487 value
= Fstring_to_number (value
, make_number (10));
4488 if (XINT (value
) <= 0)
4489 signal_error ("Invalid face height from X resource", value
);
4491 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4492 value
= face_boolean_x_resource_value (value
, 1);
4493 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4494 value
= intern (SDATA (value
));
4495 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4496 value
= face_boolean_x_resource_value (value
, 1);
4497 else if (EQ (attr
, QCunderline
)
4498 || EQ (attr
, QCoverline
)
4499 || EQ (attr
, QCstrike_through
))
4501 Lisp_Object boolean_value
;
4503 /* If the result of face_boolean_x_resource_value is t or nil,
4504 VALUE does NOT specify a color. */
4505 boolean_value
= face_boolean_x_resource_value (value
, 0);
4506 if (SYMBOLP (boolean_value
))
4507 value
= boolean_value
;
4509 else if (EQ (attr
, QCbox
))
4510 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4512 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4515 #endif /* HAVE_WINDOW_SYSTEM */
4518 /***********************************************************************
4520 ***********************************************************************/
4522 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4524 /* Make menus on frame F appear as specified by the `menu' face. */
4527 x_update_menu_appearance (f
)
4530 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4534 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4538 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4539 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4540 const char *myname
= SDATA (Vx_resource_name
);
4543 const char *popup_path
= "popup_menu";
4545 const char *popup_path
= "menu.popup";
4548 if (STRINGP (LFACE_FOREGROUND (lface
)))
4550 sprintf (line
, "%s.%s*foreground: %s",
4552 SDATA (LFACE_FOREGROUND (lface
)));
4553 XrmPutLineResource (&rdb
, line
);
4554 sprintf (line
, "%s.pane.menubar*foreground: %s",
4555 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4556 XrmPutLineResource (&rdb
, line
);
4560 if (STRINGP (LFACE_BACKGROUND (lface
)))
4562 sprintf (line
, "%s.%s*background: %s",
4564 SDATA (LFACE_BACKGROUND (lface
)));
4565 XrmPutLineResource (&rdb
, line
);
4566 sprintf (line
, "%s.pane.menubar*background: %s",
4567 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4568 XrmPutLineResource (&rdb
, line
);
4573 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4574 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4575 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4576 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4577 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4578 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4581 const char *suffix
= "List";
4583 const char *suffix
= "";
4585 sprintf (line
, "%s.pane.menubar*font%s: %s",
4586 myname
, suffix
, face
->font_name
);
4587 XrmPutLineResource (&rdb
, line
);
4588 sprintf (line
, "%s.%s*font%s: %s",
4589 myname
, popup_path
, suffix
, face
->font_name
);
4590 XrmPutLineResource (&rdb
, line
);
4594 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4595 free_frame_menubar (f
);
4599 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4602 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4603 Sface_attribute_relative_p
,
4605 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4607 Lisp_Object attribute
, value
;
4609 if (EQ (value
, Qunspecified
))
4611 else if (EQ (attribute
, QCheight
))
4612 return INTEGERP (value
) ? Qnil
: Qt
;
4617 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4619 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4620 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4621 the result will be absolute, otherwise it will be relative. */)
4622 (attribute
, value1
, value2
)
4623 Lisp_Object attribute
, value1
, value2
;
4625 if (EQ (value1
, Qunspecified
))
4627 else if (EQ (attribute
, QCheight
))
4628 return merge_face_heights (value1
, value2
, value1
, Qnil
);
4634 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4635 Sinternal_get_lisp_face_attribute
,
4637 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4638 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4639 face attribute name, signal an error.
4640 If the optional argument FRAME is given, report on face FACE in that
4641 frame. If FRAME is t, report on the defaults for face FACE (for new
4642 frames). If FRAME is omitted or nil, use the selected frame. */)
4643 (symbol
, keyword
, frame
)
4644 Lisp_Object symbol
, keyword
, frame
;
4646 Lisp_Object lface
, value
= Qnil
;
4648 CHECK_SYMBOL (symbol
);
4649 CHECK_SYMBOL (keyword
);
4652 lface
= lface_from_face_name (NULL
, symbol
, 1);
4656 frame
= selected_frame
;
4657 CHECK_LIVE_FRAME (frame
);
4658 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4661 if (EQ (keyword
, QCfamily
))
4662 value
= LFACE_FAMILY (lface
);
4663 else if (EQ (keyword
, QCheight
))
4664 value
= LFACE_HEIGHT (lface
);
4665 else if (EQ (keyword
, QCweight
))
4666 value
= LFACE_WEIGHT (lface
);
4667 else if (EQ (keyword
, QCslant
))
4668 value
= LFACE_SLANT (lface
);
4669 else if (EQ (keyword
, QCunderline
))
4670 value
= LFACE_UNDERLINE (lface
);
4671 else if (EQ (keyword
, QCoverline
))
4672 value
= LFACE_OVERLINE (lface
);
4673 else if (EQ (keyword
, QCstrike_through
))
4674 value
= LFACE_STRIKE_THROUGH (lface
);
4675 else if (EQ (keyword
, QCbox
))
4676 value
= LFACE_BOX (lface
);
4677 else if (EQ (keyword
, QCinverse_video
)
4678 || EQ (keyword
, QCreverse_video
))
4679 value
= LFACE_INVERSE (lface
);
4680 else if (EQ (keyword
, QCforeground
))
4681 value
= LFACE_FOREGROUND (lface
);
4682 else if (EQ (keyword
, QCbackground
))
4683 value
= LFACE_BACKGROUND (lface
);
4684 else if (EQ (keyword
, QCstipple
))
4685 value
= LFACE_STIPPLE (lface
);
4686 else if (EQ (keyword
, QCwidth
))
4687 value
= LFACE_SWIDTH (lface
);
4688 else if (EQ (keyword
, QCinherit
))
4689 value
= LFACE_INHERIT (lface
);
4690 else if (EQ (keyword
, QCfont
))
4691 value
= LFACE_FONT (lface
);
4693 signal_error ("Invalid face attribute name", keyword
);
4699 DEFUN ("internal-lisp-face-attribute-values",
4700 Finternal_lisp_face_attribute_values
,
4701 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4702 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4703 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4707 Lisp_Object result
= Qnil
;
4709 CHECK_SYMBOL (attr
);
4711 if (EQ (attr
, QCweight
)
4712 || EQ (attr
, QCslant
)
4713 || EQ (attr
, QCwidth
))
4715 /* Extract permissible symbols from tables. */
4716 struct table_entry
*table
;
4719 if (EQ (attr
, QCweight
))
4720 table
= weight_table
, dim
= DIM (weight_table
);
4721 else if (EQ (attr
, QCslant
))
4722 table
= slant_table
, dim
= DIM (slant_table
);
4724 table
= swidth_table
, dim
= DIM (swidth_table
);
4726 for (i
= 0; i
< dim
; ++i
)
4728 Lisp_Object symbol
= *table
[i
].symbol
;
4729 Lisp_Object tail
= result
;
4732 && !EQ (XCAR (tail
), symbol
))
4736 result
= Fcons (symbol
, result
);
4739 else if (EQ (attr
, QCunderline
))
4740 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4741 else if (EQ (attr
, QCoverline
))
4742 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4743 else if (EQ (attr
, QCstrike_through
))
4744 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4745 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4746 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4752 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4753 Sinternal_merge_in_global_face
, 2, 2, 0,
4754 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4755 Default face attributes override any local face attributes. */)
4757 Lisp_Object face
, frame
;
4760 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4762 CHECK_LIVE_FRAME (frame
);
4763 global_lface
= lface_from_face_name (NULL
, face
, 1);
4764 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4765 if (NILP (local_lface
))
4766 local_lface
= Finternal_make_lisp_face (face
, frame
);
4768 /* Make every specified global attribute override the local one.
4769 BEWARE!! This is only used from `face-set-after-frame-default' where
4770 the local frame is defined from default specs in `face-defface-spec'
4771 and those should be overridden by global settings. Hence the strange
4772 "global before local" priority. */
4773 lvec
= XVECTOR (local_lface
)->contents
;
4774 gvec
= XVECTOR (global_lface
)->contents
;
4775 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4776 if (! UNSPECIFIEDP (gvec
[i
]))
4783 /* The following function is implemented for compatibility with 20.2.
4784 The function is used in x-resolve-fonts when it is asked to
4785 return fonts with the same size as the font of a face. This is
4786 done in fontset.el. */
4788 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4789 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4790 If the optional argument FRAME is given, report on face FACE in that frame.
4791 If FRAME is t, report on the defaults for face FACE (for new frames).
4792 The font default for a face is either nil, or a list
4793 of the form (bold), (italic) or (bold italic).
4794 If FRAME is omitted or nil, use the selected frame. */)
4796 Lisp_Object face
, frame
;
4800 Lisp_Object result
= Qnil
;
4801 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4803 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4804 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4805 result
= Fcons (Qbold
, result
);
4807 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4808 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4809 result
= Fcons (Qitalic
, result
);
4815 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4816 int face_id
= lookup_named_face (f
, face
, 0);
4817 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4818 return face
? build_string (face
->font_name
) : Qnil
;
4823 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
4824 all attributes are `equal'. Tries to be fast because this function
4825 is called quite often. */
4828 lface_equal_p (v1
, v2
)
4829 Lisp_Object
*v1
, *v2
;
4833 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
4835 Lisp_Object a
= v1
[i
];
4836 Lisp_Object b
= v2
[i
];
4838 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
4839 and the other is specified. */
4840 equal_p
= XTYPE (a
) == XTYPE (b
);
4849 equal_p
= ((SBYTES (a
)
4851 && bcmp (SDATA (a
), SDATA (b
),
4861 equal_p
= !NILP (Fequal (a
, b
));
4871 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
4872 Sinternal_lisp_face_equal_p
, 2, 3, 0,
4873 doc
: /* True if FACE1 and FACE2 are equal.
4874 If the optional argument FRAME is given, report on face FACE in that frame.
4875 If FRAME is t, report on the defaults for face FACE (for new frames).
4876 If FRAME is omitted or nil, use the selected frame. */)
4877 (face1
, face2
, frame
)
4878 Lisp_Object face1
, face2
, frame
;
4882 Lisp_Object lface1
, lface2
;
4887 /* Don't use check_x_frame here because this function is called
4888 before X frames exist. At that time, if FRAME is nil,
4889 selected_frame will be used which is the frame dumped with
4890 Emacs. That frame is not an X frame. */
4891 f
= frame_or_selected_frame (frame
, 2);
4893 lface1
= lface_from_face_name (NULL
, face1
, 1);
4894 lface2
= lface_from_face_name (NULL
, face2
, 1);
4895 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
4896 XVECTOR (lface2
)->contents
);
4897 return equal_p
? Qt
: Qnil
;
4901 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
4902 Sinternal_lisp_face_empty_p
, 1, 2, 0,
4903 doc
: /* True if FACE has no attribute specified.
4904 If the optional argument FRAME is given, report on face FACE in that frame.
4905 If FRAME is t, report on the defaults for face FACE (for new frames).
4906 If FRAME is omitted or nil, use the selected frame. */)
4908 Lisp_Object face
, frame
;
4915 frame
= selected_frame
;
4916 CHECK_LIVE_FRAME (frame
);
4920 lface
= lface_from_face_name (NULL
, face
, 1);
4922 lface
= lface_from_face_name (f
, face
, 1);
4924 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4925 if (!UNSPECIFIEDP (AREF (lface
, i
)))
4928 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
4932 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
4934 doc
: /* Return an alist of frame-local faces defined on FRAME.
4935 For internal use only. */)
4939 struct frame
*f
= frame_or_selected_frame (frame
, 0);
4940 return f
->face_alist
;
4944 /* Return a hash code for Lisp string STRING with case ignored. Used
4945 below in computing a hash value for a Lisp face. */
4947 static INLINE
unsigned
4948 hash_string_case_insensitive (string
)
4951 const unsigned char *s
;
4953 xassert (STRINGP (string
));
4954 for (s
= SDATA (string
); *s
; ++s
)
4955 hash
= (hash
<< 1) ^ tolower (*s
);
4960 /* Return a hash code for face attribute vector V. */
4962 static INLINE
unsigned
4966 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
4967 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
4968 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
4969 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
4970 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
4971 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
4972 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
4976 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
4977 considering charsets/registries). They do if they specify the same
4978 family, point size, weight, width, slant, and fontset. Both LFACE1
4979 and LFACE2 must be fully-specified. */
4982 lface_same_font_attributes_p (lface1
, lface2
)
4983 Lisp_Object
*lface1
, *lface2
;
4985 xassert (lface_fully_specified_p (lface1
)
4986 && lface_fully_specified_p (lface2
));
4987 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
4988 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
4989 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
4990 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
4991 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
4992 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
4993 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
4994 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
4995 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
4996 && STRINGP (lface2
[LFACE_FONT_INDEX
])
4997 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
4998 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5003 /***********************************************************************
5005 ***********************************************************************/
5007 /* Allocate and return a new realized face for Lisp face attribute
5010 static struct face
*
5011 make_realized_face (attr
)
5014 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5015 bzero (face
, sizeof *face
);
5016 face
->ascii_face
= face
;
5017 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5022 /* Free realized face FACE, including its X resources. FACE may
5026 free_realized_face (f
, face
)
5032 #ifdef HAVE_WINDOW_SYSTEM
5033 if (FRAME_WINDOW_P (f
))
5035 /* Free fontset of FACE if it is ASCII face. */
5036 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5037 free_face_fontset (f
, face
);
5040 x_free_gc (f
, face
->gc
);
5044 free_face_colors (f
, face
);
5045 x_destroy_bitmap (f
, face
->stipple
);
5047 #endif /* HAVE_WINDOW_SYSTEM */
5054 /* Prepare face FACE for subsequent display on frame F. This
5055 allocated GCs if they haven't been allocated yet or have been freed
5056 by clearing the face cache. */
5059 prepare_face_for_display (f
, face
)
5063 #ifdef HAVE_WINDOW_SYSTEM
5064 xassert (FRAME_WINDOW_P (f
));
5069 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5071 xgcv
.foreground
= face
->foreground
;
5072 xgcv
.background
= face
->background
;
5073 #ifdef HAVE_X_WINDOWS
5074 xgcv
.graphics_exposures
= False
;
5076 /* The font of FACE may be null if we couldn't load it. */
5079 #ifdef HAVE_X_WINDOWS
5080 xgcv
.font
= face
->font
->fid
;
5083 xgcv
.font
= face
->font
;
5086 xgcv
.font
= face
->font
;
5092 #ifdef HAVE_X_WINDOWS
5095 xgcv
.fill_style
= FillOpaqueStippled
;
5096 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5097 mask
|= GCFillStyle
| GCStipple
;
5100 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5103 #endif /* HAVE_WINDOW_SYSTEM */
5107 /* Returns the `distance' between the colors X and Y. */
5110 color_distance (x
, y
)
5113 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5114 Quoting from that paper:
5116 This formula has results that are very close to L*u*v* (with the
5117 modified lightness curve) and, more importantly, it is a more even
5118 algorithm: it does not have a range of colours where it suddenly
5119 gives far from optimal results.
5121 See <http://www.compuphase.com/cmetric.htm> for more info. */
5123 long r
= (x
->red
- y
->red
) >> 8;
5124 long g
= (x
->green
- y
->green
) >> 8;
5125 long b
= (x
->blue
- y
->blue
) >> 8;
5126 long r_mean
= (x
->red
+ y
->red
) >> 9;
5129 (((512 + r_mean
) * r
* r
) >> 8)
5131 + (((767 - r_mean
) * b
* b
) >> 8);
5135 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5136 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5137 COLOR1 and COLOR2 may be either strings containing the color name,
5138 or lists of the form (RED GREEN BLUE).
5139 If FRAME is unspecified or nil, the current frame is used. */)
5140 (color1
, color2
, frame
)
5141 Lisp_Object color1
, color2
, frame
;
5144 XColor cdef1
, cdef2
;
5147 frame
= selected_frame
;
5148 CHECK_LIVE_FRAME (frame
);
5151 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5152 || !STRINGP (color1
)
5153 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5154 signal_error ("Invalid color", color1
);
5155 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5156 || !STRINGP (color2
)
5157 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5158 signal_error ("Invalid color", color2
);
5160 return make_number (color_distance (&cdef1
, &cdef2
));
5164 /***********************************************************************
5165 Face capability testing for ttys
5166 ***********************************************************************/
5169 /* If the distance (as returned by color_distance) between two colors is
5170 less than this, then they are considered the same, for determining
5171 whether a color is supported or not. The range of values is 0-65535. */
5173 #define TTY_SAME_COLOR_THRESHOLD 10000
5176 DEFUN ("tty-supports-face-attributes-p",
5177 Ftty_supports_face_attributes_p
, Stty_supports_face_attributes_p
,
5179 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
5180 The optional argument FRAME is the frame on which to test; if it is nil
5181 or unspecified, then the current frame is used. If FRAME is not a tty
5182 frame, then nil is returned.
5184 The definition of `supported' is somewhat heuristic, but basically means
5185 that a face containing all the attributes in ATTRIBUTES, when merged
5186 with the default face for display, can be represented in a way that's
5188 \(1) different in appearance than the default face, and
5189 \(2) `close in spirit' to what the attributes specify, if not exact.
5191 Point (2) implies that a `:weight black' attribute will be satisified
5192 by any terminal that can display bold, and a `:foreground "yellow"' as
5193 long as the terminal can display a yellowish color, but `:slant italic'
5194 will _not_ be satisified by the tty display code's automatic
5195 substitution of a `dim' face for italic. */)
5197 Lisp_Object attributes
, frame
;
5201 Lisp_Object val
, fg
, bg
;
5202 XColor fg_tty_color
, fg_std_color
;
5203 XColor bg_tty_color
, bg_std_color
;
5204 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5205 unsigned test_caps
= 0;
5208 frame
= selected_frame
;
5209 CHECK_LIVE_FRAME (frame
);
5212 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
5213 attrs
[i
] = Qunspecified
;
5214 merge_face_vector_with_property (f
, attrs
, attributes
);
5216 /* This function only works on ttys. */
5217 if (!FRAME_TERMCAP_P (f
) && !FRAME_MSDOS_P (f
))
5220 /* First check some easy-to-check stuff; ttys support none of the
5221 following attributes, so we can just return nil if any are requested. */
5224 val
= attrs
[LFACE_STIPPLE_INDEX
];
5225 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5229 val
= attrs
[LFACE_HEIGHT_INDEX
];
5230 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5234 val
= attrs
[LFACE_SWIDTH_INDEX
];
5235 if (!UNSPECIFIEDP (val
) && !NILP (val
)
5236 && face_numeric_swidth (val
) != XLFD_SWIDTH_MEDIUM
)
5240 val
= attrs
[LFACE_OVERLINE_INDEX
];
5241 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5244 /* strike-through */
5245 val
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
5246 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5250 val
= attrs
[LFACE_BOX_INDEX
];
5251 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5254 /* slant (italics/oblique); We consider any non-default value
5255 unsupportable on ttys, even though the face code actually `fakes'
5256 them using a dim attribute if possible. This is because the faked
5257 result is too different from what the face specifies. */
5258 val
= attrs
[LFACE_SLANT_INDEX
];
5259 if (!UNSPECIFIEDP (val
) && !NILP (val
)
5260 && face_numeric_slant (val
) != XLFD_SLANT_ROMAN
)
5264 /* Test for terminal `capabilities' (non-color character attributes). */
5266 /* font weight (bold/dim) */
5267 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
5270 if (weight
> XLFD_WEIGHT_MEDIUM
)
5271 test_caps
= TTY_CAP_BOLD
;
5272 else if (weight
< XLFD_WEIGHT_MEDIUM
)
5273 test_caps
= TTY_CAP_DIM
;
5277 val
= attrs
[LFACE_UNDERLINE_INDEX
];
5278 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5281 return Qnil
; /* ttys don't support colored underlines */
5283 test_caps
|= TTY_CAP_UNDERLINE
;
5287 val
= attrs
[LFACE_INVERSE_INDEX
];
5288 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5289 test_caps
|= TTY_CAP_INVERSE
;
5292 /* Color testing. */
5294 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
5295 we use them when calling `tty_capable_p' below, even if the face
5296 specifies no colors. */
5297 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
5298 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
5300 /* Check if foreground color is close enough. */
5301 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
5304 if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
5306 else if (color_distance (&fg_tty_color
, &fg_std_color
)
5307 > TTY_SAME_COLOR_THRESHOLD
)
5311 /* Check if background color is close enough. */
5312 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
5315 if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
5317 else if (color_distance (&bg_tty_color
, &bg_std_color
)
5318 > TTY_SAME_COLOR_THRESHOLD
)
5322 /* If both foreground and background are requested, see if the
5323 distance between them is OK. We just check to see if the distance
5324 between the tty's foreground and background is close enough to the
5325 distance between the standard foreground and background. */
5326 if (STRINGP (fg
) && STRINGP (bg
))
5329 = (color_distance (&fg_std_color
, &bg_std_color
)
5330 - color_distance (&fg_tty_color
, &bg_tty_color
));
5331 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
5332 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
5337 /* See if the capabilities we selected above are supported, with the
5339 if (test_caps
!= 0 &&
5340 ! tty_capable_p (f
, test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
5344 /* Hmmm, everything checks out, this terminal must support this face. */
5350 /***********************************************************************
5352 ***********************************************************************/
5354 /* Return a new face cache for frame F. */
5356 static struct face_cache
*
5360 struct face_cache
*c
;
5363 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5364 bzero (c
, sizeof *c
);
5365 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5366 c
->buckets
= (struct face
**) xmalloc (size
);
5367 bzero (c
->buckets
, size
);
5369 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5371 c
->menu_face_changed_p
= menu_face_changed_default
;
5376 /* Clear out all graphics contexts for all realized faces, except for
5377 the basic faces. This should be done from time to time just to avoid
5378 keeping too many graphics contexts that are no longer needed. */
5382 struct face_cache
*c
;
5384 if (c
&& FRAME_WINDOW_P (c
->f
))
5386 #ifdef HAVE_WINDOW_SYSTEM
5388 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5390 struct face
*face
= c
->faces_by_id
[i
];
5391 if (face
&& face
->gc
)
5393 x_free_gc (c
->f
, face
->gc
);
5397 #endif /* HAVE_WINDOW_SYSTEM */
5402 /* Free all realized faces in face cache C, including basic faces. C
5403 may be null. If faces are freed, make sure the frame's current
5404 matrix is marked invalid, so that a display caused by an expose
5405 event doesn't try to use faces we destroyed. */
5408 free_realized_faces (c
)
5409 struct face_cache
*c
;
5414 struct frame
*f
= c
->f
;
5416 /* We must block input here because we can't process X events
5417 safely while only some faces are freed, or when the frame's
5418 current matrix still references freed faces. */
5421 for (i
= 0; i
< c
->used
; ++i
)
5423 free_realized_face (f
, c
->faces_by_id
[i
]);
5424 c
->faces_by_id
[i
] = NULL
;
5428 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5429 bzero (c
->buckets
, size
);
5431 /* Must do a thorough redisplay the next time. Mark current
5432 matrices as invalid because they will reference faces freed
5433 above. This function is also called when a frame is
5434 destroyed. In this case, the root window of F is nil. */
5435 if (WINDOWP (f
->root_window
))
5437 clear_current_matrices (f
);
5438 ++windows_or_buffers_changed
;
5446 /* Free all faces realized for multibyte characters on frame F that
5450 free_realized_multibyte_face (f
, fontset
)
5454 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5458 /* We must block input here because we can't process X events safely
5459 while only some faces are freed, or when the frame's current
5460 matrix still references freed faces. */
5463 for (i
= 0; i
< cache
->used
; i
++)
5465 face
= cache
->faces_by_id
[i
];
5467 && face
!= face
->ascii_face
5468 && face
->fontset
== fontset
)
5470 uncache_face (cache
, face
);
5471 free_realized_face (f
, face
);
5475 /* Must do a thorough redisplay the next time. Mark current
5476 matrices as invalid because they will reference faces freed
5477 above. This function is also called when a frame is destroyed.
5478 In this case, the root window of F is nil. */
5479 if (WINDOWP (f
->root_window
))
5481 clear_current_matrices (f
);
5482 ++windows_or_buffers_changed
;
5489 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5490 This is done after attributes of a named face have been changed,
5491 because we can't tell which realized faces depend on that face. */
5494 free_all_realized_faces (frame
)
5500 FOR_EACH_FRAME (rest
, frame
)
5501 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5504 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5508 /* Free face cache C and faces in it, including their X resources. */
5512 struct face_cache
*c
;
5516 free_realized_faces (c
);
5518 xfree (c
->faces_by_id
);
5524 /* Cache realized face FACE in face cache C. HASH is the hash value
5525 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5526 collision list of the face hash table of C. This is done because
5527 otherwise lookup_face would find FACE for every character, even if
5528 faces with the same attributes but for specific characters exist. */
5531 cache_face (c
, face
, hash
)
5532 struct face_cache
*c
;
5536 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5540 if (face
->fontset
>= 0)
5542 struct face
*last
= c
->buckets
[i
];
5553 c
->buckets
[i
] = face
;
5554 face
->prev
= face
->next
= NULL
;
5560 face
->next
= c
->buckets
[i
];
5562 face
->next
->prev
= face
;
5563 c
->buckets
[i
] = face
;
5566 /* Find a free slot in C->faces_by_id and use the index of the free
5567 slot as FACE->id. */
5568 for (i
= 0; i
< c
->used
; ++i
)
5569 if (c
->faces_by_id
[i
] == NULL
)
5573 /* Maybe enlarge C->faces_by_id. */
5574 if (i
== c
->used
&& c
->used
== c
->size
)
5576 int new_size
= 2 * c
->size
;
5577 int sz
= new_size
* sizeof *c
->faces_by_id
;
5578 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5583 /* Check that FACE got a unique id. */
5588 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5589 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5595 #endif /* GLYPH_DEBUG */
5597 c
->faces_by_id
[i
] = face
;
5603 /* Remove face FACE from cache C. */
5606 uncache_face (c
, face
)
5607 struct face_cache
*c
;
5610 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5613 face
->prev
->next
= face
->next
;
5615 c
->buckets
[i
] = face
->next
;
5618 face
->next
->prev
= face
->prev
;
5620 c
->faces_by_id
[face
->id
] = NULL
;
5621 if (face
->id
== c
->used
)
5626 /* Look up a realized face with face attributes ATTR in the face cache
5627 of frame F. The face will be used to display character C. Value
5628 is the ID of the face found. If no suitable face is found, realize
5629 a new one. In that case, if C is a multibyte character, BASE_FACE
5630 is a face that has the same attributes. */
5633 lookup_face (f
, attr
, c
, base_face
)
5637 struct face
*base_face
;
5639 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5644 xassert (cache
!= NULL
);
5645 check_lface_attrs (attr
);
5647 /* Look up ATTR in the face cache. */
5648 hash
= lface_hash (attr
);
5649 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5651 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5652 if (face
->hash
== hash
5653 && (!FRAME_WINDOW_P (f
)
5654 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5655 && lface_equal_p (face
->lface
, attr
))
5658 /* If not found, realize a new face. */
5660 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5663 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5665 /* When this function is called from face_for_char (in this case, C is
5666 a multibyte character), a fontset of a face returned by
5667 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5668 C) is not sutisfied. The fontset is set for this face by
5669 face_for_char later. */
5671 if (FRAME_WINDOW_P (f
))
5672 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5674 #endif /* GLYPH_DEBUG */
5680 /* Return the face id of the realized face for named face SYMBOL on
5681 frame F suitable for displaying character C. Value is -1 if the
5682 face couldn't be determined, which might happen if the default face
5683 isn't realized and cannot be realized. */
5686 lookup_named_face (f
, symbol
, c
)
5691 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5692 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5693 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5695 if (default_face
== NULL
)
5697 if (!realize_basic_faces (f
))
5699 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5702 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5703 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5704 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
5705 return lookup_face (f
, attrs
, c
, NULL
);
5709 /* Return the ID of the realized ASCII face of Lisp face with ID
5710 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5713 ascii_face_of_lisp_face (f
, lface_id
)
5719 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5721 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5722 face_id
= lookup_named_face (f
, face_name
, 0);
5731 /* Return a face for charset ASCII that is like the face with id
5732 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5733 STEPS < 0 means larger. Value is the id of the face. */
5736 smaller_face (f
, face_id
, steps
)
5740 #ifdef HAVE_WINDOW_SYSTEM
5742 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5743 int pt
, last_pt
, last_height
;
5746 struct face
*new_face
;
5748 /* If not called for an X frame, just return the original face. */
5749 if (FRAME_TERMCAP_P (f
))
5752 /* Try in increments of 1/2 pt. */
5753 delta
= steps
< 0 ? 5 : -5;
5754 steps
= abs (steps
);
5756 face
= FACE_FROM_ID (f
, face_id
);
5757 bcopy (face
->lface
, attrs
, sizeof attrs
);
5758 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5759 new_face_id
= face_id
;
5760 last_height
= FONT_HEIGHT (face
->font
);
5764 /* Give up if we cannot find a font within 10pt. */
5765 && abs (last_pt
- pt
) < 100)
5767 /* Look up a face for a slightly smaller/larger font. */
5769 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5770 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5771 new_face
= FACE_FROM_ID (f
, new_face_id
);
5773 /* If height changes, count that as one step. */
5774 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5775 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5778 last_height
= FONT_HEIGHT (new_face
->font
);
5785 #else /* not HAVE_WINDOW_SYSTEM */
5789 #endif /* not HAVE_WINDOW_SYSTEM */
5793 /* Return a face for charset ASCII that is like the face with id
5794 FACE_ID on frame F, but has height HEIGHT. */
5797 face_with_height (f
, face_id
, height
)
5802 #ifdef HAVE_WINDOW_SYSTEM
5804 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5806 if (FRAME_TERMCAP_P (f
)
5810 face
= FACE_FROM_ID (f
, face_id
);
5811 bcopy (face
->lface
, attrs
, sizeof attrs
);
5812 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5813 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5814 #endif /* HAVE_WINDOW_SYSTEM */
5820 /* Return the face id of the realized face for named face SYMBOL on
5821 frame F suitable for displaying character C, and use attributes of
5822 the face FACE_ID for attributes that aren't completely specified by
5823 SYMBOL. This is like lookup_named_face, except that the default
5824 attributes come from FACE_ID, not from the default face. FACE_ID
5825 is assumed to be already realized. */
5828 lookup_derived_face (f
, symbol
, c
, face_id
)
5834 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5835 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5836 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5841 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5842 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5843 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
5844 return lookup_face (f
, attrs
, c
, default_face
);
5847 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5848 Sface_attributes_as_vector
, 1, 1, 0,
5849 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5854 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5856 merge_face_vector_with_property (XFRAME (selected_frame
),
5857 XVECTOR (lface
)->contents
,
5864 /***********************************************************************
5866 ***********************************************************************/
5868 DEFUN ("internal-set-font-selection-order",
5869 Finternal_set_font_selection_order
,
5870 Sinternal_set_font_selection_order
, 1, 1, 0,
5871 doc
: /* Set font selection order for face font selection to ORDER.
5872 ORDER must be a list of length 4 containing the symbols `:width',
5873 `:height', `:weight', and `:slant'. Face attributes appearing
5874 first in ORDER are matched first, e.g. if `:height' appears before
5875 `:weight' in ORDER, font selection first tries to find a font with
5876 a suitable height, and then tries to match the font weight.
5883 int indices
[DIM (font_sort_order
)];
5886 bzero (indices
, sizeof indices
);
5890 CONSP (list
) && i
< DIM (indices
);
5891 list
= XCDR (list
), ++i
)
5893 Lisp_Object attr
= XCAR (list
);
5896 if (EQ (attr
, QCwidth
))
5898 else if (EQ (attr
, QCheight
))
5899 xlfd
= XLFD_POINT_SIZE
;
5900 else if (EQ (attr
, QCweight
))
5902 else if (EQ (attr
, QCslant
))
5907 if (indices
[i
] != 0)
5912 if (!NILP (list
) || i
!= DIM (indices
))
5913 signal_error ("Invalid font sort order", order
);
5914 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
5915 if (indices
[i
] == 0)
5916 signal_error ("Invalid font sort order", order
);
5918 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
5920 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
5921 free_all_realized_faces (Qnil
);
5928 DEFUN ("internal-set-alternative-font-family-alist",
5929 Finternal_set_alternative_font_family_alist
,
5930 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
5931 doc
: /* Define alternative font families to try in face font selection.
5932 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
5933 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
5934 be found. Value is ALIST. */)
5939 Vface_alternative_font_family_alist
= alist
;
5940 free_all_realized_faces (Qnil
);
5945 DEFUN ("internal-set-alternative-font-registry-alist",
5946 Finternal_set_alternative_font_registry_alist
,
5947 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
5948 doc
: /* Define alternative font registries to try in face font selection.
5949 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
5950 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
5951 be found. Value is ALIST. */)
5956 Vface_alternative_font_registry_alist
= alist
;
5957 free_all_realized_faces (Qnil
);
5962 #ifdef HAVE_WINDOW_SYSTEM
5964 /* Value is non-zero if FONT is the name of a scalable font. The
5965 X11R6 XLFD spec says that point size, pixel size, and average width
5966 are zero for scalable fonts. Intlfonts contain at least one
5967 scalable font ("*-muleindian-1") for which this isn't true, so we
5968 just test average width. */
5971 font_scalable_p (font
)
5972 struct font_name
*font
;
5974 char *s
= font
->fields
[XLFD_AVGWIDTH
];
5975 return (*s
== '0' && *(s
+ 1) == '\0')
5977 /* Windows implementation of XLFD is slightly broken for backward
5978 compatibility with previous broken versions, so test for
5979 wildcards as well as 0. */
5986 /* Ignore the difference of font point size less than this value. */
5988 #define FONT_POINT_SIZE_QUANTUM 5
5990 /* Value is non-zero if FONT1 is a better match for font attributes
5991 VALUES than FONT2. VALUES is an array of face attribute values in
5992 font sort order. COMPARE_PT_P zero means don't compare point
5993 sizes. AVGWIDTH, if not zero, is a specified font average width
5997 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
5999 struct font_name
*font1
, *font2
;
6000 int compare_pt_p
, avgwidth
;
6004 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6006 int xlfd_idx
= font_sort_order
[i
];
6008 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6012 if (xlfd_idx
== XLFD_POINT_SIZE
)
6014 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6015 / font1
->rescale_ratio
));
6016 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6017 / font2
->rescale_ratio
));
6018 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6023 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6024 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6027 if (delta1
> delta2
)
6029 else if (delta1
< delta2
)
6033 /* The difference may be equal because, e.g., the face
6034 specifies `italic' but we have only `regular' and
6035 `oblique'. Prefer `oblique' in this case. */
6036 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6037 && font1
->numeric
[xlfd_idx
] > values
[i
]
6038 && font2
->numeric
[xlfd_idx
] < values
[i
])
6046 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6047 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6048 if (delta1
> delta2
)
6050 else if (delta1
< delta2
)
6056 /* We prefer a real scalable font; i.e. not what autoscaled. */
6057 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6058 && font1
->numeric
[XLFD_RESY
] > 0);
6059 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6060 && font2
->numeric
[XLFD_RESY
] > 0);
6062 if (auto_scaled_1
!= auto_scaled_2
)
6063 return auto_scaled_2
;
6066 return font1
->registry_priority
< font2
->registry_priority
;
6070 /* Value is non-zero if FONT is an exact match for face attributes in
6071 SPECIFIED. SPECIFIED is an array of face attribute values in font
6072 sort order. AVGWIDTH, if non-zero, is an average width to compare
6076 exact_face_match_p (specified
, font
, avgwidth
)
6078 struct font_name
*font
;
6083 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6084 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6087 return (i
== DIM (font_sort_order
)
6089 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6093 /* Value is the name of a scaled font, generated from scalable font
6094 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6095 Value is allocated from heap. */
6098 build_scalable_font_name (f
, font
, specified_pt
)
6100 struct font_name
*font
;
6103 char pixel_size
[20];
6105 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6108 /* If scalable font is for a specific resolution, compute
6109 the point size we must specify from the resolution of
6110 the display and the specified resolution of the font. */
6111 if (font
->numeric
[XLFD_RESY
] != 0)
6113 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6114 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
;
6119 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
;
6121 /* We may need a font of the different size. */
6122 pixel_value
*= font
->rescale_ratio
;
6124 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6125 font of the specified PIXEL_SIZE. */
6127 { /* Set point size of the font. */
6128 char point_size
[20];
6129 sprintf (point_size
, "%d", (int) pt
);
6130 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6131 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6135 /* Set pixel size. */
6136 sprintf (pixel_size
, "%d", pixel_value
);
6137 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6138 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6140 /* If font doesn't specify its resolution, use the
6141 resolution of the display. */
6142 if (font
->numeric
[XLFD_RESY
] == 0)
6145 sprintf (buffer
, "%d", (int) resy
);
6146 font
->fields
[XLFD_RESY
] = buffer
;
6147 font
->numeric
[XLFD_RESY
] = resy
;
6150 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6153 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6154 sprintf (buffer
, "%d", resx
);
6155 font
->fields
[XLFD_RESX
] = buffer
;
6156 font
->numeric
[XLFD_RESX
] = resx
;
6159 return build_font_name (font
);
6163 /* Value is non-zero if we are allowed to use scalable font FONT. We
6164 can't run a Lisp function here since this function may be called
6165 with input blocked. */
6168 may_use_scalable_font_p (font
)
6171 if (EQ (Vscalable_fonts_allowed
, Qt
))
6173 else if (CONSP (Vscalable_fonts_allowed
))
6175 Lisp_Object tail
, regexp
;
6177 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6179 regexp
= XCAR (tail
);
6180 if (STRINGP (regexp
)
6181 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6191 /* Return the name of the best matching font for face attributes ATTRS
6192 in the array of font_name structures FONTS which contains NFONTS
6193 elements. WIDTH_RATIO is a factor with which to multiply average
6194 widths if ATTRS specifies such a width.
6196 Value is a font name which is allocated from the heap. FONTS is
6197 freed by this function.
6199 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6200 indicate whether the resulting font should be drawn using overstrike
6201 to simulate bold-face. */
6204 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6207 struct font_name
*fonts
;
6210 int *needs_overstrike
;
6213 struct font_name
*best
;
6216 int exact_p
, avgwidth
;
6221 /* Make specified font attributes available in `specified',
6222 indexed by sort order. */
6223 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6225 int xlfd_idx
= font_sort_order
[i
];
6227 if (xlfd_idx
== XLFD_SWIDTH
)
6228 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6229 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6230 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6231 else if (xlfd_idx
== XLFD_WEIGHT
)
6232 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6233 else if (xlfd_idx
== XLFD_SLANT
)
6234 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6239 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6241 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6245 if (needs_overstrike
)
6246 *needs_overstrike
= 0;
6248 /* Start with the first non-scalable font in the list. */
6249 for (i
= 0; i
< nfonts
; ++i
)
6250 if (!font_scalable_p (fonts
+ i
))
6253 /* Find the best match among the non-scalable fonts. */
6258 for (i
= 1; i
< nfonts
; ++i
)
6259 if (!font_scalable_p (fonts
+ i
)
6260 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6264 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6272 /* Unless we found an exact match among non-scalable fonts, see if
6273 we can find a better match among scalable fonts. */
6276 /* A scalable font is better if
6278 1. its weight, slant, swidth attributes are better, or.
6280 2. the best non-scalable font doesn't have the required
6281 point size, and the scalable fonts weight, slant, swidth
6284 int non_scalable_has_exact_height_p
;
6286 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6287 non_scalable_has_exact_height_p
= 1;
6289 non_scalable_has_exact_height_p
= 0;
6291 for (i
= 0; i
< nfonts
; ++i
)
6292 if (font_scalable_p (fonts
+ i
))
6295 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6296 || (!non_scalable_has_exact_height_p
6297 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6299 non_scalable_has_exact_height_p
= 1;
6304 if (needs_overstrike
)
6306 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6307 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6309 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6311 /* We want a bold font, but didn't get one; try to use
6312 overstriking instead to simulate bold-face. However,
6313 don't overstrike an already-bold fontn unless the
6314 desired weight grossly exceeds the available weight. */
6315 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6316 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6318 *needs_overstrike
= 1;
6323 if (font_scalable_p (best
))
6324 font_name
= build_scalable_font_name (f
, best
, pt
);
6326 font_name
= build_font_name (best
);
6328 /* Free font_name structures. */
6329 free_font_names (fonts
, nfonts
);
6335 /* Get a list of matching fonts on frame F, considering FAMILY
6336 and alternative font families from Vface_alternative_font_registry_alist.
6338 FAMILY is the font family whose alternatives are considered.
6340 REGISTRY, if a string, specifies a font registry and encoding to
6341 match. A value of nil means include fonts of any registry and
6344 Return in *FONTS a pointer to a vector of font_name structures for
6345 the fonts matched. Value is the number of fonts found. */
6348 try_alternative_families (f
, family
, registry
, fonts
)
6350 Lisp_Object family
, registry
;
6351 struct font_name
**fonts
;
6356 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6359 /* Try alternative font families. */
6360 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6363 for (alter
= XCDR (alter
);
6364 CONSP (alter
) && nfonts
== 0;
6365 alter
= XCDR (alter
))
6367 if (STRINGP (XCAR (alter
)))
6368 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6372 /* Try all scalable fonts before giving up. */
6373 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6375 int count
= SPECPDL_INDEX ();
6376 specbind (Qscalable_fonts_allowed
, Qt
);
6377 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6378 unbind_to (count
, Qnil
);
6385 /* Get a list of matching fonts on frame F.
6387 FAMILY, if a string, specifies a font family derived from the fontset.
6388 It is only used if the face does not specify any family in ATTRS or
6389 if we cannot find any font of the face's family.
6391 REGISTRY, if a string, specifies a font registry and encoding to
6392 match. A value of nil means include fonts of any registry and
6395 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6396 Otherwise, prefer FAMILY.
6398 Return in *FONTS a pointer to a vector of font_name structures for
6399 the fonts matched. Value is the number of fonts found. */
6402 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6405 Lisp_Object family
, registry
;
6406 struct font_name
**fonts
;
6407 int prefer_face_family
;
6410 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6411 Lisp_Object try_family
;
6413 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6415 if (STRINGP (try_family
))
6416 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6419 /* When realizing the default face and a font spec does not matched
6420 exactly, Emacs looks for ones with the same registry as the
6421 default font. On the Mac, this is mac-roman, which does not work
6422 if the family is -etl-fixed, e.g. The following widens the
6423 choices and fixes that problem. */
6424 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
)
6425 && xstricmp (SDATA (registry
), "mac-roman") == 0)
6426 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6429 if (EQ (try_family
, family
))
6430 family
= face_family
;
6432 if (nfonts
== 0 && STRINGP (family
))
6433 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6435 /* Try font family of the default face or "fixed". */
6438 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6440 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6442 family
= build_string ("fixed");
6443 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6446 /* Try any family with the given registry. */
6448 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6454 /* Return the fontset id of the base fontset name or alias name given
6455 by the fontset attribute of ATTRS. Value is -1 if the fontset
6456 attribute of ATTRS doesn't name a fontset. */
6459 face_fontset (attrs
)
6464 name
= attrs
[LFACE_FONT_INDEX
];
6465 if (!STRINGP (name
))
6467 return fs_query_fontset (name
, 0);
6471 /* Choose a name of font to use on frame F to display character C with
6472 Lisp face attributes specified by ATTRS. The font name is
6473 determined by the font-related attributes in ATTRS and the name
6474 pattern for C in FONTSET. Value is the font name which is
6475 allocated from the heap and must be freed by the caller, or NULL if
6476 we can get no information about the font name of C. It is assured
6477 that we always get some information for a single byte
6480 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6481 indicate whether the resulting font should be drawn using overstrike
6482 to simulate bold-face. */
6485 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6489 int *needs_overstrike
;
6491 Lisp_Object pattern
;
6492 char *font_name
= NULL
;
6493 struct font_name
*fonts
;
6494 int nfonts
, width_ratio
;
6496 if (needs_overstrike
)
6497 *needs_overstrike
= 0;
6499 /* Get (foundry and) family name and registry (and encoding) name of
6501 pattern
= fontset_font_pattern (f
, fontset
, c
);
6504 xassert (!SINGLE_BYTE_CHAR_P (c
));
6508 /* If what we got is a name pattern, return it. */
6509 if (STRINGP (pattern
))
6510 return xstrdup (SDATA (pattern
));
6512 /* Get a list of fonts matching that pattern and choose the
6513 best match for the specified face attributes from it. */
6514 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6515 (SINGLE_BYTE_CHAR_P (c
)
6516 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6517 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6519 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6520 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6525 #endif /* HAVE_WINDOW_SYSTEM */
6529 /***********************************************************************
6531 ***********************************************************************/
6533 /* Realize basic faces on frame F. Value is zero if frame parameters
6534 of F don't contain enough information needed to realize the default
6538 realize_basic_faces (f
)
6542 int count
= SPECPDL_INDEX ();
6544 /* Block input here so that we won't be surprised by an X expose
6545 event, for instance, without having the faces set up. */
6547 specbind (Qscalable_fonts_allowed
, Qt
);
6549 if (realize_default_face (f
))
6551 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6552 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6553 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6554 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6555 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6556 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6557 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6558 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6559 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6560 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6562 /* Reflect changes in the `menu' face in menu bars. */
6563 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6565 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6566 #ifdef USE_X_TOOLKIT
6567 x_update_menu_appearance (f
);
6574 unbind_to (count
, Qnil
);
6580 /* Realize the default face on frame F. If the face is not fully
6581 specified, make it fully-specified. Attributes of the default face
6582 that are not explicitly specified are taken from frame parameters. */
6585 realize_default_face (f
)
6588 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6590 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6591 Lisp_Object frame_font
;
6594 /* If the `default' face is not yet known, create it. */
6595 lface
= lface_from_face_name (f
, Qdefault
, 0);
6599 XSETFRAME (frame
, f
);
6600 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6604 #ifdef HAVE_WINDOW_SYSTEM
6605 if (FRAME_WINDOW_P (f
))
6607 /* Set frame_font to the value of the `font' frame parameter. */
6608 frame_font
= Fassq (Qfont
, f
->param_alist
);
6609 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
6610 frame_font
= XCDR (frame_font
);
6611 set_lface_from_font_name (f
, lface
, frame_font
,
6612 f
->default_face_done_p
, 1);
6613 f
->default_face_done_p
= 1;
6615 #endif /* HAVE_WINDOW_SYSTEM */
6617 if (!FRAME_WINDOW_P (f
))
6619 LFACE_FAMILY (lface
) = build_string ("default");
6620 LFACE_SWIDTH (lface
) = Qnormal
;
6621 LFACE_HEIGHT (lface
) = make_number (1);
6622 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
6623 LFACE_WEIGHT (lface
) = Qnormal
;
6624 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
6625 LFACE_SLANT (lface
) = Qnormal
;
6626 LFACE_AVGWIDTH (lface
) = Qunspecified
;
6629 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
6630 LFACE_UNDERLINE (lface
) = Qnil
;
6632 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
6633 LFACE_OVERLINE (lface
) = Qnil
;
6635 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
6636 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
6638 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
6639 LFACE_BOX (lface
) = Qnil
;
6641 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
6642 LFACE_INVERSE (lface
) = Qnil
;
6644 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
6646 /* This function is called so early that colors are not yet
6647 set in the frame parameter list. */
6648 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
6650 if (CONSP (color
) && STRINGP (XCDR (color
)))
6651 LFACE_FOREGROUND (lface
) = XCDR (color
);
6652 else if (FRAME_WINDOW_P (f
))
6654 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6655 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
6660 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
6662 /* This function is called so early that colors are not yet
6663 set in the frame parameter list. */
6664 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
6665 if (CONSP (color
) && STRINGP (XCDR (color
)))
6666 LFACE_BACKGROUND (lface
) = XCDR (color
);
6667 else if (FRAME_WINDOW_P (f
))
6669 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6670 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
6675 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
6676 LFACE_STIPPLE (lface
) = Qnil
;
6678 /* Realize the face; it must be fully-specified now. */
6679 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
6680 check_lface (lface
);
6681 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
6682 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
6687 /* Realize basic faces other than the default face in face cache C.
6688 SYMBOL is the face name, ID is the face id the realized face must
6689 have. The default face must have been realized already. */
6692 realize_named_face (f
, symbol
, id
)
6697 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6698 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
6699 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6700 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6701 struct face
*new_face
;
6703 /* The default face must exist and be fully specified. */
6704 get_lface_attributes (f
, Qdefault
, attrs
, 1);
6705 check_lface_attrs (attrs
);
6706 xassert (lface_fully_specified_p (attrs
));
6708 /* If SYMBOL isn't know as a face, create it. */
6712 XSETFRAME (frame
, f
);
6713 lface
= Finternal_make_lisp_face (symbol
, frame
);
6716 /* Merge SYMBOL's face with the default face. */
6717 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
6718 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
6720 /* Realize the face. */
6721 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
6725 /* Realize the fully-specified face with attributes ATTRS in face
6726 cache CACHE for character C. If C is a multibyte character,
6727 BASE_FACE is a face that has the same attributes. Otherwise,
6728 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
6729 ID of face to remove before caching the new face. Value is a
6730 pointer to the newly created realized face. */
6732 static struct face
*
6733 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
6734 struct face_cache
*cache
;
6737 struct face
*base_face
;
6742 /* LFACE must be fully specified. */
6743 xassert (cache
!= NULL
);
6744 check_lface_attrs (attrs
);
6746 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
6748 /* Remove the former face. */
6749 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
6750 uncache_face (cache
, former_face
);
6751 free_realized_face (cache
->f
, former_face
);
6754 if (FRAME_WINDOW_P (cache
->f
))
6755 face
= realize_x_face (cache
, attrs
, c
, base_face
);
6756 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
6757 face
= realize_tty_face (cache
, attrs
, c
);
6761 /* Insert the new face. */
6762 cache_face (cache
, face
, lface_hash (attrs
));
6763 #ifdef HAVE_WINDOW_SYSTEM
6764 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
6765 load_face_font (cache
->f
, face
, c
);
6766 #endif /* HAVE_WINDOW_SYSTEM */
6771 /* Realize the fully-specified face with attributes ATTRS in face
6772 cache CACHE for character C. Do it for X frame CACHE->f. If C is
6773 a multibyte character, BASE_FACE is a face that has the same
6774 attributes. Otherwise, BASE_FACE is ignored. If the new face
6775 doesn't share font with the default face, a fontname is allocated
6776 from the heap and set in `font_name' of the new face, but it is not
6777 yet loaded here. Value is a pointer to the newly created realized
6780 static struct face
*
6781 realize_x_face (cache
, attrs
, c
, base_face
)
6782 struct face_cache
*cache
;
6785 struct face
*base_face
;
6787 #ifdef HAVE_WINDOW_SYSTEM
6788 struct face
*face
, *default_face
;
6790 Lisp_Object stipple
, overline
, strike_through
, box
;
6792 xassert (FRAME_WINDOW_P (cache
->f
));
6793 xassert (SINGLE_BYTE_CHAR_P (c
)
6796 /* Allocate a new realized face. */
6797 face
= make_realized_face (attrs
);
6801 /* If C is a multibyte character, we share all face attirbutes with
6802 BASE_FACE including the realized fontset. But, we must load a
6804 if (!SINGLE_BYTE_CHAR_P (c
))
6806 bcopy (base_face
, face
, sizeof *face
);
6809 /* Don't try to free the colors copied bitwise from BASE_FACE. */
6810 face
->colors_copied_bitwise_p
= 1;
6812 /* to force realize_face to load font */
6817 /* Now we are realizing a face for ASCII (and unibyte) characters. */
6819 /* Determine the font to use. Most of the time, the font will be
6820 the same as the font of the default face, so try that first. */
6821 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6823 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
6824 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
6826 face
->font
= default_face
->font
;
6827 face
->fontset
= default_face
->fontset
;
6828 face
->font_info_id
= default_face
->font_info_id
;
6829 face
->font_name
= default_face
->font_name
;
6830 face
->ascii_face
= face
;
6832 /* But, as we can't share the fontset, make a new realized
6833 fontset that has the same base fontset as of the default
6836 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
6840 /* If the face attribute ATTRS specifies a fontset, use it as
6841 the base of a new realized fontset. Otherwise, use the same
6842 base fontset as of the default face. The base determines
6843 registry and encoding of a font. It may also determine
6844 foundry and family. The other fields of font name pattern
6845 are constructed from ATTRS. */
6846 int fontset
= face_fontset (attrs
);
6848 if ((fontset
== -1) && default_face
)
6849 fontset
= default_face
->fontset
;
6850 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
6851 face
->font
= NULL
; /* to force realize_face to load font */
6854 /* Load colors, and set remaining attributes. */
6856 load_face_colors (f
, face
, attrs
);
6859 box
= attrs
[LFACE_BOX_INDEX
];
6862 /* A simple box of line width 1 drawn in color given by
6864 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
6866 face
->box
= FACE_SIMPLE_BOX
;
6867 face
->box_line_width
= 1;
6869 else if (INTEGERP (box
))
6871 /* Simple box of specified line width in foreground color of the
6873 xassert (XINT (box
) != 0);
6874 face
->box
= FACE_SIMPLE_BOX
;
6875 face
->box_line_width
= XINT (box
);
6876 face
->box_color
= face
->foreground
;
6877 face
->box_color_defaulted_p
= 1;
6879 else if (CONSP (box
))
6881 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
6882 being one of `raised' or `sunken'. */
6883 face
->box
= FACE_SIMPLE_BOX
;
6884 face
->box_color
= face
->foreground
;
6885 face
->box_color_defaulted_p
= 1;
6886 face
->box_line_width
= 1;
6890 Lisp_Object keyword
, value
;
6892 keyword
= XCAR (box
);
6900 if (EQ (keyword
, QCline_width
))
6902 if (INTEGERP (value
) && XINT (value
) != 0)
6903 face
->box_line_width
= XINT (value
);
6905 else if (EQ (keyword
, QCcolor
))
6907 if (STRINGP (value
))
6909 face
->box_color
= load_color (f
, face
, value
,
6911 face
->use_box_color_for_shadows_p
= 1;
6914 else if (EQ (keyword
, QCstyle
))
6916 if (EQ (value
, Qreleased_button
))
6917 face
->box
= FACE_RAISED_BOX
;
6918 else if (EQ (value
, Qpressed_button
))
6919 face
->box
= FACE_SUNKEN_BOX
;
6924 /* Text underline, overline, strike-through. */
6926 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
6928 /* Use default color (same as foreground color). */
6929 face
->underline_p
= 1;
6930 face
->underline_defaulted_p
= 1;
6931 face
->underline_color
= 0;
6933 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
6935 /* Use specified color. */
6936 face
->underline_p
= 1;
6937 face
->underline_defaulted_p
= 0;
6938 face
->underline_color
6939 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
6940 LFACE_UNDERLINE_INDEX
);
6942 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
6944 face
->underline_p
= 0;
6945 face
->underline_defaulted_p
= 0;
6946 face
->underline_color
= 0;
6949 overline
= attrs
[LFACE_OVERLINE_INDEX
];
6950 if (STRINGP (overline
))
6952 face
->overline_color
6953 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
6954 LFACE_OVERLINE_INDEX
);
6955 face
->overline_p
= 1;
6957 else if (EQ (overline
, Qt
))
6959 face
->overline_color
= face
->foreground
;
6960 face
->overline_color_defaulted_p
= 1;
6961 face
->overline_p
= 1;
6964 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
6965 if (STRINGP (strike_through
))
6967 face
->strike_through_color
6968 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
6969 LFACE_STRIKE_THROUGH_INDEX
);
6970 face
->strike_through_p
= 1;
6972 else if (EQ (strike_through
, Qt
))
6974 face
->strike_through_color
= face
->foreground
;
6975 face
->strike_through_color_defaulted_p
= 1;
6976 face
->strike_through_p
= 1;
6979 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
6980 if (!NILP (stipple
))
6981 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
6983 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
6985 #endif /* HAVE_WINDOW_SYSTEM */
6989 /* Map a specified color of face FACE on frame F to a tty color index.
6990 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
6991 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
6992 default foreground/background colors. */
6995 map_tty_color (f
, face
, idx
, defaulted
)
6998 enum lface_attribute_index idx
;
7001 Lisp_Object frame
, color
, def
;
7002 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7003 unsigned long default_pixel
, default_other_pixel
, pixel
;
7005 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7009 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7010 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7014 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7015 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7018 XSETFRAME (frame
, f
);
7019 color
= face
->lface
[idx
];
7023 && CONSP (Vtty_defined_color_alist
)
7024 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7027 /* Associations in tty-defined-color-alist are of the form
7028 (NAME INDEX R G B). We need the INDEX part. */
7029 pixel
= XINT (XCAR (XCDR (def
)));
7032 if (pixel
== default_pixel
&& STRINGP (color
))
7034 pixel
= load_color (f
, face
, color
, idx
);
7036 #if defined (MSDOS) || defined (WINDOWSNT)
7037 /* If the foreground of the default face is the default color,
7038 use the foreground color defined by the frame. */
7040 if (FRAME_MSDOS_P (f
))
7043 if (pixel
== default_pixel
7044 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7047 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7049 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7050 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7053 else if (pixel
== default_other_pixel
)
7056 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7058 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7059 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7065 #endif /* MSDOS or WINDOWSNT */
7069 face
->foreground
= pixel
;
7071 face
->background
= pixel
;
7075 /* Realize the fully-specified face with attributes ATTRS in face
7076 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7077 pointer to the newly created realized face. */
7079 static struct face
*
7080 realize_tty_face (cache
, attrs
, c
)
7081 struct face_cache
*cache
;
7087 int face_colors_defaulted
= 0;
7088 struct frame
*f
= cache
->f
;
7090 /* Frame must be a termcap frame. */
7091 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7093 /* Allocate a new realized face. */
7094 face
= make_realized_face (attrs
);
7095 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7097 /* Map face attributes to TTY appearances. We map slant to
7098 dimmed text because we want italic text to appear differently
7099 and because dimmed text is probably used infrequently. */
7100 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7101 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7103 if (weight
> XLFD_WEIGHT_MEDIUM
)
7104 face
->tty_bold_p
= 1;
7105 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7106 face
->tty_dim_p
= 1;
7107 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7108 face
->tty_underline_p
= 1;
7109 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7110 face
->tty_reverse_p
= 1;
7112 /* Map color names to color indices. */
7113 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7114 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7116 /* Swap colors if face is inverse-video. If the colors are taken
7117 from the frame colors, they are already inverted, since the
7118 frame-creation function calls x-handle-reverse-video. */
7119 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7121 unsigned long tem
= face
->foreground
;
7122 face
->foreground
= face
->background
;
7123 face
->background
= tem
;
7126 if (tty_suppress_bold_inverse_default_colors_p
7128 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7129 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7130 face
->tty_bold_p
= 0;
7136 DEFUN ("tty-suppress-bold-inverse-default-colors",
7137 Ftty_suppress_bold_inverse_default_colors
,
7138 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7139 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7140 SUPPRESS non-nil means suppress it.
7141 This affects bold faces on TTYs whose foreground is the default background
7142 color of the display and whose background is the default foreground color.
7143 For such faces, the bold face attribute is ignored if this variable
7146 Lisp_Object suppress
;
7148 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7149 ++face_change_count
;
7155 /***********************************************************************
7157 ***********************************************************************/
7159 /* Return the ID of the face to use to display character CH with face
7160 property PROP on frame F in current_buffer. */
7163 compute_char_face (f
, ch
, prop
)
7170 if (NILP (current_buffer
->enable_multibyte_characters
))
7175 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7176 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7180 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7181 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7182 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7183 merge_face_vector_with_property (f
, attrs
, prop
);
7184 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7190 /* Return the face ID associated with buffer position POS for
7191 displaying ASCII characters. Return in *ENDPTR the position at
7192 which a different face is needed, as far as text properties and
7193 overlays are concerned. W is a window displaying current_buffer.
7195 REGION_BEG, REGION_END delimit the region, so it can be
7198 LIMIT is a position not to scan beyond. That is to limit the time
7199 this function can take.
7201 If MOUSE is non-zero, use the character's mouse-face, not its face.
7203 The face returned is suitable for displaying ASCII characters. */
7206 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7207 endptr
, limit
, mouse
)
7210 int region_beg
, region_end
;
7215 struct frame
*f
= XFRAME (w
->frame
);
7216 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7217 Lisp_Object prop
, position
;
7219 Lisp_Object
*overlay_vec
;
7222 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7223 Lisp_Object limit1
, end
;
7224 struct face
*default_face
;
7226 /* W must display the current buffer. We could write this function
7227 to use the frame and buffer of W, but right now it doesn't. */
7228 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7230 XSETFRAME (frame
, f
);
7231 XSETFASTINT (position
, pos
);
7234 if (pos
< region_beg
&& region_beg
< endpos
)
7235 endpos
= region_beg
;
7237 /* Get the `face' or `mouse_face' text property at POS, and
7238 determine the next position at which the property changes. */
7239 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7240 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7241 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7243 endpos
= XINT (end
);
7245 /* Look at properties from overlays. */
7250 /* First try with room for 40 overlays. */
7252 overlay_vec
= (Lisp_Object
*) alloca (len
* sizeof (Lisp_Object
));
7253 noverlays
= overlays_at (pos
, 0, &overlay_vec
, &len
,
7254 &next_overlay
, NULL
, 0);
7256 /* If there are more than 40, make enough space for all, and try
7258 if (noverlays
> len
)
7261 overlay_vec
= (Lisp_Object
*) alloca (len
* sizeof (Lisp_Object
));
7262 noverlays
= overlays_at (pos
, 0, &overlay_vec
, &len
,
7263 &next_overlay
, NULL
, 0);
7266 if (next_overlay
< endpos
)
7267 endpos
= next_overlay
;
7272 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7274 /* Optimize common cases where we can use the default face. */
7277 && !(pos
>= region_beg
&& pos
< region_end
))
7278 return DEFAULT_FACE_ID
;
7280 /* Begin with attributes from the default face. */
7281 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7283 /* Merge in attributes specified via text properties. */
7285 merge_face_vector_with_property (f
, attrs
, prop
);
7287 /* Now merge the overlay data. */
7288 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7289 for (i
= 0; i
< noverlays
; i
++)
7294 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7296 merge_face_vector_with_property (f
, attrs
, prop
);
7298 oend
= OVERLAY_END (overlay_vec
[i
]);
7299 oendpos
= OVERLAY_POSITION (oend
);
7300 if (oendpos
< endpos
)
7304 /* If in the region, merge in the region face. */
7305 if (pos
>= region_beg
&& pos
< region_end
)
7307 Lisp_Object region_face
= lface_from_face_name (f
, Qregion
, 0);
7308 merge_face_vectors (f
, XVECTOR (region_face
)->contents
, attrs
, Qnil
);
7310 if (region_end
< endpos
)
7311 endpos
= region_end
;
7316 /* Look up a realized face with the given face attributes,
7317 or realize a new one for ASCII characters. */
7318 return lookup_face (f
, attrs
, 0, NULL
);
7322 /* Compute the face at character position POS in Lisp string STRING on
7323 window W, for ASCII characters.
7325 If STRING is an overlay string, it comes from position BUFPOS in
7326 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7327 not an overlay string. W must display the current buffer.
7328 REGION_BEG and REGION_END give the start and end positions of the
7329 region; both are -1 if no region is visible.
7331 BASE_FACE_ID is the id of a face to merge with. For strings coming
7332 from overlays or the `display' property it is the face at BUFPOS.
7334 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7336 Set *ENDPTR to the next position where to check for faces in
7337 STRING; -1 if the face is constant from POS to the end of the
7340 Value is the id of the face to use. The face returned is suitable
7341 for displaying ASCII characters. */
7344 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7345 region_end
, endptr
, base_face_id
, mouse_p
)
7349 int region_beg
, region_end
;
7351 enum face_id base_face_id
;
7354 Lisp_Object prop
, position
, end
, limit
;
7355 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7356 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7357 struct face
*base_face
;
7358 int multibyte_p
= STRING_MULTIBYTE (string
);
7359 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7361 /* Get the value of the face property at the current position within
7362 STRING. Value is nil if there is no face property. */
7363 XSETFASTINT (position
, pos
);
7364 prop
= Fget_text_property (position
, prop_name
, string
);
7366 /* Get the next position at which to check for faces. Value of end
7367 is nil if face is constant all the way to the end of the string.
7368 Otherwise it is a string position where to check faces next.
7369 Limit is the maximum position up to which to check for property
7370 changes in Fnext_single_property_change. Strings are usually
7371 short, so set the limit to the end of the string. */
7372 XSETFASTINT (limit
, SCHARS (string
));
7373 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7375 *endptr
= XFASTINT (end
);
7379 base_face
= FACE_FROM_ID (f
, base_face_id
);
7380 xassert (base_face
);
7382 /* Optimize the default case that there is no face property and we
7383 are not in the region. */
7385 && (base_face_id
!= DEFAULT_FACE_ID
7386 /* BUFPOS <= 0 means STRING is not an overlay string, so
7387 that the region doesn't have to be taken into account. */
7389 || bufpos
< region_beg
7390 || bufpos
>= region_end
)
7392 /* We can't realize faces for different charsets differently
7393 if we don't have fonts, so we can stop here if not working
7394 on a window-system frame. */
7395 || !FRAME_WINDOW_P (f
)
7396 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7397 return base_face
->id
;
7399 /* Begin with attributes from the base face. */
7400 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7402 /* Merge in attributes specified via text properties. */
7404 merge_face_vector_with_property (f
, attrs
, prop
);
7406 /* If in the region, merge in the region face. */
7408 && bufpos
>= region_beg
7409 && bufpos
< region_end
)
7411 Lisp_Object region_face
= lface_from_face_name (f
, Qregion
, 0);
7412 merge_face_vectors (f
, XVECTOR (region_face
)->contents
, attrs
, Qnil
);
7415 /* Look up a realized face with the given face attributes,
7416 or realize a new one for ASCII characters. */
7417 return lookup_face (f
, attrs
, 0, NULL
);
7422 /***********************************************************************
7424 ***********************************************************************/
7428 /* Print the contents of the realized face FACE to stderr. */
7431 dump_realized_face (face
)
7434 fprintf (stderr
, "ID: %d\n", face
->id
);
7435 #ifdef HAVE_X_WINDOWS
7436 fprintf (stderr
, "gc: %d\n", (int) face
->gc
);
7438 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7440 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7441 fprintf (stderr
, "background: 0x%lx (%s)\n",
7443 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7444 fprintf (stderr
, "font_name: %s (%s)\n",
7446 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7447 #ifdef HAVE_X_WINDOWS
7448 fprintf (stderr
, "font = %p\n", face
->font
);
7450 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7451 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7452 fprintf (stderr
, "underline: %d (%s)\n",
7454 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7455 fprintf (stderr
, "hash: %d\n", face
->hash
);
7456 fprintf (stderr
, "charset: %d\n", face
->charset
);
7460 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7468 fprintf (stderr
, "font selection order: ");
7469 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7470 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7471 fprintf (stderr
, "\n");
7473 fprintf (stderr
, "alternative fonts: ");
7474 debug_print (Vface_alternative_font_family_alist
);
7475 fprintf (stderr
, "\n");
7477 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7478 Fdump_face (make_number (i
));
7484 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7486 error ("Not a valid face");
7487 dump_realized_face (face
);
7494 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7495 0, 0, 0, doc
: /* */)
7498 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7499 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7500 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7504 #endif /* GLYPH_DEBUG != 0 */
7508 /***********************************************************************
7510 ***********************************************************************/
7515 Qface
= intern ("face");
7517 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7518 staticpro (&Qbitmap_spec_p
);
7519 Qframe_update_face_colors
= intern ("frame-update-face-colors");
7520 staticpro (&Qframe_update_face_colors
);
7522 /* Lisp face attribute keywords. */
7523 QCfamily
= intern (":family");
7524 staticpro (&QCfamily
);
7525 QCheight
= intern (":height");
7526 staticpro (&QCheight
);
7527 QCweight
= intern (":weight");
7528 staticpro (&QCweight
);
7529 QCslant
= intern (":slant");
7530 staticpro (&QCslant
);
7531 QCunderline
= intern (":underline");
7532 staticpro (&QCunderline
);
7533 QCinverse_video
= intern (":inverse-video");
7534 staticpro (&QCinverse_video
);
7535 QCreverse_video
= intern (":reverse-video");
7536 staticpro (&QCreverse_video
);
7537 QCforeground
= intern (":foreground");
7538 staticpro (&QCforeground
);
7539 QCbackground
= intern (":background");
7540 staticpro (&QCbackground
);
7541 QCstipple
= intern (":stipple");;
7542 staticpro (&QCstipple
);
7543 QCwidth
= intern (":width");
7544 staticpro (&QCwidth
);
7545 QCfont
= intern (":font");
7546 staticpro (&QCfont
);
7547 QCbold
= intern (":bold");
7548 staticpro (&QCbold
);
7549 QCitalic
= intern (":italic");
7550 staticpro (&QCitalic
);
7551 QCoverline
= intern (":overline");
7552 staticpro (&QCoverline
);
7553 QCstrike_through
= intern (":strike-through");
7554 staticpro (&QCstrike_through
);
7555 QCbox
= intern (":box");
7557 QCinherit
= intern (":inherit");
7558 staticpro (&QCinherit
);
7560 /* Symbols used for Lisp face attribute values. */
7561 QCcolor
= intern (":color");
7562 staticpro (&QCcolor
);
7563 QCline_width
= intern (":line-width");
7564 staticpro (&QCline_width
);
7565 QCstyle
= intern (":style");
7566 staticpro (&QCstyle
);
7567 Qreleased_button
= intern ("released-button");
7568 staticpro (&Qreleased_button
);
7569 Qpressed_button
= intern ("pressed-button");
7570 staticpro (&Qpressed_button
);
7571 Qnormal
= intern ("normal");
7572 staticpro (&Qnormal
);
7573 Qultra_light
= intern ("ultra-light");
7574 staticpro (&Qultra_light
);
7575 Qextra_light
= intern ("extra-light");
7576 staticpro (&Qextra_light
);
7577 Qlight
= intern ("light");
7578 staticpro (&Qlight
);
7579 Qsemi_light
= intern ("semi-light");
7580 staticpro (&Qsemi_light
);
7581 Qsemi_bold
= intern ("semi-bold");
7582 staticpro (&Qsemi_bold
);
7583 Qbold
= intern ("bold");
7585 Qextra_bold
= intern ("extra-bold");
7586 staticpro (&Qextra_bold
);
7587 Qultra_bold
= intern ("ultra-bold");
7588 staticpro (&Qultra_bold
);
7589 Qoblique
= intern ("oblique");
7590 staticpro (&Qoblique
);
7591 Qitalic
= intern ("italic");
7592 staticpro (&Qitalic
);
7593 Qreverse_oblique
= intern ("reverse-oblique");
7594 staticpro (&Qreverse_oblique
);
7595 Qreverse_italic
= intern ("reverse-italic");
7596 staticpro (&Qreverse_italic
);
7597 Qultra_condensed
= intern ("ultra-condensed");
7598 staticpro (&Qultra_condensed
);
7599 Qextra_condensed
= intern ("extra-condensed");
7600 staticpro (&Qextra_condensed
);
7601 Qcondensed
= intern ("condensed");
7602 staticpro (&Qcondensed
);
7603 Qsemi_condensed
= intern ("semi-condensed");
7604 staticpro (&Qsemi_condensed
);
7605 Qsemi_expanded
= intern ("semi-expanded");
7606 staticpro (&Qsemi_expanded
);
7607 Qexpanded
= intern ("expanded");
7608 staticpro (&Qexpanded
);
7609 Qextra_expanded
= intern ("extra-expanded");
7610 staticpro (&Qextra_expanded
);
7611 Qultra_expanded
= intern ("ultra-expanded");
7612 staticpro (&Qultra_expanded
);
7613 Qbackground_color
= intern ("background-color");
7614 staticpro (&Qbackground_color
);
7615 Qforeground_color
= intern ("foreground-color");
7616 staticpro (&Qforeground_color
);
7617 Qunspecified
= intern ("unspecified");
7618 staticpro (&Qunspecified
);
7620 Qface_alias
= intern ("face-alias");
7621 staticpro (&Qface_alias
);
7622 Qdefault
= intern ("default");
7623 staticpro (&Qdefault
);
7624 Qtool_bar
= intern ("tool-bar");
7625 staticpro (&Qtool_bar
);
7626 Qregion
= intern ("region");
7627 staticpro (&Qregion
);
7628 Qfringe
= intern ("fringe");
7629 staticpro (&Qfringe
);
7630 Qheader_line
= intern ("header-line");
7631 staticpro (&Qheader_line
);
7632 Qscroll_bar
= intern ("scroll-bar");
7633 staticpro (&Qscroll_bar
);
7634 Qmenu
= intern ("menu");
7636 Qcursor
= intern ("cursor");
7637 staticpro (&Qcursor
);
7638 Qborder
= intern ("border");
7639 staticpro (&Qborder
);
7640 Qmouse
= intern ("mouse");
7641 staticpro (&Qmouse
);
7642 Qmode_line_inactive
= intern ("mode-line-inactive");
7643 staticpro (&Qmode_line_inactive
);
7644 Qtty_color_desc
= intern ("tty-color-desc");
7645 staticpro (&Qtty_color_desc
);
7646 Qtty_color_standard_values
= intern ("tty-color-standard-values");
7647 staticpro (&Qtty_color_standard_values
);
7648 Qtty_color_by_index
= intern ("tty-color-by-index");
7649 staticpro (&Qtty_color_by_index
);
7650 Qtty_color_alist
= intern ("tty-color-alist");
7651 staticpro (&Qtty_color_alist
);
7652 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
7653 staticpro (&Qscalable_fonts_allowed
);
7655 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
7656 staticpro (&Vparam_value_alist
);
7657 Vface_alternative_font_family_alist
= Qnil
;
7658 staticpro (&Vface_alternative_font_family_alist
);
7659 Vface_alternative_font_registry_alist
= Qnil
;
7660 staticpro (&Vface_alternative_font_registry_alist
);
7662 defsubr (&Sinternal_make_lisp_face
);
7663 defsubr (&Sinternal_lisp_face_p
);
7664 defsubr (&Sinternal_set_lisp_face_attribute
);
7665 #ifdef HAVE_WINDOW_SYSTEM
7666 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
7668 defsubr (&Scolor_gray_p
);
7669 defsubr (&Scolor_supported_p
);
7670 defsubr (&Sface_attribute_relative_p
);
7671 defsubr (&Smerge_face_attribute
);
7672 defsubr (&Sinternal_get_lisp_face_attribute
);
7673 defsubr (&Sinternal_lisp_face_attribute_values
);
7674 defsubr (&Sinternal_lisp_face_equal_p
);
7675 defsubr (&Sinternal_lisp_face_empty_p
);
7676 defsubr (&Sinternal_copy_lisp_face
);
7677 defsubr (&Sinternal_merge_in_global_face
);
7678 defsubr (&Sface_font
);
7679 defsubr (&Sframe_face_alist
);
7680 defsubr (&Stty_supports_face_attributes_p
);
7681 defsubr (&Scolor_distance
);
7682 defsubr (&Sinternal_set_font_selection_order
);
7683 defsubr (&Sinternal_set_alternative_font_family_alist
);
7684 defsubr (&Sinternal_set_alternative_font_registry_alist
);
7685 defsubr (&Sface_attributes_as_vector
);
7687 defsubr (&Sdump_face
);
7688 defsubr (&Sshow_face_resources
);
7689 #endif /* GLYPH_DEBUG */
7690 defsubr (&Sclear_face_cache
);
7691 defsubr (&Stty_suppress_bold_inverse_default_colors
);
7693 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
7694 defsubr (&Sdump_colors
);
7697 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
7698 doc
: /* *Limit for font matching.
7699 If an integer > 0, font matching functions won't load more than
7700 that number of fonts when searching for a matching font. */);
7701 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
7703 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
7704 doc
: /* List of global face definitions (for internal use only.) */);
7705 Vface_new_frame_defaults
= Qnil
;
7707 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
7708 doc
: /* *Default stipple pattern used on monochrome displays.
7709 This stipple pattern is used on monochrome displays
7710 instead of shades of gray for a face background color.
7711 See `set-face-stipple' for possible values for this variable. */);
7712 Vface_default_stipple
= build_string ("gray3");
7714 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
7715 doc
: /* An alist of defined terminal colors and their RGB values. */);
7716 Vtty_defined_color_alist
= Qnil
;
7718 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
7719 doc
: /* Allowed scalable fonts.
7720 A value of nil means don't allow any scalable fonts.
7721 A value of t means allow any scalable font.
7722 Otherwise, value must be a list of regular expressions. A font may be
7723 scaled if its name matches a regular expression in the list.
7724 Note that if value is nil, a scalable font might still be used, if no
7725 other font of the appropriate family and registry is available. */);
7726 Vscalable_fonts_allowed
= Qnil
;
7728 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
7729 doc
: /* List of ignored fonts.
7730 Each element is a regular expression that matches names of fonts to
7732 Vface_ignored_fonts
= Qnil
;
7734 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
7735 doc
: /* Alist of fonts vs the rescaling factors.
7736 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
7737 FONT-NAME-PATTERN is a regular expression matching a font name, and
7738 RESCALE-RATIO is a floating point number to specify how much larger
7739 \(or smaller) font we should use. For instance, if a face requests
7740 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
7741 Vface_font_rescale_alist
= Qnil
;
7743 #ifdef HAVE_WINDOW_SYSTEM
7744 defsubr (&Sbitmap_spec_p
);
7745 defsubr (&Sx_list_fonts
);
7746 defsubr (&Sinternal_face_x_get_resource
);
7747 defsubr (&Sx_family_fonts
);
7748 defsubr (&Sx_font_family_list
);
7749 #endif /* HAVE_WINDOW_SYSTEM */
7752 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
7753 (do not change this comment) */