1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004
3 Free Software Foundation.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font or fontset pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
75 Faces are frame-local by nature because Emacs allows to define the
76 same named face (face names are symbols) differently for different
77 frames. Each frame has an alist of face definitions for all named
78 faces. The value of a named face in such an alist is a Lisp vector
79 with the symbol `face' in slot 0, and a slot for each of the face
80 attributes mentioned above.
82 There is also a global face alist `Vface_new_frame_defaults'. Face
83 definitions from this list are used to initialize faces of newly
86 A face doesn't have to specify all attributes. Those not specified
87 have a value of `unspecified'. Faces specifying all attributes but
88 the 14th are called `fully-specified'.
93 The display style of a given character in the text is determined by
94 combining several faces. This process is called `face merging'.
95 Any aspect of the display style that isn't specified by overlays or
96 text properties is taken from the `default' face. Since it is made
97 sure that the default face is always fully-specified, face merging
98 always results in a fully-specified face.
103 After all face attributes for a character have been determined by
104 merging faces of that character, that face is `realized'. The
105 realization process maps face attributes to what is physically
106 available on the system where Emacs runs. The result is a
107 `realized face' in form of a struct face which is stored in the
108 face cache of the frame on which it was realized.
110 Face realization is done in the context of the character to display
111 because different fonts may be used for different characters. In
112 other words, for characters that have different font
113 specifications, different realized faces are needed to display
116 Font specification is done by fontsets. See the comment in
117 fontset.c for the details. In the current implementation, all ASCII
118 characters share the same font in a fontset.
120 Faces are at first realized for ASCII characters, and, at that
121 time, assigned a specific realized fontset. Hereafter, we call
122 such a face as `ASCII face'. When a face for a multibyte character
123 is realized, it inherits (thus shares) a fontset of an ASCII face
124 that has the same attributes other than font-related ones.
126 Thus, all realized face have a realized fontset.
131 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
132 font as ASCII characters. That is because it is expected that
133 unibyte text users specify a font that is suitable both for ASCII
134 and raw 8-bit characters.
139 Font selection tries to find the best available matching font for a
140 given (character, face) combination.
142 If the face specifies a fontset name, that fontset determines a
143 pattern for fonts of the given character. If the face specifies a
144 font name or the other font-related attributes, a fontset is
145 realized from the default fontset. In that case, that
146 specification determines a pattern for ASCII characters and the
147 default fontset determines a pattern for multibyte characters.
149 Available fonts on the system on which Emacs runs are then matched
150 against the font pattern. The result of font selection is the best
151 match for the given face attributes in this font list.
153 Font selection can be influenced by the user.
155 1. The user can specify the relative importance he gives the face
156 attributes width, height, weight, and slant by setting
157 face-font-selection-order (faces.el) to a list of face attribute
158 names. The default is '(:width :height :weight :slant), and means
159 that font selection first tries to find a good match for the font
160 width specified by a face, then---within fonts with that
161 width---tries to find a best match for the specified font height,
164 2. Setting face-font-family-alternatives allows the user to
165 specify alternative font families to try if a family specified by a
168 3. Setting face-font-registry-alternatives allows the user to
169 specify all alternative font registries to try for a face
170 specifying a registry.
172 4. Setting face-ignored-fonts allows the user to ignore specific
176 Character composition.
178 Usually, the realization process is already finished when Emacs
179 actually reflects the desired glyph matrix on the screen. However,
180 on displaying a composition (sequence of characters to be composed
181 on the screen), a suitable font for the components of the
182 composition is selected and realized while drawing them on the
183 screen, i.e. the realization process is delayed but in principle
187 Initialization of basic faces.
189 The faces `default', `modeline' are considered `basic faces'.
190 When redisplay happens the first time for a newly created frame,
191 basic faces are realized for CHARSET_ASCII. Frame parameters are
192 used to fill in unspecified attributes of the default face. */
196 #include <sys/types.h>
197 #include <sys/stat.h>
198 #include <stdio.h> /* This needs to be before termchar.h */
202 #include "keyboard.h"
204 #include "termhooks.h"
206 #ifdef HAVE_WINDOW_SYSTEM
208 #endif /* HAVE_WINDOW_SYSTEM */
210 #ifdef HAVE_X_WINDOWS
214 #include <Xm/XmStrDefs.h>
215 #endif /* USE_MOTIF */
216 #endif /* HAVE_X_WINDOWS */
225 /* Redefine X specifics to W32 equivalents to avoid cluttering the
226 code with #ifdef blocks. */
227 #undef FRAME_X_DISPLAY_INFO
228 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
229 #define x_display_info w32_display_info
230 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
231 #define check_x check_w32
232 #define x_list_fonts w32_list_fonts
233 #define GCGraphicsExposures 0
234 #endif /* WINDOWSNT */
238 #define x_display_info mac_display_info
239 #define check_x check_mac
243 #include "dispextern.h"
244 #include "blockinput.h"
246 #include "intervals.h"
247 #include "termchar.h"
249 #ifdef HAVE_X_WINDOWS
251 /* Compensate for a bug in Xos.h on some systems, on which it requires
252 time.h. On some such systems, Xos.h tries to redefine struct
253 timeval and struct timezone if USG is #defined while it is
256 #ifdef XOS_NEEDS_TIME_H
262 #else /* not XOS_NEEDS_TIME_H */
264 #endif /* not XOS_NEEDS_TIME_H */
266 #endif /* HAVE_X_WINDOWS */
270 #define abs(X) ((X) < 0 ? -(X) : (X))
272 /* Number of pt per inch (from the TeXbook). */
274 #define PT_PER_INCH 72.27
276 /* Non-zero if face attribute ATTR is unspecified. */
278 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
280 /* Value is the number of elements of VECTOR. */
282 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
284 /* Make a copy of string S on the stack using alloca. Value is a pointer
287 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
289 /* Make a copy of the contents of Lisp string S on the stack using
290 alloca. Value is a pointer to the copy. */
292 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
294 /* Size of hash table of realized faces in face caches (should be a
297 #define FACE_CACHE_BUCKETS_SIZE 1001
299 /* Keyword symbols used for face attribute names. */
301 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
302 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
303 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
304 Lisp_Object QCreverse_video
;
305 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
307 /* Symbols used for attribute values. */
309 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
310 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
311 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
312 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
313 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
314 Lisp_Object Qultra_expanded
;
315 Lisp_Object Qreleased_button
, Qpressed_button
;
316 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
317 Lisp_Object Qunspecified
;
319 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
321 /* The name of the function to call when the background of the frame
322 has changed, frame_update_face_colors. */
324 Lisp_Object Qframe_update_face_colors
;
326 /* Names of basic faces. */
328 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
329 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
330 Lisp_Object Qmode_line_inactive
;
331 extern Lisp_Object Qmode_line
;
333 /* The symbol `face-alias'. A symbols having that property is an
334 alias for another face. Value of the property is the name of
337 Lisp_Object Qface_alias
;
339 /* Default stipple pattern used on monochrome displays. This stipple
340 pattern is used on monochrome displays instead of shades of gray
341 for a face background color. See `set-face-stipple' for possible
342 values for this variable. */
344 Lisp_Object Vface_default_stipple
;
346 /* Alist of alternative font families. Each element is of the form
347 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
348 try FAMILY1, then FAMILY2, ... */
350 Lisp_Object Vface_alternative_font_family_alist
;
352 /* Alist of alternative font registries. Each element is of the form
353 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
354 loaded, try REGISTRY1, then REGISTRY2, ... */
356 Lisp_Object Vface_alternative_font_registry_alist
;
358 /* Allowed scalable fonts. A value of nil means don't allow any
359 scalable fonts. A value of t means allow the use of any scalable
360 font. Otherwise, value must be a list of regular expressions. A
361 font may be scaled if its name matches a regular expression in the
364 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
366 /* List of regular expressions that matches names of fonts to ignore. */
368 Lisp_Object Vface_ignored_fonts
;
370 /* Alist of font name patterns vs the rescaling factor. */
372 Lisp_Object Vface_font_rescale_alist
;
374 /* Maximum number of fonts to consider in font_list. If not an
375 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
377 Lisp_Object Vfont_list_limit
;
378 #define DEFAULT_FONT_LIST_LIMIT 100
380 /* The symbols `foreground-color' and `background-color' which can be
381 used as part of a `face' property. This is for compatibility with
384 Lisp_Object Qforeground_color
, Qbackground_color
;
386 /* The symbols `face' and `mouse-face' used as text properties. */
389 extern Lisp_Object Qmouse_face
;
391 /* Error symbol for wrong_type_argument in load_pixmap. */
393 Lisp_Object Qbitmap_spec_p
;
395 /* Alist of global face definitions. Each element is of the form
396 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
397 is a Lisp vector of face attributes. These faces are used
398 to initialize faces for new frames. */
400 Lisp_Object Vface_new_frame_defaults
;
402 /* The next ID to assign to Lisp faces. */
404 static int next_lface_id
;
406 /* A vector mapping Lisp face Id's to face names. */
408 static Lisp_Object
*lface_id_to_name
;
409 static int lface_id_to_name_size
;
411 /* TTY color-related functions (defined in tty-colors.el). */
413 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
415 /* The name of the function used to compute colors on TTYs. */
417 Lisp_Object Qtty_color_alist
;
419 /* An alist of defined terminal colors and their RGB values. */
421 Lisp_Object Vtty_defined_color_alist
;
423 /* Counter for calls to clear_face_cache. If this counter reaches
424 CLEAR_FONT_TABLE_COUNT, and a frame has more than
425 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
427 static int clear_font_table_count
;
428 #define CLEAR_FONT_TABLE_COUNT 100
429 #define CLEAR_FONT_TABLE_NFONTS 10
431 /* Non-zero means face attributes have been changed since the last
432 redisplay. Used in redisplay_internal. */
434 int face_change_count
;
436 /* Non-zero means don't display bold text if a face's foreground
437 and background colors are the inverse of the default colors of the
438 display. This is a kluge to suppress `bold black' foreground text
439 which is hard to read on an LCD monitor. */
441 int tty_suppress_bold_inverse_default_colors_p
;
443 /* A list of the form `((x . y))' used to avoid consing in
444 Finternal_set_lisp_face_attribute. */
446 static Lisp_Object Vparam_value_alist
;
448 /* The total number of colors currently allocated. */
451 static int ncolors_allocated
;
452 static int npixmaps_allocated
;
456 /* Non-zero means the definition of the `menu' face for new frames has
459 int menu_face_changed_default
;
462 /* Function prototypes. */
466 struct named_merge_point
;
468 static void map_tty_color
P_ ((struct frame
*, struct face
*,
469 enum lface_attribute_index
, int *));
470 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
));
471 static int may_use_scalable_font_p
P_ ((const char *));
472 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
473 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
475 static int x_face_list_fonts
P_ ((struct frame
*, char *,
476 struct font_name
**, int, int));
477 static int font_scalable_p
P_ ((struct font_name
*));
478 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
479 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
480 static unsigned char *xstrlwr
P_ ((unsigned char *));
481 static void signal_error
P_ ((char *, Lisp_Object
));
482 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
483 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
484 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
485 static void free_face_colors
P_ ((struct frame
*, struct face
*));
486 static int face_color_gray_p
P_ ((struct frame
*, char *));
487 static char *build_font_name
P_ ((struct font_name
*));
488 static void free_font_names
P_ ((struct font_name
*, int));
489 static int sorted_font_list
P_ ((struct frame
*, char *,
490 int (*cmpfn
) P_ ((const void *, const void *)),
491 struct font_name
**));
492 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
493 Lisp_Object
, struct font_name
**));
494 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
495 Lisp_Object
, struct font_name
**));
496 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
497 Lisp_Object
, Lisp_Object
, struct font_name
**,
499 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
500 Lisp_Object
, struct font_name
**));
501 static int cmp_font_names
P_ ((const void *, const void *));
502 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
503 struct face
*, int));
504 static struct face
*realize_x_face
P_ ((struct face_cache
*,
505 Lisp_Object
*, int, struct face
*));
506 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
507 Lisp_Object
*, int));
508 static int realize_basic_faces
P_ ((struct frame
*));
509 static int realize_default_face
P_ ((struct frame
*));
510 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
511 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
512 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
513 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
514 static unsigned lface_hash
P_ ((Lisp_Object
*));
515 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
516 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
517 static void free_realized_face
P_ ((struct frame
*, struct face
*));
518 static void clear_face_gcs
P_ ((struct face_cache
*));
519 static void free_face_cache
P_ ((struct face_cache
*));
520 static int face_numeric_weight
P_ ((Lisp_Object
));
521 static int face_numeric_slant
P_ ((Lisp_Object
));
522 static int face_numeric_swidth
P_ ((Lisp_Object
));
523 static int face_fontset
P_ ((Lisp_Object
*));
524 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
525 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
526 struct named_merge_point
*));
527 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
528 int, struct named_merge_point
*));
529 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
530 Lisp_Object
, int, int));
531 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
532 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
533 static void free_realized_faces
P_ ((struct face_cache
*));
534 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
535 struct font_name
*, int, int, int *));
536 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
537 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
538 static int xlfd_numeric_slant
P_ ((struct font_name
*));
539 static int xlfd_numeric_weight
P_ ((struct font_name
*));
540 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
541 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
542 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
543 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
544 static int xlfd_fixed_p
P_ ((struct font_name
*));
545 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
547 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
548 struct font_name
*, int,
550 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
551 struct font_name
*, int));
553 #ifdef HAVE_WINDOW_SYSTEM
555 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
556 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
557 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
558 int (*cmpfn
) P_ ((const void *, const void *))));
559 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
560 static void x_free_gc
P_ ((struct frame
*, GC
));
561 static void clear_font_table
P_ ((struct x_display_info
*));
564 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
565 #endif /* WINDOWSNT */
568 static void x_update_menu_appearance
P_ ((struct frame
*));
570 extern void free_frame_menubar
P_ ((struct frame
*));
571 #endif /* USE_X_TOOLKIT */
573 #endif /* HAVE_WINDOW_SYSTEM */
576 /***********************************************************************
578 ***********************************************************************/
580 #ifdef HAVE_X_WINDOWS
582 #ifdef DEBUG_X_COLORS
584 /* The following is a poor mans infrastructure for debugging X color
585 allocation problems on displays with PseudoColor-8. Some X servers
586 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
587 color reference counts completely so that they don't signal an
588 error when a color is freed whose reference count is already 0.
589 Other X servers do. To help me debug this, the following code
590 implements a simple reference counting schema of its own, for a
591 single display/screen. --gerd. */
593 /* Reference counts for pixel colors. */
595 int color_count
[256];
597 /* Register color PIXEL as allocated. */
600 register_color (pixel
)
603 xassert (pixel
< 256);
604 ++color_count
[pixel
];
608 /* Register color PIXEL as deallocated. */
611 unregister_color (pixel
)
614 xassert (pixel
< 256);
615 if (color_count
[pixel
] > 0)
616 --color_count
[pixel
];
622 /* Register N colors from PIXELS as deallocated. */
625 unregister_colors (pixels
, n
)
626 unsigned long *pixels
;
630 for (i
= 0; i
< n
; ++i
)
631 unregister_color (pixels
[i
]);
635 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
636 doc
: /* Dump currently allocated colors to stderr. */)
641 fputc ('\n', stderr
);
643 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
646 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
649 fputc ('\n', stderr
);
651 fputc ('\t', stderr
);
655 fputc ('\n', stderr
);
659 #endif /* DEBUG_X_COLORS */
662 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
663 color values. Interrupt input must be blocked when this function
667 x_free_colors (f
, pixels
, npixels
)
669 unsigned long *pixels
;
672 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
674 /* If display has an immutable color map, freeing colors is not
675 necessary and some servers don't allow it. So don't do it. */
676 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
678 #ifdef DEBUG_X_COLORS
679 unregister_colors (pixels
, npixels
);
681 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
687 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
688 color values. Interrupt input must be blocked when this function
692 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
696 unsigned long *pixels
;
699 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
700 int class = dpyinfo
->visual
->class;
702 /* If display has an immutable color map, freeing colors is not
703 necessary and some servers don't allow it. So don't do it. */
704 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
706 #ifdef DEBUG_X_COLORS
707 unregister_colors (pixels
, npixels
);
709 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
714 /* Create and return a GC for use on frame F. GC values and mask
715 are given by XGCV and MASK. */
718 x_create_gc (f
, mask
, xgcv
)
725 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
732 /* Free GC which was used on frame F. */
740 xassert (--ngcs
>= 0);
741 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
745 #endif /* HAVE_X_WINDOWS */
748 /* W32 emulation of GCs */
751 x_create_gc (f
, mask
, xgcv
)
758 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
765 /* Free GC which was used on frame F. */
773 xassert (--ngcs
>= 0);
778 #endif /* WINDOWSNT */
781 /* Mac OS emulation of GCs */
783 extern XGCValues
*XCreateGC (void *, Window
, unsigned long, XGCValues
*);
786 x_create_gc (f
, mask
, xgcv
)
792 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
801 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
806 /* Like stricmp. Used to compare parts of font names which are in
811 const unsigned char *s1
, *s2
;
815 unsigned char c1
= tolower (*s1
);
816 unsigned char c2
= tolower (*s2
);
818 return c1
< c2
? -1 : 1;
823 return *s2
== 0 ? 0 : -1;
828 /* Like strlwr, which might not always be available. */
830 static unsigned char *
834 unsigned char *p
= s
;
843 /* Signal `error' with message S, and additional argument ARG. */
846 signal_error (s
, arg
)
850 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
854 /* If FRAME is nil, return a pointer to the selected frame.
855 Otherwise, check that FRAME is a live frame, and return a pointer
856 to it. NPARAM is the parameter number of FRAME, for
857 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
858 Lisp function definitions. */
860 static INLINE
struct frame
*
861 frame_or_selected_frame (frame
, nparam
)
866 frame
= selected_frame
;
868 CHECK_LIVE_FRAME (frame
);
869 return XFRAME (frame
);
873 /***********************************************************************
875 ***********************************************************************/
877 /* Initialize face cache and basic faces for frame F. */
883 /* Make a face cache, if F doesn't have one. */
884 if (FRAME_FACE_CACHE (f
) == NULL
)
885 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
887 #ifdef HAVE_WINDOW_SYSTEM
888 /* Make the image cache. */
889 if (FRAME_WINDOW_P (f
))
891 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
892 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
893 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
895 #endif /* HAVE_WINDOW_SYSTEM */
897 /* Realize basic faces. Must have enough information in frame
898 parameters to realize basic faces at this point. */
899 #ifdef HAVE_X_WINDOWS
900 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
903 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
906 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
908 if (!realize_basic_faces (f
))
913 /* Free face cache of frame F. Called from Fdelete_frame. */
919 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
923 free_face_cache (face_cache
);
924 FRAME_FACE_CACHE (f
) = NULL
;
927 #ifdef HAVE_WINDOW_SYSTEM
928 if (FRAME_WINDOW_P (f
))
930 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
933 --image_cache
->refcount
;
934 if (image_cache
->refcount
== 0)
935 free_image_cache (f
);
938 #endif /* HAVE_WINDOW_SYSTEM */
942 /* Clear face caches, and recompute basic faces for frame F. Call
943 this after changing frame parameters on which those faces depend,
944 or when realized faces have been freed due to changing attributes
948 recompute_basic_faces (f
)
951 if (FRAME_FACE_CACHE (f
))
953 clear_face_cache (0);
954 if (!realize_basic_faces (f
))
960 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
961 try to free unused fonts, too. */
964 clear_face_cache (clear_fonts_p
)
967 #ifdef HAVE_WINDOW_SYSTEM
968 Lisp_Object tail
, frame
;
972 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
974 struct x_display_info
*dpyinfo
;
976 /* Fonts are common for frames on one display, i.e. on
978 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
979 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
980 clear_font_table (dpyinfo
);
982 /* From time to time see if we can unload some fonts. This also
983 frees all realized faces on all frames. Fonts needed by
984 faces will be loaded again when faces are realized again. */
985 clear_font_table_count
= 0;
987 FOR_EACH_FRAME (tail
, frame
)
989 struct frame
*f
= XFRAME (frame
);
990 if (FRAME_WINDOW_P (f
)
991 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
992 free_all_realized_faces (frame
);
997 /* Clear GCs of realized faces. */
998 FOR_EACH_FRAME (tail
, frame
)
1001 if (FRAME_WINDOW_P (f
))
1003 clear_face_gcs (FRAME_FACE_CACHE (f
));
1004 clear_image_cache (f
, 0);
1008 #endif /* HAVE_WINDOW_SYSTEM */
1012 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1013 doc
: /* Clear face caches on all frames.
1014 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1016 Lisp_Object thoroughly
;
1018 clear_face_cache (!NILP (thoroughly
));
1019 ++face_change_count
;
1020 ++windows_or_buffers_changed
;
1026 #ifdef HAVE_WINDOW_SYSTEM
1029 /* Remove fonts from the font table of DPYINFO except for the default
1030 ASCII fonts of frames on that display. Called from clear_face_cache
1031 from time to time. */
1034 clear_font_table (dpyinfo
)
1035 struct x_display_info
*dpyinfo
;
1039 /* Free those fonts that are not used by frames on DPYINFO. */
1040 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1042 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1043 Lisp_Object tail
, frame
;
1045 /* Check if slot is already free. */
1046 if (font_info
->name
== NULL
)
1049 /* Don't free a default font of some frame. */
1050 FOR_EACH_FRAME (tail
, frame
)
1052 struct frame
*f
= XFRAME (frame
);
1053 if (FRAME_WINDOW_P (f
)
1054 && font_info
->font
== FRAME_FONT (f
))
1062 if (font_info
->full_name
!= font_info
->name
)
1063 xfree (font_info
->full_name
);
1064 xfree (font_info
->name
);
1066 /* Free the font. */
1068 #ifdef HAVE_X_WINDOWS
1069 XFreeFont (dpyinfo
->display
, font_info
->font
);
1072 w32_unload_font (dpyinfo
, font_info
->font
);
1076 /* Mark font table slot free. */
1077 font_info
->font
= NULL
;
1078 font_info
->name
= font_info
->full_name
= NULL
;
1082 #endif /* HAVE_WINDOW_SYSTEM */
1086 /***********************************************************************
1088 ***********************************************************************/
1090 #ifdef HAVE_WINDOW_SYSTEM
1092 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1093 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1094 A bitmap specification is either a string, a file name, or a list
1095 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1096 HEIGHT is its height, and DATA is a string containing the bits of
1097 the pixmap. Bits are stored row by row, each row occupies
1098 \(WIDTH + 7)/8 bytes. */)
1104 if (STRINGP (object
))
1105 /* If OBJECT is a string, it's a file name. */
1107 else if (CONSP (object
))
1109 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1110 HEIGHT must be integers > 0, and DATA must be string large
1111 enough to hold a bitmap of the specified size. */
1112 Lisp_Object width
, height
, data
;
1114 height
= width
= data
= Qnil
;
1118 width
= XCAR (object
);
1119 object
= XCDR (object
);
1122 height
= XCAR (object
);
1123 object
= XCDR (object
);
1125 data
= XCAR (object
);
1129 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1131 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1133 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1138 return pixmap_p
? Qt
: Qnil
;
1142 /* Load a bitmap according to NAME (which is either a file name or a
1143 pixmap spec) for use on frame F. Value is the bitmap_id (see
1144 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1145 bitmap cannot be loaded, display a message saying so, and return
1146 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1147 if these pointers are not null. */
1150 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1153 unsigned int *w_ptr
, *h_ptr
;
1161 tem
= Fbitmap_spec_p (name
);
1163 wrong_type_argument (Qbitmap_spec_p
, name
);
1168 /* Decode a bitmap spec into a bitmap. */
1173 w
= XINT (Fcar (name
));
1174 h
= XINT (Fcar (Fcdr (name
)));
1175 bits
= Fcar (Fcdr (Fcdr (name
)));
1177 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1182 /* It must be a string -- a file name. */
1183 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1189 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1200 ++npixmaps_allocated
;
1203 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1206 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1212 #endif /* HAVE_WINDOW_SYSTEM */
1216 /***********************************************************************
1218 ***********************************************************************/
1220 #ifdef HAVE_WINDOW_SYSTEM
1222 /* Load font of face FACE which is used on frame F to display
1223 character C. The name of the font to load is determined by lface
1224 and fontset of FACE. */
1227 load_face_font (f
, face
, c
)
1232 struct font_info
*font_info
= NULL
;
1234 int needs_overstrike
;
1236 face
->font_info_id
= -1;
1239 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1245 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1250 face
->font_info_id
= font_info
->font_idx
;
1251 face
->font
= font_info
->font
;
1252 face
->font_name
= font_info
->full_name
;
1253 face
->overstrike
= needs_overstrike
;
1256 x_free_gc (f
, face
->gc
);
1261 add_to_log ("Unable to load font %s",
1262 build_string (font_name
), Qnil
);
1266 #endif /* HAVE_WINDOW_SYSTEM */
1270 /***********************************************************************
1272 ***********************************************************************/
1274 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1275 RGB_LIST should contain (at least) 3 lisp integers.
1276 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1279 parse_rgb_list (rgb_list
, color
)
1280 Lisp_Object rgb_list
;
1283 #define PARSE_RGB_LIST_FIELD(field) \
1284 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1286 color->field = XINT (XCAR (rgb_list)); \
1287 rgb_list = XCDR (rgb_list); \
1292 PARSE_RGB_LIST_FIELD (red
);
1293 PARSE_RGB_LIST_FIELD (green
);
1294 PARSE_RGB_LIST_FIELD (blue
);
1300 /* Lookup on frame F the color described by the lisp string COLOR.
1301 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1302 non-zero, then the `standard' definition of the same color is
1306 tty_lookup_color (f
, color
, tty_color
, std_color
)
1309 XColor
*tty_color
, *std_color
;
1311 Lisp_Object frame
, color_desc
;
1313 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1316 XSETFRAME (frame
, f
);
1318 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1319 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1323 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1326 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1328 rgb
= XCDR (XCDR (color_desc
));
1329 if (! parse_rgb_list (rgb
, tty_color
))
1332 /* Should we fill in STD_COLOR too? */
1335 /* Default STD_COLOR to the same as TTY_COLOR. */
1336 *std_color
= *tty_color
;
1338 /* Do a quick check to see if the returned descriptor is
1339 actually _exactly_ equal to COLOR, otherwise we have to
1340 lookup STD_COLOR separately. If it's impossible to lookup
1341 a standard color, we just give up and use TTY_COLOR. */
1342 if ((!STRINGP (XCAR (color_desc
))
1343 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1344 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1346 /* Look up STD_COLOR separately. */
1347 rgb
= call1 (Qtty_color_standard_values
, color
);
1348 if (! parse_rgb_list (rgb
, std_color
))
1355 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1356 /* We were called early during startup, and the colors are not
1357 yet set up in tty-defined-color-alist. Don't return a failure
1358 indication, since this produces the annoying "Unable to
1359 load color" messages in the *Messages* buffer. */
1362 /* tty-color-desc seems to have returned a bad value. */
1366 /* A version of defined_color for non-X frames. */
1369 tty_defined_color (f
, color_name
, color_def
, alloc
)
1378 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1380 color_def
->blue
= 0;
1381 color_def
->green
= 0;
1384 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1386 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1388 if (strcmp (color_name
, "unspecified-fg") == 0)
1389 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1390 else if (strcmp (color_name
, "unspecified-bg") == 0)
1391 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1394 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1401 /* Decide if color named COLOR_NAME is valid for the display
1402 associated with the frame F; if so, return the rgb values in
1403 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1405 This does the right thing for any type of frame. */
1408 defined_color (f
, color_name
, color_def
, alloc
)
1414 if (!FRAME_WINDOW_P (f
))
1415 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1416 #ifdef HAVE_X_WINDOWS
1417 else if (FRAME_X_P (f
))
1418 return x_defined_color (f
, color_name
, color_def
, alloc
);
1421 else if (FRAME_W32_P (f
))
1422 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1425 else if (FRAME_MAC_P (f
))
1426 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1433 /* Given the index IDX of a tty color on frame F, return its name, a
1437 tty_color_name (f
, idx
)
1441 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1444 Lisp_Object coldesc
;
1446 XSETFRAME (frame
, f
);
1447 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1449 if (!NILP (coldesc
))
1450 return XCAR (coldesc
);
1453 /* We can have an MSDOG frame under -nw for a short window of
1454 opportunity before internal_terminal_init is called. DTRT. */
1455 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1456 return msdos_stdcolor_name (idx
);
1459 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1460 return build_string (unspecified_fg
);
1461 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1462 return build_string (unspecified_bg
);
1465 return vga_stdcolor_name (idx
);
1468 return Qunspecified
;
1472 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1473 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1476 face_color_gray_p (f
, color_name
)
1483 if (defined_color (f
, color_name
, &color
, 0))
1484 gray_p
= ((abs (color
.red
- color
.green
)
1485 < max (color
.red
, color
.green
) / 20)
1486 && (abs (color
.green
- color
.blue
)
1487 < max (color
.green
, color
.blue
) / 20)
1488 && (abs (color
.blue
- color
.red
)
1489 < max (color
.blue
, color
.red
) / 20));
1497 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1498 BACKGROUND_P non-zero means the color will be used as background
1502 face_color_supported_p (f
, color_name
, background_p
)
1510 XSETFRAME (frame
, f
);
1512 #ifdef HAVE_X_WINDOWS
1514 ? (!NILP (Fxw_display_color_p (frame
))
1515 || xstricmp (color_name
, "black") == 0
1516 || xstricmp (color_name
, "white") == 0
1518 && face_color_gray_p (f
, color_name
))
1519 || (!NILP (Fx_display_grayscale_p (frame
))
1520 && face_color_gray_p (f
, color_name
)))
1523 tty_defined_color (f
, color_name
, ¬_used
, 0);
1527 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1528 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1529 FRAME specifies the frame and thus the display for interpreting COLOR.
1530 If FRAME is nil or omitted, use the selected frame. */)
1532 Lisp_Object color
, frame
;
1536 CHECK_STRING (color
);
1538 frame
= selected_frame
;
1540 CHECK_FRAME (frame
);
1542 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1546 DEFUN ("color-supported-p", Fcolor_supported_p
,
1547 Scolor_supported_p
, 1, 3, 0,
1548 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1549 BACKGROUND-P non-nil means COLOR is used as a background.
1550 If FRAME is nil or omitted, use the selected frame.
1551 COLOR must be a valid color name. */)
1552 (color
, frame
, background_p
)
1553 Lisp_Object frame
, color
, background_p
;
1557 CHECK_STRING (color
);
1559 frame
= selected_frame
;
1561 CHECK_FRAME (frame
);
1563 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1569 /* Load color with name NAME for use by face FACE on frame F.
1570 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1571 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1572 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1573 pixel color. If color cannot be loaded, display a message, and
1574 return the foreground, background or underline color of F, but
1575 record that fact in flags of the face so that we don't try to free
1579 load_color (f
, face
, name
, target_index
)
1583 enum lface_attribute_index target_index
;
1587 xassert (STRINGP (name
));
1588 xassert (target_index
== LFACE_FOREGROUND_INDEX
1589 || target_index
== LFACE_BACKGROUND_INDEX
1590 || target_index
== LFACE_UNDERLINE_INDEX
1591 || target_index
== LFACE_OVERLINE_INDEX
1592 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1593 || target_index
== LFACE_BOX_INDEX
);
1595 /* if the color map is full, defined_color will return a best match
1596 to the values in an existing cell. */
1597 if (!defined_color (f
, SDATA (name
), &color
, 1))
1599 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1601 switch (target_index
)
1603 case LFACE_FOREGROUND_INDEX
:
1604 face
->foreground_defaulted_p
= 1;
1605 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1608 case LFACE_BACKGROUND_INDEX
:
1609 face
->background_defaulted_p
= 1;
1610 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1613 case LFACE_UNDERLINE_INDEX
:
1614 face
->underline_defaulted_p
= 1;
1615 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1618 case LFACE_OVERLINE_INDEX
:
1619 face
->overline_color_defaulted_p
= 1;
1620 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1623 case LFACE_STRIKE_THROUGH_INDEX
:
1624 face
->strike_through_color_defaulted_p
= 1;
1625 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1628 case LFACE_BOX_INDEX
:
1629 face
->box_color_defaulted_p
= 1;
1630 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1639 ++ncolors_allocated
;
1646 #ifdef HAVE_WINDOW_SYSTEM
1648 /* Load colors for face FACE which is used on frame F. Colors are
1649 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1650 of ATTRS. If the background color specified is not supported on F,
1651 try to emulate gray colors with a stipple from Vface_default_stipple. */
1654 load_face_colors (f
, face
, attrs
)
1661 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1662 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1664 /* Swap colors if face is inverse-video. */
1665 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1673 /* Check for support for foreground, not for background because
1674 face_color_supported_p is smart enough to know that grays are
1675 "supported" as background because we are supposed to use stipple
1677 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1678 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1680 x_destroy_bitmap (f
, face
->stipple
);
1681 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1682 &face
->pixmap_w
, &face
->pixmap_h
);
1685 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1686 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1690 /* Free color PIXEL on frame F. */
1693 unload_color (f
, pixel
)
1695 unsigned long pixel
;
1697 #ifdef HAVE_X_WINDOWS
1701 x_free_colors (f
, &pixel
, 1);
1708 /* Free colors allocated for FACE. */
1711 free_face_colors (f
, face
)
1715 #ifdef HAVE_X_WINDOWS
1716 if (face
->colors_copied_bitwise_p
)
1721 if (!face
->foreground_defaulted_p
)
1723 x_free_colors (f
, &face
->foreground
, 1);
1724 IF_DEBUG (--ncolors_allocated
);
1727 if (!face
->background_defaulted_p
)
1729 x_free_colors (f
, &face
->background
, 1);
1730 IF_DEBUG (--ncolors_allocated
);
1733 if (face
->underline_p
1734 && !face
->underline_defaulted_p
)
1736 x_free_colors (f
, &face
->underline_color
, 1);
1737 IF_DEBUG (--ncolors_allocated
);
1740 if (face
->overline_p
1741 && !face
->overline_color_defaulted_p
)
1743 x_free_colors (f
, &face
->overline_color
, 1);
1744 IF_DEBUG (--ncolors_allocated
);
1747 if (face
->strike_through_p
1748 && !face
->strike_through_color_defaulted_p
)
1750 x_free_colors (f
, &face
->strike_through_color
, 1);
1751 IF_DEBUG (--ncolors_allocated
);
1754 if (face
->box
!= FACE_NO_BOX
1755 && !face
->box_color_defaulted_p
)
1757 x_free_colors (f
, &face
->box_color
, 1);
1758 IF_DEBUG (--ncolors_allocated
);
1762 #endif /* HAVE_X_WINDOWS */
1765 #endif /* HAVE_WINDOW_SYSTEM */
1769 /***********************************************************************
1771 ***********************************************************************/
1773 /* An enumerator for each field of an XLFD font name. */
1794 /* An enumerator for each possible slant value of a font. Taken from
1795 the XLFD specification. */
1803 XLFD_SLANT_REVERSE_ITALIC
,
1804 XLFD_SLANT_REVERSE_OBLIQUE
,
1808 /* Relative font weight according to XLFD documentation. */
1812 XLFD_WEIGHT_UNKNOWN
,
1813 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1814 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1815 XLFD_WEIGHT_LIGHT
, /* 30 */
1816 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1817 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1818 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1819 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1820 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1821 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1824 /* Relative proportionate width. */
1828 XLFD_SWIDTH_UNKNOWN
,
1829 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1830 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1831 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1832 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1833 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1834 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1835 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1836 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1837 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1840 /* Structure used for tables mapping XLFD weight, slant, and width
1841 names to numeric and symbolic values. */
1847 Lisp_Object
*symbol
;
1850 /* Table of XLFD slant names and their numeric and symbolic
1851 representations. This table must be sorted by slant names in
1854 static struct table_entry slant_table
[] =
1856 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1857 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1858 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1859 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1860 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1861 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1864 /* Table of XLFD weight names. This table must be sorted by weight
1865 names in ascending order. */
1867 static struct table_entry weight_table
[] =
1869 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1870 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1871 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1872 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1873 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1874 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1875 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1876 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1877 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1878 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1879 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1880 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1881 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1882 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1883 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1884 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1887 /* Table of XLFD width names. This table must be sorted by width
1888 names in ascending order. */
1890 static struct table_entry swidth_table
[] =
1892 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1893 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1894 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1895 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1896 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1897 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1898 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1899 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1900 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1901 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1902 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1903 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1904 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1905 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1906 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1909 /* Structure used to hold the result of splitting font names in XLFD
1910 format into their fields. */
1914 /* The original name which is modified destructively by
1915 split_font_name. The pointer is kept here to be able to free it
1916 if it was allocated from the heap. */
1919 /* Font name fields. Each vector element points into `name' above.
1920 Fields are NUL-terminated. */
1921 char *fields
[XLFD_LAST
];
1923 /* Numeric values for those fields that interest us. See
1924 split_font_name for which these are. */
1925 int numeric
[XLFD_LAST
];
1927 /* If the original name matches one of Vface_font_rescale_alist,
1928 the value is the corresponding rescale ratio. Otherwise, the
1930 double rescale_ratio
;
1932 /* Lower value mean higher priority. */
1933 int registry_priority
;
1936 /* The frame in effect when sorting font names. Set temporarily in
1937 sort_fonts so that it is available in font comparison functions. */
1939 static struct frame
*font_frame
;
1941 /* Order by which font selection chooses fonts. The default values
1942 mean `first, find a best match for the font width, then for the
1943 font height, then for weight, then for slant.' This variable can be
1944 set via set-face-font-sort-order. */
1947 static int font_sort_order
[4] = {
1948 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1951 static int font_sort_order
[4];
1954 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1955 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1956 is a pointer to the matching table entry or null if no table entry
1959 static struct table_entry
*
1960 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1961 struct table_entry
*table
;
1963 struct font_name
*font
;
1966 /* Function split_font_name converts fields to lower-case, so there
1967 is no need to use xstrlwr or xstricmp here. */
1968 char *s
= font
->fields
[field_index
];
1969 int low
, mid
, high
, cmp
;
1976 mid
= (low
+ high
) / 2;
1977 cmp
= strcmp (table
[mid
].name
, s
);
1991 /* Return a numeric representation for font name field
1992 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
1993 has DIM entries. Value is the numeric value found or DFLT if no
1994 table entry matches. This function is used to translate weight,
1995 slant, and swidth names of XLFD font names to numeric values. */
1998 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
1999 struct table_entry
*table
;
2001 struct font_name
*font
;
2005 struct table_entry
*p
;
2006 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2007 return p
? p
->numeric
: dflt
;
2011 /* Return a symbolic representation for font name field
2012 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2013 has DIM entries. Value is the symbolic value found or DFLT if no
2014 table entry matches. This function is used to translate weight,
2015 slant, and swidth names of XLFD font names to symbols. */
2017 static INLINE Lisp_Object
2018 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2019 struct table_entry
*table
;
2021 struct font_name
*font
;
2025 struct table_entry
*p
;
2026 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2027 return p
? *p
->symbol
: dflt
;
2031 /* Return a numeric value for the slant of the font given by FONT. */
2034 xlfd_numeric_slant (font
)
2035 struct font_name
*font
;
2037 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2038 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2042 /* Return a symbol representing the weight of the font given by FONT. */
2044 static INLINE Lisp_Object
2045 xlfd_symbolic_slant (font
)
2046 struct font_name
*font
;
2048 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2049 font
, XLFD_SLANT
, Qnormal
);
2053 /* Return a numeric value for the weight of the font given by FONT. */
2056 xlfd_numeric_weight (font
)
2057 struct font_name
*font
;
2059 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2060 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2064 /* Return a symbol representing the slant of the font given by FONT. */
2066 static INLINE Lisp_Object
2067 xlfd_symbolic_weight (font
)
2068 struct font_name
*font
;
2070 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2071 font
, XLFD_WEIGHT
, Qnormal
);
2075 /* Return a numeric value for the swidth of the font whose XLFD font
2076 name fields are found in FONT. */
2079 xlfd_numeric_swidth (font
)
2080 struct font_name
*font
;
2082 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2083 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2087 /* Return a symbolic value for the swidth of FONT. */
2089 static INLINE Lisp_Object
2090 xlfd_symbolic_swidth (font
)
2091 struct font_name
*font
;
2093 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2094 font
, XLFD_SWIDTH
, Qnormal
);
2098 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2099 entries. Value is a pointer to the matching table entry or null if
2100 no element of TABLE contains SYMBOL. */
2102 static struct table_entry
*
2103 face_value (table
, dim
, symbol
)
2104 struct table_entry
*table
;
2110 xassert (SYMBOLP (symbol
));
2112 for (i
= 0; i
< dim
; ++i
)
2113 if (EQ (*table
[i
].symbol
, symbol
))
2116 return i
< dim
? table
+ i
: NULL
;
2120 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2121 entries. Value is -1 if SYMBOL is not found in TABLE. */
2124 face_numeric_value (table
, dim
, symbol
)
2125 struct table_entry
*table
;
2129 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2130 return p
? p
->numeric
: -1;
2134 /* Return a numeric value representing the weight specified by Lisp
2135 symbol WEIGHT. Value is one of the enumerators of enum
2139 face_numeric_weight (weight
)
2142 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2146 /* Return a numeric value representing the slant specified by Lisp
2147 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2150 face_numeric_slant (slant
)
2153 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2157 /* Return a numeric value representing the swidth specified by Lisp
2158 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2161 face_numeric_swidth (width
)
2164 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2168 #ifdef HAVE_WINDOW_SYSTEM
2170 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2174 struct font_name
*font
;
2176 /* Function split_font_name converts fields to lower-case, so there
2177 is no need to use tolower here. */
2178 return *font
->fields
[XLFD_SPACING
] != 'p';
2182 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2184 The actual height of the font when displayed on F depends on the
2185 resolution of both the font and frame. For example, a 10pt font
2186 designed for a 100dpi display will display larger than 10pt on a
2187 75dpi display. (It's not unusual to use fonts not designed for the
2188 display one is using. For example, some intlfonts are available in
2189 72dpi versions, only.)
2191 Value is the real point size of FONT on frame F, or 0 if it cannot
2195 xlfd_point_size (f
, font
)
2197 struct font_name
*font
;
2199 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2200 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2204 if (*pixel_field
== '[')
2206 /* The pixel size field is `[A B C D]' which specifies
2207 a transformation matrix.
2213 by which all glyphs of the font are transformed. The spec
2214 says that s scalar value N for the pixel size is equivalent
2215 to A = N * resx/resy, B = C = 0, D = N. */
2216 char *start
= pixel_field
+ 1, *end
;
2220 for (i
= 0; i
< 4; ++i
)
2222 matrix
[i
] = strtod (start
, &end
);
2229 pixel
= atoi (pixel_field
);
2234 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2240 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2241 of frame F. This function is used to guess a point size of font
2242 when only the pixel height of the font is available. */
2245 pixel_point_size (f
, pixel
)
2249 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2253 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2254 point size of one dot. */
2255 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2256 int_pt
= real_pt
+ 0.5;
2262 /* Return a rescaling ratio of a font of NAME. */
2265 font_rescale_ratio (name
)
2268 Lisp_Object tail
, elt
;
2270 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2273 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2274 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2275 return XFLOAT_DATA (XCDR (elt
));
2281 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2282 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2283 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2284 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2285 zero if the font name doesn't have the format we expect. The
2286 expected format is a font name that starts with a `-' and has
2287 XLFD_LAST fields separated by `-'. */
2290 split_font_name (f
, font
, numeric_p
)
2292 struct font_name
*font
;
2297 double rescale_ratio
;
2300 /* This must be done before splitting the font name. */
2301 rescale_ratio
= font_rescale_ratio (font
->name
);
2303 if (*font
->name
== '-')
2305 char *p
= xstrlwr (font
->name
) + 1;
2307 while (i
< XLFD_LAST
)
2309 font
->fields
[i
] = p
;
2312 /* Pixel and point size may be of the form `[....]'. For
2313 BNF, see XLFD spec, chapter 4. Negative values are
2314 indicated by tilde characters which we replace with
2315 `-' characters, here. */
2317 && (i
- 1 == XLFD_PIXEL_SIZE
2318 || i
- 1 == XLFD_POINT_SIZE
))
2323 for (++p
; *p
&& *p
!= ']'; ++p
)
2327 /* Check that the matrix contains 4 floating point
2329 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2332 if (strtod (start
, &end
) == 0 && start
== end
)
2339 while (*p
&& *p
!= '-')
2349 success_p
= i
== XLFD_LAST
;
2351 /* If requested, and font name was in the expected format,
2352 compute numeric values for some fields. */
2353 if (numeric_p
&& success_p
)
2355 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2356 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2357 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2358 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2359 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2360 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2361 font
->rescale_ratio
= rescale_ratio
;
2364 /* Initialize it to zero. It will be overridden by font_list while
2365 trying alternate registries. */
2366 font
->registry_priority
= 0;
2372 /* Build an XLFD font name from font name fields in FONT. Value is a
2373 pointer to the font name, which is allocated via xmalloc. */
2376 build_font_name (font
)
2377 struct font_name
*font
;
2381 char *font_name
= (char *) xmalloc (size
);
2382 int total_length
= 0;
2384 for (i
= 0; i
< XLFD_LAST
; ++i
)
2386 /* Add 1 because of the leading `-'. */
2387 int len
= strlen (font
->fields
[i
]) + 1;
2389 /* Reallocate font_name if necessary. Add 1 for the final
2391 if (total_length
+ len
+ 1 >= size
)
2393 int new_size
= max (2 * size
, size
+ len
+ 1);
2394 int sz
= new_size
* sizeof *font_name
;
2395 font_name
= (char *) xrealloc (font_name
, sz
);
2399 font_name
[total_length
] = '-';
2400 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2401 total_length
+= len
;
2404 font_name
[total_length
] = 0;
2409 /* Free an array FONTS of N font_name structures. This frees FONTS
2410 itself and all `name' fields in its elements. */
2413 free_font_names (fonts
, n
)
2414 struct font_name
*fonts
;
2418 xfree (fonts
[--n
].name
);
2423 /* Sort vector FONTS of font_name structures which contains NFONTS
2424 elements using qsort and comparison function CMPFN. F is the frame
2425 on which the fonts will be used. The global variable font_frame
2426 is temporarily set to F to make it available in CMPFN. */
2429 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2431 struct font_name
*fonts
;
2433 int (*cmpfn
) P_ ((const void *, const void *));
2436 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2441 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2442 display in x_display_list. FONTS is a pointer to a vector of
2443 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2444 alternative patterns from Valternate_fontname_alist if no fonts are
2445 found matching PATTERN.
2447 For all fonts found, set FONTS[i].name to the name of the font,
2448 allocated via xmalloc, and split font names into fields. Ignore
2449 fonts that we can't parse. Value is the number of fonts found. */
2452 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2455 struct font_name
**pfonts
;
2456 int nfonts
, try_alternatives_p
;
2460 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2461 better to do it the other way around. */
2463 Lisp_Object lpattern
, tem
;
2464 struct font_name
*fonts
= 0;
2465 int num_fonts
= nfonts
;
2468 lpattern
= build_string (pattern
);
2470 /* Get the list of fonts matching PATTERN. */
2473 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2476 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2479 if (nfonts
< 0 && CONSP (lfonts
))
2480 num_fonts
= XFASTINT (Flength (lfonts
));
2482 /* Make a copy of the font names we got from X, and
2483 split them into fields. */
2485 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2487 Lisp_Object elt
, tail
;
2488 const char *name
= SDATA (XCAR (tem
));
2490 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2491 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2495 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2506 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2510 /* Make a copy of the font name. */
2511 fonts
[n
].name
= xstrdup (name
);
2513 if (split_font_name (f
, fonts
+ n
, 1))
2515 if (font_scalable_p (fonts
+ n
)
2516 && !may_use_scalable_font_p (name
))
2519 xfree (fonts
[n
].name
);
2525 xfree (fonts
[n
].name
);
2528 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2529 if (n
== 0 && try_alternatives_p
)
2531 Lisp_Object list
= Valternate_fontname_alist
;
2539 while (CONSP (list
))
2541 Lisp_Object entry
= XCAR (list
);
2543 && STRINGP (XCAR (entry
))
2544 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2551 Lisp_Object patterns
= XCAR (list
);
2554 while (CONSP (patterns
)
2555 /* If list is screwed up, give up. */
2556 && (name
= XCAR (patterns
),
2558 /* Ignore patterns equal to PATTERN because we tried that
2559 already with no success. */
2560 && (strcmp (SDATA (name
), pattern
) == 0
2561 || (n
= x_face_list_fonts (f
, SDATA (name
),
2564 patterns
= XCDR (patterns
);
2572 /* Check if a font matching pattern_offset_t on frame F is available
2573 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2574 a font name pattern is generated from FAMILY and REGISTRY. */
2577 face_font_available_p (f
, pattern
)
2579 Lisp_Object pattern
;
2583 if (! STRINGP (pattern
))
2585 Lisp_Object family
, registry
;
2586 char *family_str
, *registry_str
, *pattern_str
;
2588 CHECK_CONS (pattern
);
2589 family
= XCAR (pattern
);
2594 CHECK_STRING (family
);
2595 family_str
= (char *) SDATA (family
);
2597 registry
= XCDR (pattern
);
2598 if (NILP (registry
))
2602 CHECK_STRING (registry
);
2603 registry_str
= (char *) SDATA (registry
);
2606 pattern_str
= (char *) alloca (strlen (family_str
)
2607 + strlen (registry_str
)
2609 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2610 strcat (pattern_str
, family_str
);
2611 strcat (pattern_str
, "-*-");
2612 strcat (pattern_str
, registry_str
);
2613 if (!index (registry_str
, '-'))
2615 if (registry_str
[strlen (registry_str
) - 1] == '*')
2616 strcat (pattern_str
, "-*");
2618 strcat (pattern_str
, "*-*");
2620 pattern
= build_string (pattern_str
);
2623 /* Get the list of fonts matching PATTERN. */
2626 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2629 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2631 return XINT (Flength (fonts
));
2635 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2636 using comparison function CMPFN. Value is the number of fonts
2637 found. If value is non-zero, *FONTS is set to a vector of
2638 font_name structures allocated from the heap containing matching
2639 fonts. Each element of *FONTS contains a name member that is also
2640 allocated from the heap. Font names in these structures are split
2641 into fields. Use free_font_names to free such an array. */
2644 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2647 int (*cmpfn
) P_ ((const void *, const void *));
2648 struct font_name
**fonts
;
2652 /* Get the list of fonts matching pattern. 100 should suffice. */
2653 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2654 if (INTEGERP (Vfont_list_limit
))
2655 nfonts
= XINT (Vfont_list_limit
);
2658 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2660 /* Sort the resulting array and return it in *FONTS. If no
2661 fonts were found, make sure to set *FONTS to null. */
2663 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2674 /* Compare two font_name structures *A and *B. Value is analogous to
2675 strcmp. Sort order is given by the global variable
2676 font_sort_order. Font names are sorted so that, everything else
2677 being equal, fonts with a resolution closer to that of the frame on
2678 which they are used are listed first. The global variable
2679 font_frame is the frame on which we operate. */
2682 cmp_font_names (a
, b
)
2685 struct font_name
*x
= (struct font_name
*) a
;
2686 struct font_name
*y
= (struct font_name
*) b
;
2689 /* All strings have been converted to lower-case by split_font_name,
2690 so we can use strcmp here. */
2691 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2696 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2698 int j
= font_sort_order
[i
];
2699 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2704 /* Everything else being equal, we prefer fonts with an
2705 y-resolution closer to that of the frame. */
2706 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2707 int x_resy
= x
->numeric
[XLFD_RESY
];
2708 int y_resy
= y
->numeric
[XLFD_RESY
];
2709 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2717 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2718 is non-nil list fonts matching that pattern. Otherwise, if
2719 REGISTRY is non-nil return only fonts with that registry, otherwise
2720 return fonts of any registry. Set *FONTS to a vector of font_name
2721 structures allocated from the heap containing the fonts found.
2722 Value is the number of fonts found. */
2725 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2727 Lisp_Object pattern
, family
, registry
;
2728 struct font_name
**fonts
;
2730 char *pattern_str
, *family_str
, *registry_str
;
2734 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2735 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2737 pattern_str
= (char *) alloca (strlen (family_str
)
2738 + strlen (registry_str
)
2740 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2741 strcat (pattern_str
, family_str
);
2742 strcat (pattern_str
, "-*-");
2743 strcat (pattern_str
, registry_str
);
2744 if (!index (registry_str
, '-'))
2746 if (registry_str
[strlen (registry_str
) - 1] == '*')
2747 strcat (pattern_str
, "-*");
2749 strcat (pattern_str
, "*-*");
2753 pattern_str
= (char *) SDATA (pattern
);
2755 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2759 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2760 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2761 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2764 static struct font_name
*
2765 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2766 struct font_name
*fonts1
, *fonts2
;
2767 int nfonts1
, nfonts2
;
2769 int new_nfonts
= nfonts1
+ nfonts2
;
2770 struct font_name
*new_fonts
;
2772 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2773 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2774 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2781 /* Get a sorted list of fonts of family FAMILY on frame F.
2783 If PATTERN is non-nil list fonts matching that pattern.
2785 If REGISTRY is non-nil, return fonts with that registry and the
2786 alternative registries from Vface_alternative_font_registry_alist.
2788 If REGISTRY is nil return fonts of any registry.
2790 Set *FONTS to a vector of font_name structures allocated from the
2791 heap containing the fonts found. Value is the number of fonts
2795 font_list (f
, pattern
, family
, registry
, fonts
)
2797 Lisp_Object pattern
, family
, registry
;
2798 struct font_name
**fonts
;
2800 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2802 if (!NILP (registry
)
2803 && CONSP (Vface_alternative_font_registry_alist
))
2807 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2812 for (alter
= XCDR (alter
), reg_prio
= 1;
2814 alter
= XCDR (alter
), reg_prio
++)
2815 if (STRINGP (XCAR (alter
)))
2818 struct font_name
*fonts2
;
2820 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2822 for (i
= 0; i
< nfonts2
; i
++)
2823 fonts2
[i
].registry_priority
= reg_prio
;
2824 *fonts
= (nfonts
> 0
2825 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2836 /* Remove elements from LIST whose cars are `equal'. Called from
2837 x-family-fonts and x-font-family-list to remove duplicate font
2841 remove_duplicates (list
)
2844 Lisp_Object tail
= list
;
2846 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2848 Lisp_Object next
= XCDR (tail
);
2849 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2850 XSETCDR (tail
, XCDR (next
));
2857 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2858 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2859 If FAMILY is omitted or nil, list all families.
2860 Otherwise, FAMILY must be a string, possibly containing wildcards
2862 If FRAME is omitted or nil, use the selected frame.
2863 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2864 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2865 FAMILY is the font family name. POINT-SIZE is the size of the
2866 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2867 width, weight and slant of the font. These symbols are the same as for
2868 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2869 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2870 giving the registry and encoding of the font.
2871 The result list is sorted according to the current setting of
2872 the face font sort order. */)
2874 Lisp_Object family
, frame
;
2876 struct frame
*f
= check_x_frame (frame
);
2877 struct font_name
*fonts
;
2880 struct gcpro gcpro1
;
2883 CHECK_STRING (family
);
2887 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2888 for (i
= nfonts
- 1; i
>= 0; --i
)
2890 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2893 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2894 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2895 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2896 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2897 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2898 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2899 tem
= build_font_name (fonts
+ i
);
2900 ASET (v
, 6, build_string (tem
));
2901 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2902 fonts
[i
].fields
[XLFD_ENCODING
]);
2903 ASET (v
, 7, build_string (tem
));
2906 result
= Fcons (v
, result
);
2909 remove_duplicates (result
);
2910 free_font_names (fonts
, nfonts
);
2916 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2918 doc
: /* Return a list of available font families on FRAME.
2919 If FRAME is omitted or nil, use the selected frame.
2920 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2921 is a font family, and FIXED-P is non-nil if fonts of that family
2922 are fixed-pitch. */)
2926 struct frame
*f
= check_x_frame (frame
);
2928 struct font_name
*fonts
;
2930 struct gcpro gcpro1
;
2931 int count
= SPECPDL_INDEX ();
2933 /* Let's consider all fonts. */
2934 specbind (intern ("font-list-limit"), make_number (-1));
2935 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2939 for (i
= nfonts
- 1; i
>= 0; --i
)
2940 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2941 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2944 remove_duplicates (result
);
2945 free_font_names (fonts
, nfonts
);
2947 return unbind_to (count
, result
);
2951 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2952 doc
: /* Return a list of the names of available fonts matching PATTERN.
2953 If optional arguments FACE and FRAME are specified, return only fonts
2954 the same size as FACE on FRAME.
2955 PATTERN is a string, perhaps with wildcard characters;
2956 the * character matches any substring, and
2957 the ? character matches any single character.
2958 PATTERN is case-insensitive.
2959 FACE is a face name--a symbol.
2961 The return value is a list of strings, suitable as arguments to
2964 Fonts Emacs can't use may or may not be excluded
2965 even if they match PATTERN and FACE.
2966 The optional fourth argument MAXIMUM sets a limit on how many
2967 fonts to match. The first MAXIMUM fonts are reported.
2968 The optional fifth argument WIDTH, if specified, is a number of columns
2969 occupied by a character of a font. In that case, return only fonts
2970 the WIDTH times as wide as FACE on FRAME. */)
2971 (pattern
, face
, frame
, maximum
, width
)
2972 Lisp_Object pattern
, face
, frame
, maximum
, width
;
2979 CHECK_STRING (pattern
);
2985 CHECK_NATNUM (maximum
);
2986 maxnames
= XINT (maximum
);
2990 CHECK_NUMBER (width
);
2992 /* We can't simply call check_x_frame because this function may be
2993 called before any frame is created. */
2994 f
= frame_or_selected_frame (frame
, 2);
2995 if (!FRAME_WINDOW_P (f
))
2997 /* Perhaps we have not yet created any frame. */
3002 /* Determine the width standard for comparison with the fonts we find. */
3008 /* This is of limited utility since it works with character
3009 widths. Keep it for compatibility. --gerd. */
3010 int face_id
= lookup_named_face (f
, face
, 0);
3011 struct face
*face
= (face_id
< 0
3013 : FACE_FROM_ID (f
, face_id
));
3016 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3017 not maximum as on X. Redefine here. */
3019 #define FONT_WIDTH FONT_MAX_WIDTH
3022 if (face
&& face
->font
)
3023 size
= FONT_WIDTH (face
->font
);
3025 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3028 size
*= XINT (width
);
3032 Lisp_Object args
[2];
3034 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3036 /* We don't have to check fontsets. */
3038 args
[1] = list_fontsets (f
, pattern
, size
);
3039 return Fnconc (2, args
);
3043 #endif /* HAVE_WINDOW_SYSTEM */
3047 /***********************************************************************
3049 ***********************************************************************/
3051 /* Access face attributes of face LFACE, a Lisp vector. */
3053 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3054 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3055 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3056 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3057 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3058 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3059 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3060 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3061 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3062 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3063 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3064 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3065 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3066 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3067 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3068 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3070 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3071 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3073 #define LFACEP(LFACE) \
3075 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3076 && EQ (AREF (LFACE, 0), Qface))
3081 /* Check consistency of Lisp face attribute vector ATTRS. */
3084 check_lface_attrs (attrs
)
3087 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3088 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3089 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3090 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3091 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3092 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3093 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3094 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3095 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3096 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3097 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3098 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3099 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3100 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3101 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3102 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3103 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3104 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3105 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3106 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3107 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3108 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3109 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3110 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3111 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3112 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3113 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3114 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3115 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3116 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3117 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3118 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3119 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3120 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3121 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3122 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3123 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3124 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3125 #ifdef HAVE_WINDOW_SYSTEM
3126 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3127 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3128 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3129 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3130 || NILP (attrs
[LFACE_FONT_INDEX
])
3131 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3136 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3144 xassert (LFACEP (lface
));
3145 check_lface_attrs (XVECTOR (lface
)->contents
);
3149 #else /* GLYPH_DEBUG == 0 */
3151 #define check_lface_attrs(attrs) (void) 0
3152 #define check_lface(lface) (void) 0
3154 #endif /* GLYPH_DEBUG == 0 */
3158 /* Face-merge cycle checking. */
3160 /* A `named merge point' is simply a point during face-merging where we
3161 look up a face by name. We keep a stack of which named lookups we're
3162 currently processing so that we can easily detect cycles, using a
3163 linked- list of struct named_merge_point structures, typically
3164 allocated on the stack frame of the named lookup functions which are
3165 active (so no consing is required). */
3166 struct named_merge_point
3168 Lisp_Object face_name
;
3169 struct named_merge_point
*prev
;
3173 /* If a face merging cycle is detected for FACE_NAME, return 0,
3174 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3175 FACE_NAME, as the head of the linked list
3176 pointed to by NAMED_MERGE_POINTS, and return 1. */
3179 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3180 Lisp_Object face_name
,
3181 struct named_merge_point
**named_merge_points
)
3183 struct named_merge_point
*prev
;
3185 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3186 if (EQ (face_name
, prev
->face_name
))
3189 new_named_merge_point
->face_name
= face_name
;
3190 new_named_merge_point
->prev
= *named_merge_points
;
3192 *named_merge_points
= new_named_merge_point
;
3200 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3201 to make it a symvol. If FACE_NAME is an alias for another face,
3202 return that face's name. */
3205 resolve_face_name (face_name
)
3206 Lisp_Object face_name
;
3208 Lisp_Object aliased
;
3210 if (STRINGP (face_name
))
3211 face_name
= intern (SDATA (face_name
));
3213 while (SYMBOLP (face_name
))
3215 aliased
= Fget (face_name
, Qface_alias
);
3219 face_name
= aliased
;
3226 /* Return the face definition of FACE_NAME on frame F. F null means
3227 return the definition for new frames. FACE_NAME may be a string or
3228 a symbol (apparently Emacs 20.2 allowed strings as face names in
3229 face text properties; Ediff uses that). If FACE_NAME is an alias
3230 for another face, return that face's definition. If SIGNAL_P is
3231 non-zero, signal an error if FACE_NAME is not a valid face name.
3232 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3235 static INLINE Lisp_Object
3236 lface_from_face_name (f
, face_name
, signal_p
)
3238 Lisp_Object face_name
;
3243 face_name
= resolve_face_name (face_name
);
3246 lface
= assq_no_quit (face_name
, f
->face_alist
);
3248 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3251 lface
= XCDR (lface
);
3253 signal_error ("Invalid face", face_name
);
3255 check_lface (lface
);
3260 /* Get face attributes of face FACE_NAME from frame-local faces on
3261 frame F. Store the resulting attributes in ATTRS which must point
3262 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3263 is non-zero, signal an error if FACE_NAME does not name a face.
3264 Otherwise, value is zero if FACE_NAME is not a face. */
3267 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3269 Lisp_Object face_name
;
3276 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3279 bcopy (XVECTOR (lface
)->contents
, attrs
,
3280 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3290 /* Non-zero if all attributes in face attribute vector ATTRS are
3291 specified, i.e. are non-nil. */
3294 lface_fully_specified_p (attrs
)
3299 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3300 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3301 && i
!= LFACE_AVGWIDTH_INDEX
)
3302 if (UNSPECIFIEDP (attrs
[i
])
3304 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3305 always unspecified. */
3306 && i
!= LFACE_STIPPLE_INDEX
3311 return i
== LFACE_VECTOR_SIZE
;
3314 #ifdef HAVE_WINDOW_SYSTEM
3316 /* Set font-related attributes of Lisp face LFACE from the fullname of
3317 the font opened by FONTNAME. If FORCE_P is zero, set only
3318 unspecified attributes of LFACE. The exception is `font'
3319 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3321 If FONTNAME is not available on frame F,
3322 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3323 If the fullname is not in a valid XLFD format,
3324 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3325 in LFACE and return 1.
3326 Otherwise, return 1. */
3329 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3332 Lisp_Object fontname
;
3333 int force_p
, may_fail_p
;
3335 struct font_name font
;
3340 char *font_name
= SDATA (fontname
);
3341 struct font_info
*font_info
;
3343 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3344 fontset
= fs_query_fontset (fontname
, 0);
3346 font_name
= SDATA (fontset_ascii (fontset
));
3348 /* Check if FONT_NAME is surely available on the system. Usually
3349 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3350 returns quickly. But, even if FONT_NAME is not yet cached,
3351 caching it now is not futail because we anyway load the font
3354 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3364 font
.name
= STRDUPA (font_info
->full_name
);
3365 have_xlfd_p
= split_font_name (f
, &font
, 1);
3367 /* Set attributes only if unspecified, otherwise face defaults for
3368 new frames would never take effect. If we couldn't get a font
3369 name conforming to XLFD, set normal values. */
3371 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3376 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3377 + strlen (font
.fields
[XLFD_FOUNDRY
])
3379 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3380 font
.fields
[XLFD_FAMILY
]);
3381 val
= build_string (buffer
);
3384 val
= build_string ("*");
3385 LFACE_FAMILY (lface
) = val
;
3388 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3391 pt
= xlfd_point_size (f
, &font
);
3393 pt
= pixel_point_size (f
, font_info
->height
* 10);
3395 LFACE_HEIGHT (lface
) = make_number (pt
);
3398 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3399 LFACE_SWIDTH (lface
)
3400 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3402 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3403 LFACE_AVGWIDTH (lface
)
3405 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3408 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3409 LFACE_WEIGHT (lface
)
3410 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3412 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3414 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3416 LFACE_FONT (lface
) = fontname
;
3421 #endif /* HAVE_WINDOW_SYSTEM */
3424 /* Merges the face height FROM with the face height TO, and returns the
3425 merged height. If FROM is an invalid height, then INVALID is
3426 returned instead. FROM and TO may be either absolute face heights or
3427 `relative' heights; the returned value is always an absolute height
3428 unless both FROM and TO are relative. GCPRO is a lisp value that
3429 will be protected from garbage-collection if this function makes a
3433 merge_face_heights (from
, to
, invalid
, gcpro
)
3434 Lisp_Object from
, to
, invalid
, gcpro
;
3436 Lisp_Object result
= invalid
;
3438 if (INTEGERP (from
))
3439 /* FROM is absolute, just use it as is. */
3441 else if (FLOATP (from
))
3442 /* FROM is a scale, use it to adjust TO. */
3445 /* relative X absolute => absolute */
3446 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3447 else if (FLOATP (to
))
3448 /* relative X relative => relative */
3449 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3450 else if (UNSPECIFIEDP (to
))
3453 else if (FUNCTIONP (from
))
3454 /* FROM is a function, which use to adjust TO. */
3456 /* Call function with current height as argument.
3457 From is the new height. */
3458 Lisp_Object args
[2];
3459 struct gcpro gcpro1
;
3465 result
= safe_call (2, args
);
3469 /* Ensure that if TO was absolute, so is the result. */
3470 if (INTEGERP (to
) && !INTEGERP (result
))
3478 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3479 store the resulting attributes in TO, which must be already be
3480 completely specified and contain only absolute attributes. Every
3481 specified attribute of FROM overrides the corresponding attribute of
3482 TO; relative attributes in FROM are merged with the absolute value in
3483 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3484 loops in face inheritance; it should be 0 when called from other
3488 merge_face_vectors (f
, from
, to
, named_merge_points
)
3490 Lisp_Object
*from
, *to
;
3491 struct named_merge_point
*named_merge_points
;
3495 /* If FROM inherits from some other faces, merge their attributes into
3496 TO before merging FROM's direct attributes. Note that an :inherit
3497 attribute of `unspecified' is the same as one of nil; we never
3498 merge :inherit attributes, so nil is more correct, but lots of
3499 other code uses `unspecified' as a generic value for face attributes. */
3500 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3501 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3502 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3504 /* If TO specifies a :font attribute, and FROM specifies some
3505 font-related attribute, we need to clear TO's :font attribute
3506 (because it will be inconsistent with whatever FROM specifies, and
3507 FROM takes precedence). */
3508 if (!NILP (to
[LFACE_FONT_INDEX
])
3509 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3510 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3511 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3512 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3513 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3514 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3515 to
[LFACE_FONT_INDEX
] = Qnil
;
3517 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3518 if (!UNSPECIFIEDP (from
[i
]))
3520 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3521 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
],
3522 named_merge_points
);
3527 /* TO is always an absolute face, which should inherit from nothing.
3528 We blindly copy the :inherit attribute above and fix it up here. */
3529 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3532 /* Merge the named face FACE_NAME on frame F, into the vector of face
3533 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3534 inheritance. Returns true if FACE_NAME is a valid face name and
3535 merging succeeded. */
3538 merge_named_face (f
, face_name
, to
, named_merge_points
)
3540 Lisp_Object face_name
;
3542 struct named_merge_point
*named_merge_points
;
3544 struct named_merge_point named_merge_point
;
3546 if (push_named_merge_point (&named_merge_point
,
3547 face_name
, &named_merge_points
))
3549 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3550 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3553 merge_face_vectors (f
, from
, to
, named_merge_points
);
3562 /* Merge face attributes from the lisp `face reference' FACE_REF on
3563 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3564 problems with FACE_REF cause an error message to be shown. Return
3565 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3566 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3567 list structure; it may be 0 for most callers.
3569 FACE_REF may be a single face specification or a list of such
3570 specifications. Each face specification can be:
3572 1. A symbol or string naming a Lisp face.
3574 2. A property list of the form (KEYWORD VALUE ...) where each
3575 KEYWORD is a face attribute name, and value is an appropriate value
3578 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3579 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3580 for compatibility with 20.2.
3582 Face specifications earlier in lists take precedence over later
3586 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3588 Lisp_Object face_ref
;
3591 struct named_merge_point
*named_merge_points
;
3593 int ok
= 1; /* Succeed without an error? */
3595 if (CONSP (face_ref
))
3597 Lisp_Object first
= XCAR (face_ref
);
3599 if (EQ (first
, Qforeground_color
)
3600 || EQ (first
, Qbackground_color
))
3602 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3603 . COLOR). COLOR must be a string. */
3604 Lisp_Object color_name
= XCDR (face_ref
);
3605 Lisp_Object color
= first
;
3607 if (STRINGP (color_name
))
3609 if (EQ (color
, Qforeground_color
))
3610 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3612 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3617 add_to_log ("Invalid face color", color_name
, Qnil
);
3621 else if (SYMBOLP (first
)
3622 && *SDATA (SYMBOL_NAME (first
)) == ':')
3624 /* Assume this is the property list form. */
3625 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3627 Lisp_Object keyword
= XCAR (face_ref
);
3628 Lisp_Object value
= XCAR (XCDR (face_ref
));
3631 if (EQ (keyword
, QCfamily
))
3633 if (STRINGP (value
))
3634 to
[LFACE_FAMILY_INDEX
] = value
;
3638 else if (EQ (keyword
, QCheight
))
3640 Lisp_Object new_height
=
3641 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
],
3644 if (! NILP (new_height
))
3645 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3649 else if (EQ (keyword
, QCweight
))
3652 && face_numeric_weight (value
) >= 0)
3653 to
[LFACE_WEIGHT_INDEX
] = value
;
3657 else if (EQ (keyword
, QCslant
))
3660 && face_numeric_slant (value
) >= 0)
3661 to
[LFACE_SLANT_INDEX
] = value
;
3665 else if (EQ (keyword
, QCunderline
))
3670 to
[LFACE_UNDERLINE_INDEX
] = value
;
3674 else if (EQ (keyword
, QCoverline
))
3679 to
[LFACE_OVERLINE_INDEX
] = value
;
3683 else if (EQ (keyword
, QCstrike_through
))
3688 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3692 else if (EQ (keyword
, QCbox
))
3695 value
= make_number (1);
3696 if (INTEGERP (value
)
3700 to
[LFACE_BOX_INDEX
] = value
;
3704 else if (EQ (keyword
, QCinverse_video
)
3705 || EQ (keyword
, QCreverse_video
))
3707 if (EQ (value
, Qt
) || NILP (value
))
3708 to
[LFACE_INVERSE_INDEX
] = value
;
3712 else if (EQ (keyword
, QCforeground
))
3714 if (STRINGP (value
))
3715 to
[LFACE_FOREGROUND_INDEX
] = value
;
3719 else if (EQ (keyword
, QCbackground
))
3721 if (STRINGP (value
))
3722 to
[LFACE_BACKGROUND_INDEX
] = value
;
3726 else if (EQ (keyword
, QCstipple
))
3728 #ifdef HAVE_X_WINDOWS
3729 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3730 if (!NILP (pixmap_p
))
3731 to
[LFACE_STIPPLE_INDEX
] = value
;
3736 else if (EQ (keyword
, QCwidth
))
3739 && face_numeric_swidth (value
) >= 0)
3740 to
[LFACE_SWIDTH_INDEX
] = value
;
3744 else if (EQ (keyword
, QCinherit
))
3746 /* This is not really very useful; it's just like a
3747 normal face reference. */
3748 if (! merge_face_ref (f
, value
, to
,
3749 err_msgs
, named_merge_points
))
3757 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3761 face_ref
= XCDR (XCDR (face_ref
));
3766 /* This is a list of face refs. Those at the beginning of the
3767 list take precedence over what follows, so we have to merge
3768 from the end backwards. */
3769 Lisp_Object next
= XCDR (face_ref
);
3772 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3774 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3780 /* FACE_REF ought to be a face name. */
3781 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3782 if (!ok
&& err_msgs
)
3783 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3790 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3791 Sinternal_make_lisp_face
, 1, 2, 0,
3792 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3793 If FACE was not known as a face before, create a new one.
3794 If optional argument FRAME is specified, make a frame-local face
3795 for that frame. Otherwise operate on the global face definition.
3796 Value is a vector of face attributes. */)
3798 Lisp_Object face
, frame
;
3800 Lisp_Object global_lface
, lface
;
3804 CHECK_SYMBOL (face
);
3805 global_lface
= lface_from_face_name (NULL
, face
, 0);
3809 CHECK_LIVE_FRAME (frame
);
3811 lface
= lface_from_face_name (f
, face
, 0);
3814 f
= NULL
, lface
= Qnil
;
3816 /* Add a global definition if there is none. */
3817 if (NILP (global_lface
))
3819 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3821 AREF (global_lface
, 0) = Qface
;
3822 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3823 Vface_new_frame_defaults
);
3825 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3826 face id to Lisp face is given by the vector lface_id_to_name.
3827 The mapping from Lisp face to Lisp face id is given by the
3828 property `face' of the Lisp face name. */
3829 if (next_lface_id
== lface_id_to_name_size
)
3831 int new_size
= max (50, 2 * lface_id_to_name_size
);
3832 int sz
= new_size
* sizeof *lface_id_to_name
;
3833 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3834 lface_id_to_name_size
= new_size
;
3837 lface_id_to_name
[next_lface_id
] = face
;
3838 Fput (face
, Qface
, make_number (next_lface_id
));
3842 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3843 AREF (global_lface
, i
) = Qunspecified
;
3845 /* Add a frame-local definition. */
3850 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3852 AREF (lface
, 0) = Qface
;
3853 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3856 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3857 AREF (lface
, i
) = Qunspecified
;
3860 lface
= global_lface
;
3862 /* Changing a named face means that all realized faces depending on
3863 that face are invalid. Since we cannot tell which realized faces
3864 depend on the face, make sure they are all removed. This is done
3865 by incrementing face_change_count. The next call to
3866 init_iterator will then free realized faces. */
3867 ++face_change_count
;
3868 ++windows_or_buffers_changed
;
3870 xassert (LFACEP (lface
));
3871 check_lface (lface
);
3876 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3877 Sinternal_lisp_face_p
, 1, 2, 0,
3878 doc
: /* Return non-nil if FACE names a face.
3879 If optional second parameter FRAME is non-nil, check for the
3880 existence of a frame-local face with name FACE on that frame.
3881 Otherwise check for the existence of a global face. */)
3883 Lisp_Object face
, frame
;
3889 CHECK_LIVE_FRAME (frame
);
3890 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3893 lface
= lface_from_face_name (NULL
, face
, 0);
3899 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3900 Sinternal_copy_lisp_face
, 4, 4, 0,
3901 doc
: /* Copy face FROM to TO.
3902 If FRAME is t, copy the global face definition of FROM to the
3903 global face definition of TO. Otherwise, copy the frame-local
3904 definition of FROM on FRAME to the frame-local definition of TO
3905 on NEW-FRAME, or FRAME if NEW-FRAME is nil.
3908 (from
, to
, frame
, new_frame
)
3909 Lisp_Object from
, to
, frame
, new_frame
;
3911 Lisp_Object lface
, copy
;
3913 CHECK_SYMBOL (from
);
3915 if (NILP (new_frame
))
3920 /* Copy global definition of FROM. We don't make copies of
3921 strings etc. because 20.2 didn't do it either. */
3922 lface
= lface_from_face_name (NULL
, from
, 1);
3923 copy
= Finternal_make_lisp_face (to
, Qnil
);
3927 /* Copy frame-local definition of FROM. */
3928 CHECK_LIVE_FRAME (frame
);
3929 CHECK_LIVE_FRAME (new_frame
);
3930 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3931 copy
= Finternal_make_lisp_face (to
, new_frame
);
3934 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3935 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
3937 /* Changing a named face means that all realized faces depending on
3938 that face are invalid. Since we cannot tell which realized faces
3939 depend on the face, make sure they are all removed. This is done
3940 by incrementing face_change_count. The next call to
3941 init_iterator will then free realized faces. */
3942 ++face_change_count
;
3943 ++windows_or_buffers_changed
;
3949 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
3950 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
3951 doc
: /* Set attribute ATTR of FACE to VALUE.
3952 FRAME being a frame means change the face on that frame.
3953 FRAME nil means change the face of the selected frame.
3954 FRAME t means change the default for new frames.
3955 FRAME 0 means change the face on all frames, and change the default
3957 (face
, attr
, value
, frame
)
3958 Lisp_Object face
, attr
, value
, frame
;
3961 Lisp_Object old_value
= Qnil
;
3962 /* Set 1 if ATTR is QCfont. */
3963 int font_attr_p
= 0;
3964 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
3965 int font_related_attr_p
= 0;
3967 CHECK_SYMBOL (face
);
3968 CHECK_SYMBOL (attr
);
3970 face
= resolve_face_name (face
);
3972 /* If FRAME is 0, change face on all frames, and change the
3973 default for new frames. */
3974 if (INTEGERP (frame
) && XINT (frame
) == 0)
3977 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
3978 FOR_EACH_FRAME (tail
, frame
)
3979 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
3983 /* Set lface to the Lisp attribute vector of FACE. */
3985 lface
= lface_from_face_name (NULL
, face
, 1);
3989 frame
= selected_frame
;
3991 CHECK_LIVE_FRAME (frame
);
3992 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3994 /* If a frame-local face doesn't exist yet, create one. */
3996 lface
= Finternal_make_lisp_face (face
, frame
);
3999 if (EQ (attr
, QCfamily
))
4001 if (!UNSPECIFIEDP (value
))
4003 CHECK_STRING (value
);
4004 if (SCHARS (value
) == 0)
4005 signal_error ("Invalid face family", value
);
4007 old_value
= LFACE_FAMILY (lface
);
4008 LFACE_FAMILY (lface
) = value
;
4009 font_related_attr_p
= 1;
4011 else if (EQ (attr
, QCheight
))
4013 if (!UNSPECIFIEDP (value
))
4017 test
= (EQ (face
, Qdefault
)
4019 /* The default face must have an absolute size,
4020 otherwise, we do a test merge with a random
4021 height to see if VALUE's ok. */
4022 : merge_face_heights (value
, make_number (10), Qnil
, Qnil
));
4024 if (!INTEGERP (test
) || XINT (test
) <= 0)
4025 signal_error ("Invalid face height", value
);
4028 old_value
= LFACE_HEIGHT (lface
);
4029 LFACE_HEIGHT (lface
) = value
;
4030 font_related_attr_p
= 1;
4032 else if (EQ (attr
, QCweight
))
4034 if (!UNSPECIFIEDP (value
))
4036 CHECK_SYMBOL (value
);
4037 if (face_numeric_weight (value
) < 0)
4038 signal_error ("Invalid face weight", value
);
4040 old_value
= LFACE_WEIGHT (lface
);
4041 LFACE_WEIGHT (lface
) = value
;
4042 font_related_attr_p
= 1;
4044 else if (EQ (attr
, QCslant
))
4046 if (!UNSPECIFIEDP (value
))
4048 CHECK_SYMBOL (value
);
4049 if (face_numeric_slant (value
) < 0)
4050 signal_error ("Invalid face slant", value
);
4052 old_value
= LFACE_SLANT (lface
);
4053 LFACE_SLANT (lface
) = value
;
4054 font_related_attr_p
= 1;
4056 else if (EQ (attr
, QCunderline
))
4058 if (!UNSPECIFIEDP (value
))
4059 if ((SYMBOLP (value
)
4061 && !EQ (value
, Qnil
))
4062 /* Underline color. */
4064 && SCHARS (value
) == 0))
4065 signal_error ("Invalid face underline", value
);
4067 old_value
= LFACE_UNDERLINE (lface
);
4068 LFACE_UNDERLINE (lface
) = value
;
4070 else if (EQ (attr
, QCoverline
))
4072 if (!UNSPECIFIEDP (value
))
4073 if ((SYMBOLP (value
)
4075 && !EQ (value
, Qnil
))
4076 /* Overline color. */
4078 && SCHARS (value
) == 0))
4079 signal_error ("Invalid face overline", value
);
4081 old_value
= LFACE_OVERLINE (lface
);
4082 LFACE_OVERLINE (lface
) = value
;
4084 else if (EQ (attr
, QCstrike_through
))
4086 if (!UNSPECIFIEDP (value
))
4087 if ((SYMBOLP (value
)
4089 && !EQ (value
, Qnil
))
4090 /* Strike-through color. */
4092 && SCHARS (value
) == 0))
4093 signal_error ("Invalid face strike-through", value
);
4095 old_value
= LFACE_STRIKE_THROUGH (lface
);
4096 LFACE_STRIKE_THROUGH (lface
) = value
;
4098 else if (EQ (attr
, QCbox
))
4102 /* Allow t meaning a simple box of width 1 in foreground color
4105 value
= make_number (1);
4107 if (UNSPECIFIEDP (value
))
4109 else if (NILP (value
))
4111 else if (INTEGERP (value
))
4112 valid_p
= XINT (value
) != 0;
4113 else if (STRINGP (value
))
4114 valid_p
= SCHARS (value
) > 0;
4115 else if (CONSP (value
))
4131 if (EQ (k
, QCline_width
))
4133 if (!INTEGERP (v
) || XINT (v
) == 0)
4136 else if (EQ (k
, QCcolor
))
4138 if (!STRINGP (v
) || SCHARS (v
) == 0)
4141 else if (EQ (k
, QCstyle
))
4143 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4150 valid_p
= NILP (tem
);
4156 signal_error ("Invalid face box", value
);
4158 old_value
= LFACE_BOX (lface
);
4159 LFACE_BOX (lface
) = value
;
4161 else if (EQ (attr
, QCinverse_video
)
4162 || EQ (attr
, QCreverse_video
))
4164 if (!UNSPECIFIEDP (value
))
4166 CHECK_SYMBOL (value
);
4167 if (!EQ (value
, Qt
) && !NILP (value
))
4168 signal_error ("Invalid inverse-video face attribute value", value
);
4170 old_value
= LFACE_INVERSE (lface
);
4171 LFACE_INVERSE (lface
) = value
;
4173 else if (EQ (attr
, QCforeground
))
4175 if (!UNSPECIFIEDP (value
))
4177 /* Don't check for valid color names here because it depends
4178 on the frame (display) whether the color will be valid
4179 when the face is realized. */
4180 CHECK_STRING (value
);
4181 if (SCHARS (value
) == 0)
4182 signal_error ("Empty foreground color value", value
);
4184 old_value
= LFACE_FOREGROUND (lface
);
4185 LFACE_FOREGROUND (lface
) = value
;
4187 else if (EQ (attr
, QCbackground
))
4189 if (!UNSPECIFIEDP (value
))
4191 /* Don't check for valid color names here because it depends
4192 on the frame (display) whether the color will be valid
4193 when the face is realized. */
4194 CHECK_STRING (value
);
4195 if (SCHARS (value
) == 0)
4196 signal_error ("Empty background color value", value
);
4198 old_value
= LFACE_BACKGROUND (lface
);
4199 LFACE_BACKGROUND (lface
) = value
;
4201 else if (EQ (attr
, QCstipple
))
4203 #ifdef HAVE_X_WINDOWS
4204 if (!UNSPECIFIEDP (value
)
4206 && NILP (Fbitmap_spec_p (value
)))
4207 signal_error ("Invalid stipple attribute", value
);
4208 old_value
= LFACE_STIPPLE (lface
);
4209 LFACE_STIPPLE (lface
) = value
;
4210 #endif /* HAVE_X_WINDOWS */
4212 else if (EQ (attr
, QCwidth
))
4214 if (!UNSPECIFIEDP (value
))
4216 CHECK_SYMBOL (value
);
4217 if (face_numeric_swidth (value
) < 0)
4218 signal_error ("Invalid face width", value
);
4220 old_value
= LFACE_SWIDTH (lface
);
4221 LFACE_SWIDTH (lface
) = value
;
4222 font_related_attr_p
= 1;
4224 else if (EQ (attr
, QCfont
))
4226 #ifdef HAVE_WINDOW_SYSTEM
4227 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4229 /* Set font-related attributes of the Lisp face from an XLFD
4235 f
= SELECTED_FRAME ();
4237 f
= check_x_frame (frame
);
4239 if (!UNSPECIFIEDP (value
))
4241 CHECK_STRING (value
);
4243 /* VALUE may be a fontset name or an alias of fontset. In
4244 such a case, use the base fontset name. */
4245 tmp
= Fquery_fontset (value
, Qnil
);
4249 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4250 signal_error ("Invalid font or fontset name", value
);
4255 #endif /* HAVE_WINDOW_SYSTEM */
4257 else if (EQ (attr
, QCinherit
))
4260 if (SYMBOLP (value
))
4263 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4264 if (!SYMBOLP (XCAR (tail
)))
4267 LFACE_INHERIT (lface
) = value
;
4269 signal_error ("Invalid face inheritance", value
);
4271 else if (EQ (attr
, QCbold
))
4273 old_value
= LFACE_WEIGHT (lface
);
4274 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4275 font_related_attr_p
= 1;
4277 else if (EQ (attr
, QCitalic
))
4279 old_value
= LFACE_SLANT (lface
);
4280 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4281 font_related_attr_p
= 1;
4284 signal_error ("Invalid face attribute name", attr
);
4286 if (font_related_attr_p
4287 && !UNSPECIFIEDP (value
))
4288 /* If a font-related attribute other than QCfont is specified, the
4289 original `font' attribute nor that of default face is useless
4290 to determine a new font. Thus, we set it to nil so that font
4291 selection mechanism doesn't use it. */
4292 LFACE_FONT (lface
) = Qnil
;
4294 /* Changing a named face means that all realized faces depending on
4295 that face are invalid. Since we cannot tell which realized faces
4296 depend on the face, make sure they are all removed. This is done
4297 by incrementing face_change_count. The next call to
4298 init_iterator will then free realized faces. */
4300 && (EQ (attr
, QCfont
)
4301 || NILP (Fequal (old_value
, value
))))
4303 ++face_change_count
;
4304 ++windows_or_buffers_changed
;
4307 if (!UNSPECIFIEDP (value
)
4308 && NILP (Fequal (old_value
, value
)))
4314 if (EQ (face
, Qdefault
))
4316 #ifdef HAVE_WINDOW_SYSTEM
4317 /* Changed font-related attributes of the `default' face are
4318 reflected in changed `font' frame parameters. */
4320 && (font_related_attr_p
|| font_attr_p
)
4321 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4322 set_font_frame_param (frame
, lface
);
4324 #endif /* HAVE_WINDOW_SYSTEM */
4326 if (EQ (attr
, QCforeground
))
4327 param
= Qforeground_color
;
4328 else if (EQ (attr
, QCbackground
))
4329 param
= Qbackground_color
;
4331 #ifdef HAVE_WINDOW_SYSTEM
4333 else if (EQ (face
, Qscroll_bar
))
4335 /* Changing the colors of `scroll-bar' sets frame parameters
4336 `scroll-bar-foreground' and `scroll-bar-background'. */
4337 if (EQ (attr
, QCforeground
))
4338 param
= Qscroll_bar_foreground
;
4339 else if (EQ (attr
, QCbackground
))
4340 param
= Qscroll_bar_background
;
4342 #endif /* not WINDOWSNT */
4343 else if (EQ (face
, Qborder
))
4345 /* Changing background color of `border' sets frame parameter
4347 if (EQ (attr
, QCbackground
))
4348 param
= Qborder_color
;
4350 else if (EQ (face
, Qcursor
))
4352 /* Changing background color of `cursor' sets frame parameter
4354 if (EQ (attr
, QCbackground
))
4355 param
= Qcursor_color
;
4357 else if (EQ (face
, Qmouse
))
4359 /* Changing background color of `mouse' sets frame parameter
4361 if (EQ (attr
, QCbackground
))
4362 param
= Qmouse_color
;
4364 #endif /* HAVE_WINDOW_SYSTEM */
4365 else if (EQ (face
, Qmenu
))
4367 /* Indicate that we have to update the menu bar when
4368 realizing faces on FRAME. FRAME t change the
4369 default for new frames. We do this by setting
4370 setting the flag in new face caches */
4373 struct frame
*f
= XFRAME (frame
);
4374 if (FRAME_FACE_CACHE (f
) == NULL
)
4375 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4376 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4379 menu_face_changed_default
= 1;
4385 /* Update `default-frame-alist', which is used for new frames. */
4387 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4390 /* Update the current frame's parameters. */
4393 cons
= XCAR (Vparam_value_alist
);
4394 XSETCAR (cons
, param
);
4395 XSETCDR (cons
, value
);
4396 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4405 #ifdef HAVE_WINDOW_SYSTEM
4407 /* Set the `font' frame parameter of FRAME determined from `default'
4408 face attributes LFACE. If a face or fontset name is explicitely
4409 specfied in LFACE, use it as is. Otherwise, determine a font name
4410 from the other font-related atrributes of LFACE. In that case, if
4411 there's no matching font, signals an error. */
4414 set_font_frame_param (frame
, lface
)
4415 Lisp_Object frame
, lface
;
4417 struct frame
*f
= XFRAME (frame
);
4419 if (FRAME_WINDOW_P (f
))
4421 Lisp_Object font_name
;
4424 if (STRINGP (LFACE_FONT (lface
)))
4425 font_name
= LFACE_FONT (lface
);
4428 /* Choose a font name that reflects LFACE's attributes and has
4429 the registry and encoding pattern specified in the default
4430 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4431 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4433 error ("No font matches the specified attribute");
4434 font_name
= build_string (font
);
4438 f
->default_face_done_p
= 0;
4439 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4444 /* Update the corresponding face when frame parameter PARAM on frame F
4445 has been assigned the value NEW_VALUE. */
4448 update_face_from_frame_parameter (f
, param
, new_value
)
4450 Lisp_Object param
, new_value
;
4454 /* If there are no faces yet, give up. This is the case when called
4455 from Fx_create_frame, and we do the necessary things later in
4456 face-set-after-frame-defaults. */
4457 if (NILP (f
->face_alist
))
4460 /* Changing a named face means that all realized faces depending on
4461 that face are invalid. Since we cannot tell which realized faces
4462 depend on the face, make sure they are all removed. This is done
4463 by incrementing face_change_count. The next call to
4464 init_iterator will then free realized faces. */
4465 ++face_change_count
;
4466 ++windows_or_buffers_changed
;
4468 if (EQ (param
, Qforeground_color
))
4470 lface
= lface_from_face_name (f
, Qdefault
, 1);
4471 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4472 ? new_value
: Qunspecified
);
4473 realize_basic_faces (f
);
4475 else if (EQ (param
, Qbackground_color
))
4479 /* Changing the background color might change the background
4480 mode, so that we have to load new defface specs. Call
4481 frame-update-face-colors to do that. */
4482 XSETFRAME (frame
, f
);
4483 call1 (Qframe_update_face_colors
, frame
);
4485 lface
= lface_from_face_name (f
, Qdefault
, 1);
4486 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4487 ? new_value
: Qunspecified
);
4488 realize_basic_faces (f
);
4490 if (EQ (param
, Qborder_color
))
4492 lface
= lface_from_face_name (f
, Qborder
, 1);
4493 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4494 ? new_value
: Qunspecified
);
4496 else if (EQ (param
, Qcursor_color
))
4498 lface
= lface_from_face_name (f
, Qcursor
, 1);
4499 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4500 ? new_value
: Qunspecified
);
4502 else if (EQ (param
, Qmouse_color
))
4504 lface
= lface_from_face_name (f
, Qmouse
, 1);
4505 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4506 ? new_value
: Qunspecified
);
4511 /* Get the value of X resource RESOURCE, class CLASS for the display
4512 of frame FRAME. This is here because ordinary `x-get-resource'
4513 doesn't take a frame argument. */
4515 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4516 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4517 (resource
, class, frame
)
4518 Lisp_Object resource
, class, frame
;
4520 Lisp_Object value
= Qnil
;
4521 CHECK_STRING (resource
);
4522 CHECK_STRING (class);
4523 CHECK_LIVE_FRAME (frame
);
4525 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4526 resource
, class, Qnil
, Qnil
);
4532 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4533 If VALUE is "on" or "true", return t. If VALUE is "off" or
4534 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4535 error; if SIGNAL_P is zero, return 0. */
4538 face_boolean_x_resource_value (value
, signal_p
)
4542 Lisp_Object result
= make_number (0);
4544 xassert (STRINGP (value
));
4546 if (xstricmp (SDATA (value
), "on") == 0
4547 || xstricmp (SDATA (value
), "true") == 0)
4549 else if (xstricmp (SDATA (value
), "off") == 0
4550 || xstricmp (SDATA (value
), "false") == 0)
4552 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4553 result
= Qunspecified
;
4555 signal_error ("Invalid face attribute value from X resource", value
);
4561 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4562 Finternal_set_lisp_face_attribute_from_resource
,
4563 Sinternal_set_lisp_face_attribute_from_resource
,
4564 3, 4, 0, doc
: /* */)
4565 (face
, attr
, value
, frame
)
4566 Lisp_Object face
, attr
, value
, frame
;
4568 CHECK_SYMBOL (face
);
4569 CHECK_SYMBOL (attr
);
4570 CHECK_STRING (value
);
4572 if (xstricmp (SDATA (value
), "unspecified") == 0)
4573 value
= Qunspecified
;
4574 else if (EQ (attr
, QCheight
))
4576 value
= Fstring_to_number (value
, make_number (10));
4577 if (XINT (value
) <= 0)
4578 signal_error ("Invalid face height from X resource", value
);
4580 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4581 value
= face_boolean_x_resource_value (value
, 1);
4582 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4583 value
= intern (SDATA (value
));
4584 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4585 value
= face_boolean_x_resource_value (value
, 1);
4586 else if (EQ (attr
, QCunderline
)
4587 || EQ (attr
, QCoverline
)
4588 || EQ (attr
, QCstrike_through
))
4590 Lisp_Object boolean_value
;
4592 /* If the result of face_boolean_x_resource_value is t or nil,
4593 VALUE does NOT specify a color. */
4594 boolean_value
= face_boolean_x_resource_value (value
, 0);
4595 if (SYMBOLP (boolean_value
))
4596 value
= boolean_value
;
4598 else if (EQ (attr
, QCbox
))
4599 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4601 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4604 #endif /* HAVE_WINDOW_SYSTEM */
4607 /***********************************************************************
4609 ***********************************************************************/
4611 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4613 /* Make menus on frame F appear as specified by the `menu' face. */
4616 x_update_menu_appearance (f
)
4619 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4623 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4627 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4628 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4629 const char *myname
= SDATA (Vx_resource_name
);
4632 const char *popup_path
= "popup_menu";
4634 const char *popup_path
= "menu.popup";
4637 if (STRINGP (LFACE_FOREGROUND (lface
)))
4639 sprintf (line
, "%s.%s*foreground: %s",
4641 SDATA (LFACE_FOREGROUND (lface
)));
4642 XrmPutLineResource (&rdb
, line
);
4643 sprintf (line
, "%s.pane.menubar*foreground: %s",
4644 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4645 XrmPutLineResource (&rdb
, line
);
4649 if (STRINGP (LFACE_BACKGROUND (lface
)))
4651 sprintf (line
, "%s.%s*background: %s",
4653 SDATA (LFACE_BACKGROUND (lface
)));
4654 XrmPutLineResource (&rdb
, line
);
4655 sprintf (line
, "%s.pane.menubar*background: %s",
4656 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4657 XrmPutLineResource (&rdb
, line
);
4662 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4663 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4664 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4665 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4666 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4667 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4670 const char *suffix
= "List";
4672 const char *suffix
= "";
4674 sprintf (line
, "%s.pane.menubar*font%s: %s",
4675 myname
, suffix
, face
->font_name
);
4676 XrmPutLineResource (&rdb
, line
);
4677 sprintf (line
, "%s.%s*font%s: %s",
4678 myname
, popup_path
, suffix
, face
->font_name
);
4679 XrmPutLineResource (&rdb
, line
);
4683 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4684 free_frame_menubar (f
);
4688 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4691 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4692 Sface_attribute_relative_p
,
4694 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4696 Lisp_Object attribute
, value
;
4698 if (EQ (value
, Qunspecified
))
4700 else if (EQ (attribute
, QCheight
))
4701 return INTEGERP (value
) ? Qnil
: Qt
;
4706 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4708 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4709 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4710 the result will be absolute, otherwise it will be relative. */)
4711 (attribute
, value1
, value2
)
4712 Lisp_Object attribute
, value1
, value2
;
4714 if (EQ (value1
, Qunspecified
))
4716 else if (EQ (attribute
, QCheight
))
4717 return merge_face_heights (value1
, value2
, value1
, Qnil
);
4723 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4724 Sinternal_get_lisp_face_attribute
,
4726 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4727 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4728 face attribute name, signal an error.
4729 If the optional argument FRAME is given, report on face SYMBOL in that
4730 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4731 frames). If FRAME is omitted or nil, use the selected frame. */)
4732 (symbol
, keyword
, frame
)
4733 Lisp_Object symbol
, keyword
, frame
;
4735 Lisp_Object lface
, value
= Qnil
;
4737 CHECK_SYMBOL (symbol
);
4738 CHECK_SYMBOL (keyword
);
4741 lface
= lface_from_face_name (NULL
, symbol
, 1);
4745 frame
= selected_frame
;
4746 CHECK_LIVE_FRAME (frame
);
4747 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4750 if (EQ (keyword
, QCfamily
))
4751 value
= LFACE_FAMILY (lface
);
4752 else if (EQ (keyword
, QCheight
))
4753 value
= LFACE_HEIGHT (lface
);
4754 else if (EQ (keyword
, QCweight
))
4755 value
= LFACE_WEIGHT (lface
);
4756 else if (EQ (keyword
, QCslant
))
4757 value
= LFACE_SLANT (lface
);
4758 else if (EQ (keyword
, QCunderline
))
4759 value
= LFACE_UNDERLINE (lface
);
4760 else if (EQ (keyword
, QCoverline
))
4761 value
= LFACE_OVERLINE (lface
);
4762 else if (EQ (keyword
, QCstrike_through
))
4763 value
= LFACE_STRIKE_THROUGH (lface
);
4764 else if (EQ (keyword
, QCbox
))
4765 value
= LFACE_BOX (lface
);
4766 else if (EQ (keyword
, QCinverse_video
)
4767 || EQ (keyword
, QCreverse_video
))
4768 value
= LFACE_INVERSE (lface
);
4769 else if (EQ (keyword
, QCforeground
))
4770 value
= LFACE_FOREGROUND (lface
);
4771 else if (EQ (keyword
, QCbackground
))
4772 value
= LFACE_BACKGROUND (lface
);
4773 else if (EQ (keyword
, QCstipple
))
4774 value
= LFACE_STIPPLE (lface
);
4775 else if (EQ (keyword
, QCwidth
))
4776 value
= LFACE_SWIDTH (lface
);
4777 else if (EQ (keyword
, QCinherit
))
4778 value
= LFACE_INHERIT (lface
);
4779 else if (EQ (keyword
, QCfont
))
4780 value
= LFACE_FONT (lface
);
4782 signal_error ("Invalid face attribute name", keyword
);
4788 DEFUN ("internal-lisp-face-attribute-values",
4789 Finternal_lisp_face_attribute_values
,
4790 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4791 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4792 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4796 Lisp_Object result
= Qnil
;
4798 CHECK_SYMBOL (attr
);
4800 if (EQ (attr
, QCweight
)
4801 || EQ (attr
, QCslant
)
4802 || EQ (attr
, QCwidth
))
4804 /* Extract permissible symbols from tables. */
4805 struct table_entry
*table
;
4808 if (EQ (attr
, QCweight
))
4809 table
= weight_table
, dim
= DIM (weight_table
);
4810 else if (EQ (attr
, QCslant
))
4811 table
= slant_table
, dim
= DIM (slant_table
);
4813 table
= swidth_table
, dim
= DIM (swidth_table
);
4815 for (i
= 0; i
< dim
; ++i
)
4817 Lisp_Object symbol
= *table
[i
].symbol
;
4818 Lisp_Object tail
= result
;
4821 && !EQ (XCAR (tail
), symbol
))
4825 result
= Fcons (symbol
, result
);
4828 else if (EQ (attr
, QCunderline
))
4829 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4830 else if (EQ (attr
, QCoverline
))
4831 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4832 else if (EQ (attr
, QCstrike_through
))
4833 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4834 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4835 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4841 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4842 Sinternal_merge_in_global_face
, 2, 2, 0,
4843 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4844 Default face attributes override any local face attributes. */)
4846 Lisp_Object face
, frame
;
4849 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4851 CHECK_LIVE_FRAME (frame
);
4852 global_lface
= lface_from_face_name (NULL
, face
, 1);
4853 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4854 if (NILP (local_lface
))
4855 local_lface
= Finternal_make_lisp_face (face
, frame
);
4857 /* Make every specified global attribute override the local one.
4858 BEWARE!! This is only used from `face-set-after-frame-default' where
4859 the local frame is defined from default specs in `face-defface-spec'
4860 and those should be overridden by global settings. Hence the strange
4861 "global before local" priority. */
4862 lvec
= XVECTOR (local_lface
)->contents
;
4863 gvec
= XVECTOR (global_lface
)->contents
;
4864 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4865 if (! UNSPECIFIEDP (gvec
[i
]))
4872 /* The following function is implemented for compatibility with 20.2.
4873 The function is used in x-resolve-fonts when it is asked to
4874 return fonts with the same size as the font of a face. This is
4875 done in fontset.el. */
4877 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4878 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4879 If the optional argument FRAME is given, report on face FACE in that frame.
4880 If FRAME is t, report on the defaults for face FACE (for new frames).
4881 The font default for a face is either nil, or a list
4882 of the form (bold), (italic) or (bold italic).
4883 If FRAME is omitted or nil, use the selected frame. */)
4885 Lisp_Object face
, frame
;
4889 Lisp_Object result
= Qnil
;
4890 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4892 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4893 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4894 result
= Fcons (Qbold
, result
);
4896 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4897 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4898 result
= Fcons (Qitalic
, result
);
4904 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4905 int face_id
= lookup_named_face (f
, face
, 0);
4906 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4907 return face
? build_string (face
->font_name
) : Qnil
;
4912 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
4913 all attributes are `equal'. Tries to be fast because this function
4914 is called quite often. */
4917 face_attr_equal_p (v1
, v2
)
4919 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
4920 and the other is specified. */
4921 if (XTYPE (v1
) != XTYPE (v2
))
4930 if (SBYTES (v1
) != SBYTES (v2
))
4933 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
4940 return !NILP (Fequal (v1
, v2
));
4945 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
4946 all attributes are `equal'. Tries to be fast because this function
4947 is called quite often. */
4950 lface_equal_p (v1
, v2
)
4951 Lisp_Object
*v1
, *v2
;
4955 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
4956 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
4962 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
4963 Sinternal_lisp_face_equal_p
, 2, 3, 0,
4964 doc
: /* True if FACE1 and FACE2 are equal.
4965 If the optional argument FRAME is given, report on face FACE in that frame.
4966 If FRAME is t, report on the defaults for face FACE (for new frames).
4967 If FRAME is omitted or nil, use the selected frame. */)
4968 (face1
, face2
, frame
)
4969 Lisp_Object face1
, face2
, frame
;
4973 Lisp_Object lface1
, lface2
;
4978 /* Don't use check_x_frame here because this function is called
4979 before X frames exist. At that time, if FRAME is nil,
4980 selected_frame will be used which is the frame dumped with
4981 Emacs. That frame is not an X frame. */
4982 f
= frame_or_selected_frame (frame
, 2);
4984 lface1
= lface_from_face_name (NULL
, face1
, 1);
4985 lface2
= lface_from_face_name (NULL
, face2
, 1);
4986 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
4987 XVECTOR (lface2
)->contents
);
4988 return equal_p
? Qt
: Qnil
;
4992 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
4993 Sinternal_lisp_face_empty_p
, 1, 2, 0,
4994 doc
: /* True if FACE has no attribute specified.
4995 If the optional argument FRAME is given, report on face FACE in that frame.
4996 If FRAME is t, report on the defaults for face FACE (for new frames).
4997 If FRAME is omitted or nil, use the selected frame. */)
4999 Lisp_Object face
, frame
;
5006 frame
= selected_frame
;
5007 CHECK_LIVE_FRAME (frame
);
5011 lface
= lface_from_face_name (NULL
, face
, 1);
5013 lface
= lface_from_face_name (f
, face
, 1);
5015 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5016 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5019 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5023 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5025 doc
: /* Return an alist of frame-local faces defined on FRAME.
5026 For internal use only. */)
5030 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5031 return f
->face_alist
;
5035 /* Return a hash code for Lisp string STRING with case ignored. Used
5036 below in computing a hash value for a Lisp face. */
5038 static INLINE
unsigned
5039 hash_string_case_insensitive (string
)
5042 const unsigned char *s
;
5044 xassert (STRINGP (string
));
5045 for (s
= SDATA (string
); *s
; ++s
)
5046 hash
= (hash
<< 1) ^ tolower (*s
);
5051 /* Return a hash code for face attribute vector V. */
5053 static INLINE
unsigned
5057 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5058 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5059 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5060 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5061 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5062 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5063 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5067 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5068 considering charsets/registries). They do if they specify the same
5069 family, point size, weight, width, slant, and fontset. Both LFACE1
5070 and LFACE2 must be fully-specified. */
5073 lface_same_font_attributes_p (lface1
, lface2
)
5074 Lisp_Object
*lface1
, *lface2
;
5076 xassert (lface_fully_specified_p (lface1
)
5077 && lface_fully_specified_p (lface2
));
5078 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5079 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5080 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5081 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5082 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5083 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5084 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5085 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5086 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5087 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5088 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5089 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5094 /***********************************************************************
5096 ***********************************************************************/
5098 /* Allocate and return a new realized face for Lisp face attribute
5101 static struct face
*
5102 make_realized_face (attr
)
5105 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5106 bzero (face
, sizeof *face
);
5107 face
->ascii_face
= face
;
5108 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5113 /* Free realized face FACE, including its X resources. FACE may
5117 free_realized_face (f
, face
)
5123 #ifdef HAVE_WINDOW_SYSTEM
5124 if (FRAME_WINDOW_P (f
))
5126 /* Free fontset of FACE if it is ASCII face. */
5127 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5128 free_face_fontset (f
, face
);
5131 x_free_gc (f
, face
->gc
);
5135 free_face_colors (f
, face
);
5136 x_destroy_bitmap (f
, face
->stipple
);
5138 #endif /* HAVE_WINDOW_SYSTEM */
5145 /* Prepare face FACE for subsequent display on frame F. This
5146 allocated GCs if they haven't been allocated yet or have been freed
5147 by clearing the face cache. */
5150 prepare_face_for_display (f
, face
)
5154 #ifdef HAVE_WINDOW_SYSTEM
5155 xassert (FRAME_WINDOW_P (f
));
5160 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5162 xgcv
.foreground
= face
->foreground
;
5163 xgcv
.background
= face
->background
;
5164 #ifdef HAVE_X_WINDOWS
5165 xgcv
.graphics_exposures
= False
;
5167 /* The font of FACE may be null if we couldn't load it. */
5170 #ifdef HAVE_X_WINDOWS
5171 xgcv
.font
= face
->font
->fid
;
5174 xgcv
.font
= face
->font
;
5177 xgcv
.font
= face
->font
;
5183 #ifdef HAVE_X_WINDOWS
5186 xgcv
.fill_style
= FillOpaqueStippled
;
5187 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5188 mask
|= GCFillStyle
| GCStipple
;
5191 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5194 #endif /* HAVE_WINDOW_SYSTEM */
5198 /* Returns the `distance' between the colors X and Y. */
5201 color_distance (x
, y
)
5204 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5205 Quoting from that paper:
5207 This formula has results that are very close to L*u*v* (with the
5208 modified lightness curve) and, more importantly, it is a more even
5209 algorithm: it does not have a range of colours where it suddenly
5210 gives far from optimal results.
5212 See <http://www.compuphase.com/cmetric.htm> for more info. */
5214 long r
= (x
->red
- y
->red
) >> 8;
5215 long g
= (x
->green
- y
->green
) >> 8;
5216 long b
= (x
->blue
- y
->blue
) >> 8;
5217 long r_mean
= (x
->red
+ y
->red
) >> 9;
5220 (((512 + r_mean
) * r
* r
) >> 8)
5222 + (((767 - r_mean
) * b
* b
) >> 8);
5226 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5227 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5228 COLOR1 and COLOR2 may be either strings containing the color name,
5229 or lists of the form (RED GREEN BLUE).
5230 If FRAME is unspecified or nil, the current frame is used. */)
5231 (color1
, color2
, frame
)
5232 Lisp_Object color1
, color2
, frame
;
5235 XColor cdef1
, cdef2
;
5238 frame
= selected_frame
;
5239 CHECK_LIVE_FRAME (frame
);
5242 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5243 || !STRINGP (color1
)
5244 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5245 signal_error ("Invalid color", color1
);
5246 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5247 || !STRINGP (color2
)
5248 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5249 signal_error ("Invalid color", color2
);
5251 return make_number (color_distance (&cdef1
, &cdef2
));
5255 /***********************************************************************
5257 ***********************************************************************/
5259 /* Return a new face cache for frame F. */
5261 static struct face_cache
*
5265 struct face_cache
*c
;
5268 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5269 bzero (c
, sizeof *c
);
5270 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5271 c
->buckets
= (struct face
**) xmalloc (size
);
5272 bzero (c
->buckets
, size
);
5274 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5276 c
->menu_face_changed_p
= menu_face_changed_default
;
5281 /* Clear out all graphics contexts for all realized faces, except for
5282 the basic faces. This should be done from time to time just to avoid
5283 keeping too many graphics contexts that are no longer needed. */
5287 struct face_cache
*c
;
5289 if (c
&& FRAME_WINDOW_P (c
->f
))
5291 #ifdef HAVE_WINDOW_SYSTEM
5293 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5295 struct face
*face
= c
->faces_by_id
[i
];
5296 if (face
&& face
->gc
)
5298 x_free_gc (c
->f
, face
->gc
);
5302 #endif /* HAVE_WINDOW_SYSTEM */
5307 /* Free all realized faces in face cache C, including basic faces.
5308 C may be null. If faces are freed, make sure the frame's current
5309 matrix is marked invalid, so that a display caused by an expose
5310 event doesn't try to use faces we destroyed. */
5313 free_realized_faces (c
)
5314 struct face_cache
*c
;
5319 struct frame
*f
= c
->f
;
5321 /* We must block input here because we can't process X events
5322 safely while only some faces are freed, or when the frame's
5323 current matrix still references freed faces. */
5326 for (i
= 0; i
< c
->used
; ++i
)
5328 free_realized_face (f
, c
->faces_by_id
[i
]);
5329 c
->faces_by_id
[i
] = NULL
;
5333 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5334 bzero (c
->buckets
, size
);
5336 /* Must do a thorough redisplay the next time. Mark current
5337 matrices as invalid because they will reference faces freed
5338 above. This function is also called when a frame is
5339 destroyed. In this case, the root window of F is nil. */
5340 if (WINDOWP (f
->root_window
))
5342 clear_current_matrices (f
);
5343 ++windows_or_buffers_changed
;
5351 /* Free all faces realized for multibyte characters on frame F that
5355 free_realized_multibyte_face (f
, fontset
)
5359 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5363 /* We must block input here because we can't process X events safely
5364 while only some faces are freed, or when the frame's current
5365 matrix still references freed faces. */
5368 for (i
= 0; i
< cache
->used
; i
++)
5370 face
= cache
->faces_by_id
[i
];
5372 && face
!= face
->ascii_face
5373 && face
->fontset
== fontset
)
5375 uncache_face (cache
, face
);
5376 free_realized_face (f
, face
);
5380 /* Must do a thorough redisplay the next time. Mark current
5381 matrices as invalid because they will reference faces freed
5382 above. This function is also called when a frame is destroyed.
5383 In this case, the root window of F is nil. */
5384 if (WINDOWP (f
->root_window
))
5386 clear_current_matrices (f
);
5387 ++windows_or_buffers_changed
;
5394 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5395 This is done after attributes of a named face have been changed,
5396 because we can't tell which realized faces depend on that face. */
5399 free_all_realized_faces (frame
)
5405 FOR_EACH_FRAME (rest
, frame
)
5406 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5409 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5413 /* Free face cache C and faces in it, including their X resources. */
5417 struct face_cache
*c
;
5421 free_realized_faces (c
);
5423 xfree (c
->faces_by_id
);
5429 /* Cache realized face FACE in face cache C. HASH is the hash value
5430 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5431 collision list of the face hash table of C. This is done because
5432 otherwise lookup_face would find FACE for every character, even if
5433 faces with the same attributes but for specific characters exist. */
5436 cache_face (c
, face
, hash
)
5437 struct face_cache
*c
;
5441 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5445 if (face
->fontset
>= 0)
5447 struct face
*last
= c
->buckets
[i
];
5458 c
->buckets
[i
] = face
;
5459 face
->prev
= face
->next
= NULL
;
5465 face
->next
= c
->buckets
[i
];
5467 face
->next
->prev
= face
;
5468 c
->buckets
[i
] = face
;
5471 /* Find a free slot in C->faces_by_id and use the index of the free
5472 slot as FACE->id. */
5473 for (i
= 0; i
< c
->used
; ++i
)
5474 if (c
->faces_by_id
[i
] == NULL
)
5478 /* Maybe enlarge C->faces_by_id. */
5481 if (c
->used
== c
->size
)
5484 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5485 if (new_size
== c
->size
)
5486 abort (); /* Alternatives? ++kfs */
5487 sz
= new_size
* sizeof *c
->faces_by_id
;
5488 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5495 /* Check that FACE got a unique id. */
5500 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5501 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5507 #endif /* GLYPH_DEBUG */
5509 c
->faces_by_id
[i
] = face
;
5513 /* Remove face FACE from cache C. */
5516 uncache_face (c
, face
)
5517 struct face_cache
*c
;
5520 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5523 face
->prev
->next
= face
->next
;
5525 c
->buckets
[i
] = face
->next
;
5528 face
->next
->prev
= face
->prev
;
5530 c
->faces_by_id
[face
->id
] = NULL
;
5531 if (face
->id
== c
->used
)
5536 /* Look up a realized face with face attributes ATTR in the face cache
5537 of frame F. The face will be used to display character C. Value
5538 is the ID of the face found. If no suitable face is found, realize
5539 a new one. In that case, if C is a multibyte character, BASE_FACE
5540 is a face that has the same attributes. */
5543 lookup_face (f
, attr
, c
, base_face
)
5547 struct face
*base_face
;
5549 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5554 xassert (cache
!= NULL
);
5555 check_lface_attrs (attr
);
5557 /* Look up ATTR in the face cache. */
5558 hash
= lface_hash (attr
);
5559 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5561 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5562 if (face
->hash
== hash
5563 && (!FRAME_WINDOW_P (f
)
5564 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5565 && lface_equal_p (face
->lface
, attr
))
5568 /* If not found, realize a new face. */
5570 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5573 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5575 /* When this function is called from face_for_char (in this case, C is
5576 a multibyte character), a fontset of a face returned by
5577 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5578 C) is not sutisfied. The fontset is set for this face by
5579 face_for_char later. */
5581 if (FRAME_WINDOW_P (f
))
5582 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5584 #endif /* GLYPH_DEBUG */
5590 /* Return the face id of the realized face for named face SYMBOL on
5591 frame F suitable for displaying character C. Value is -1 if the
5592 face couldn't be determined, which might happen if the default face
5593 isn't realized and cannot be realized. */
5596 lookup_named_face (f
, symbol
, c
)
5601 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5602 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5603 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5605 if (default_face
== NULL
)
5607 if (!realize_basic_faces (f
))
5609 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5612 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5613 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5614 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5616 return lookup_face (f
, attrs
, c
, NULL
);
5620 /* Return the ID of the realized ASCII face of Lisp face with ID
5621 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5624 ascii_face_of_lisp_face (f
, lface_id
)
5630 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5632 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5633 face_id
= lookup_named_face (f
, face_name
, 0);
5642 /* Return a face for charset ASCII that is like the face with id
5643 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5644 STEPS < 0 means larger. Value is the id of the face. */
5647 smaller_face (f
, face_id
, steps
)
5651 #ifdef HAVE_WINDOW_SYSTEM
5653 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5654 int pt
, last_pt
, last_height
;
5657 struct face
*new_face
;
5659 /* If not called for an X frame, just return the original face. */
5660 if (FRAME_TERMCAP_P (f
))
5663 /* Try in increments of 1/2 pt. */
5664 delta
= steps
< 0 ? 5 : -5;
5665 steps
= abs (steps
);
5667 face
= FACE_FROM_ID (f
, face_id
);
5668 bcopy (face
->lface
, attrs
, sizeof attrs
);
5669 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5670 new_face_id
= face_id
;
5671 last_height
= FONT_HEIGHT (face
->font
);
5675 /* Give up if we cannot find a font within 10pt. */
5676 && abs (last_pt
- pt
) < 100)
5678 /* Look up a face for a slightly smaller/larger font. */
5680 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5681 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5682 new_face
= FACE_FROM_ID (f
, new_face_id
);
5684 /* If height changes, count that as one step. */
5685 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5686 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5689 last_height
= FONT_HEIGHT (new_face
->font
);
5696 #else /* not HAVE_WINDOW_SYSTEM */
5700 #endif /* not HAVE_WINDOW_SYSTEM */
5704 /* Return a face for charset ASCII that is like the face with id
5705 FACE_ID on frame F, but has height HEIGHT. */
5708 face_with_height (f
, face_id
, height
)
5713 #ifdef HAVE_WINDOW_SYSTEM
5715 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5717 if (FRAME_TERMCAP_P (f
)
5721 face
= FACE_FROM_ID (f
, face_id
);
5722 bcopy (face
->lface
, attrs
, sizeof attrs
);
5723 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5724 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5725 #endif /* HAVE_WINDOW_SYSTEM */
5731 /* Return the face id of the realized face for named face SYMBOL on
5732 frame F suitable for displaying character C, and use attributes of
5733 the face FACE_ID for attributes that aren't completely specified by
5734 SYMBOL. This is like lookup_named_face, except that the default
5735 attributes come from FACE_ID, not from the default face. FACE_ID
5736 is assumed to be already realized. */
5739 lookup_derived_face (f
, symbol
, c
, face_id
)
5745 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5746 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5747 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5752 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5753 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5754 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5755 return lookup_face (f
, attrs
, c
, default_face
);
5758 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5759 Sface_attributes_as_vector
, 1, 1, 0,
5760 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5765 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5767 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5774 /***********************************************************************
5775 Face capability testing
5776 ***********************************************************************/
5779 /* If the distance (as returned by color_distance) between two colors is
5780 less than this, then they are considered the same, for determining
5781 whether a color is supported or not. The range of values is 0-65535. */
5783 #define TTY_SAME_COLOR_THRESHOLD 10000
5785 #ifdef HAVE_WINDOW_SYSTEM
5787 /* Return non-zero if all the face attributes in ATTRS are supported
5788 on the window-system frame F.
5790 The definition of `supported' is somewhat heuristic, but basically means
5791 that a face containing all the attributes in ATTRS, when merged with the
5792 default face for display, can be represented in a way that's
5794 \(1) different in appearance than the default face, and
5795 \(2) `close in spirit' to what the attributes specify, if not exact. */
5798 x_supports_face_attributes_p (f
, attrs
, def_face
)
5801 struct face
*def_face
;
5803 Lisp_Object
*def_attrs
= def_face
->lface
;
5805 /* Check that other specified attributes are different that the default
5807 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5808 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5809 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5810 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5811 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5812 def_attrs
[LFACE_INVERSE_INDEX
]))
5813 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5814 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5815 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5816 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5817 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5818 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5819 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5820 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5821 def_attrs
[LFACE_STIPPLE_INDEX
]))
5822 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5823 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5824 def_attrs
[LFACE_OVERLINE_INDEX
]))
5825 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5826 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5827 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5828 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5829 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5830 def_attrs
[LFACE_BOX_INDEX
])))
5833 /* Check font-related attributes, as those are the most commonly
5834 "unsupported" on a window-system (because of missing fonts). */
5835 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5836 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5837 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5838 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5839 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5840 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5843 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5845 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5847 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5849 face
= FACE_FROM_ID (f
, lookup_face (f
, merged_attrs
, 0, 0));
5852 signal_error ("cannot make face", 0);
5854 /* If the font is the same, then not supported. */
5855 if (face
->font
== def_face
->font
)
5859 /* Everything checks out, this face is supported. */
5863 #endif /* HAVE_WINDOW_SYSTEM */
5865 /* Return non-zero if all the face attributes in ATTRS are supported
5868 The definition of `supported' is somewhat heuristic, but basically means
5869 that a face containing all the attributes in ATTRS, when merged
5870 with the default face for display, can be represented in a way that's
5872 \(1) different in appearance than the default face, and
5873 \(2) `close in spirit' to what the attributes specify, if not exact.
5875 Point (2) implies that a `:weight black' attribute will be satisfied
5876 by any terminal that can display bold, and a `:foreground "yellow"' as
5877 long as the terminal can display a yellowish color, but `:slant italic'
5878 will _not_ be satisfied by the tty display code's automatic
5879 substitution of a `dim' face for italic. */
5882 tty_supports_face_attributes_p (f
, attrs
, def_face
)
5885 struct face
*def_face
;
5888 Lisp_Object val
, fg
, bg
;
5889 XColor fg_tty_color
, fg_std_color
;
5890 XColor bg_tty_color
, bg_std_color
;
5891 unsigned test_caps
= 0;
5892 Lisp_Object
*def_attrs
= def_face
->lface
;
5895 /* First check some easy-to-check stuff; ttys support none of the
5896 following attributes, so we can just return false if any are requested
5897 (even if `nominal' values are specified, we should still return false,
5898 as that will be the same value that the default face uses). We
5899 consider :slant unsupportable on ttys, even though the face code
5900 actually `fakes' them using a dim attribute if possible. This is
5901 because the faked result is too different from what the face
5903 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5904 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5905 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5906 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5907 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5908 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5909 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5910 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
5914 /* Test for terminal `capabilities' (non-color character attributes). */
5916 /* font weight (bold/dim) */
5917 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
5920 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
5922 if (weight
> XLFD_WEIGHT_MEDIUM
)
5924 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
5925 return 0; /* same as default */
5926 test_caps
= TTY_CAP_BOLD
;
5928 else if (weight
< XLFD_WEIGHT_MEDIUM
)
5930 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
5931 return 0; /* same as default */
5932 test_caps
= TTY_CAP_DIM
;
5934 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
5935 return 0; /* same as default */
5939 val
= attrs
[LFACE_UNDERLINE_INDEX
];
5940 if (!UNSPECIFIEDP (val
))
5943 return 0; /* ttys can't use colored underlines */
5944 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
5945 return 0; /* same as default */
5947 test_caps
|= TTY_CAP_UNDERLINE
;
5951 val
= attrs
[LFACE_INVERSE_INDEX
];
5952 if (!UNSPECIFIEDP (val
))
5954 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
5955 return 0; /* same as default */
5957 test_caps
|= TTY_CAP_INVERSE
;
5961 /* Color testing. */
5963 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
5964 we use them when calling `tty_capable_p' below, even if the face
5965 specifies no colors. */
5966 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
5967 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
5969 /* Check if foreground color is close enough. */
5970 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
5973 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
5975 if (face_attr_equal_p (fg
, def_fg
))
5976 return 0; /* same as default */
5977 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
5978 return 0; /* not a valid color */
5979 else if (color_distance (&fg_tty_color
, &fg_std_color
)
5980 > TTY_SAME_COLOR_THRESHOLD
)
5981 return 0; /* displayed color is too different */
5983 /* Make sure the color is really different than the default. */
5985 XColor def_fg_color
;
5986 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
5987 && (color_distance (&fg_tty_color
, &def_fg_color
)
5988 <= TTY_SAME_COLOR_THRESHOLD
))
5993 /* Check if background color is close enough. */
5994 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
5997 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
5999 if (face_attr_equal_p (bg
, def_bg
))
6000 return 0; /* same as default */
6001 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6002 return 0; /* not a valid color */
6003 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6004 > TTY_SAME_COLOR_THRESHOLD
)
6005 return 0; /* displayed color is too different */
6007 /* Make sure the color is really different than the default. */
6009 XColor def_bg_color
;
6010 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6011 && (color_distance (&bg_tty_color
, &def_bg_color
)
6012 <= TTY_SAME_COLOR_THRESHOLD
))
6017 /* If both foreground and background are requested, see if the
6018 distance between them is OK. We just check to see if the distance
6019 between the tty's foreground and background is close enough to the
6020 distance between the standard foreground and background. */
6021 if (STRINGP (fg
) && STRINGP (bg
))
6024 = (color_distance (&fg_std_color
, &bg_std_color
)
6025 - color_distance (&fg_tty_color
, &bg_tty_color
));
6026 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6027 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6032 /* See if the capabilities we selected above are supported, with the
6034 if (test_caps
!= 0 &&
6035 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6039 /* Hmmm, everything checks out, this terminal must support this face. */
6044 DEFUN ("display-supports-face-attributes-p",
6045 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6047 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6048 The optional argument DISPLAY can be a display name, a frame, or
6049 nil (meaning the selected frame's display)
6051 The definition of `supported' is somewhat heuristic, but basically means
6052 that a face containing all the attributes in ATTRIBUTES, when merged
6053 with the default face for display, can be represented in a way that's
6055 \(1) different in appearance than the default face, and
6056 \(2) `close in spirit' to what the attributes specify, if not exact.
6058 Point (2) implies that a `:weight black' attribute will be satisfied by
6059 any display that can display bold, and a `:foreground \"yellow\"' as long
6060 as it can display a yellowish color, but `:slant italic' will _not_ be
6061 satisfied by the tty display code's automatic substitution of a `dim'
6062 face for italic. */)
6063 (attributes
, display
)
6064 Lisp_Object attributes
, display
;
6069 struct face
*def_face
;
6070 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6072 if (noninteractive
|| !initialized
)
6073 /* We may not be able to access low-level face information in batch
6074 mode, or before being dumped, and this function is not going to
6075 be very useful in those cases anyway, so just give up. */
6079 frame
= selected_frame
;
6080 else if (FRAMEP (display
))
6084 /* Find any frame on DISPLAY. */
6085 Lisp_Object fl_tail
;
6088 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6090 frame
= XCAR (fl_tail
);
6091 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6092 XFRAME (frame
)->param_alist
)),
6098 CHECK_LIVE_FRAME (frame
);
6101 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6102 attrs
[i
] = Qunspecified
;
6103 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6105 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6106 if (def_face
== NULL
)
6108 if (! realize_basic_faces (f
))
6109 signal_error ("Cannot realize default face", 0);
6110 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6113 /* Dispatch to the appropriate handler. */
6114 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6115 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6116 #ifdef HAVE_WINDOW_SYSTEM
6118 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6121 return supports
? Qt
: Qnil
;
6125 /***********************************************************************
6127 ***********************************************************************/
6129 DEFUN ("internal-set-font-selection-order",
6130 Finternal_set_font_selection_order
,
6131 Sinternal_set_font_selection_order
, 1, 1, 0,
6132 doc
: /* Set font selection order for face font selection to ORDER.
6133 ORDER must be a list of length 4 containing the symbols `:width',
6134 `:height', `:weight', and `:slant'. Face attributes appearing
6135 first in ORDER are matched first, e.g. if `:height' appears before
6136 `:weight' in ORDER, font selection first tries to find a font with
6137 a suitable height, and then tries to match the font weight.
6144 int indices
[DIM (font_sort_order
)];
6147 bzero (indices
, sizeof indices
);
6151 CONSP (list
) && i
< DIM (indices
);
6152 list
= XCDR (list
), ++i
)
6154 Lisp_Object attr
= XCAR (list
);
6157 if (EQ (attr
, QCwidth
))
6159 else if (EQ (attr
, QCheight
))
6160 xlfd
= XLFD_POINT_SIZE
;
6161 else if (EQ (attr
, QCweight
))
6163 else if (EQ (attr
, QCslant
))
6168 if (indices
[i
] != 0)
6173 if (!NILP (list
) || i
!= DIM (indices
))
6174 signal_error ("Invalid font sort order", order
);
6175 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6176 if (indices
[i
] == 0)
6177 signal_error ("Invalid font sort order", order
);
6179 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6181 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6182 free_all_realized_faces (Qnil
);
6189 DEFUN ("internal-set-alternative-font-family-alist",
6190 Finternal_set_alternative_font_family_alist
,
6191 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6192 doc
: /* Define alternative font families to try in face font selection.
6193 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6194 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6195 be found. Value is ALIST. */)
6200 Vface_alternative_font_family_alist
= alist
;
6201 free_all_realized_faces (Qnil
);
6206 DEFUN ("internal-set-alternative-font-registry-alist",
6207 Finternal_set_alternative_font_registry_alist
,
6208 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6209 doc
: /* Define alternative font registries to try in face font selection.
6210 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6211 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6212 be found. Value is ALIST. */)
6217 Vface_alternative_font_registry_alist
= alist
;
6218 free_all_realized_faces (Qnil
);
6223 #ifdef HAVE_WINDOW_SYSTEM
6225 /* Value is non-zero if FONT is the name of a scalable font. The
6226 X11R6 XLFD spec says that point size, pixel size, and average width
6227 are zero for scalable fonts. Intlfonts contain at least one
6228 scalable font ("*-muleindian-1") for which this isn't true, so we
6229 just test average width. */
6232 font_scalable_p (font
)
6233 struct font_name
*font
;
6235 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6236 return (*s
== '0' && *(s
+ 1) == '\0')
6238 /* Windows implementation of XLFD is slightly broken for backward
6239 compatibility with previous broken versions, so test for
6240 wildcards as well as 0. */
6247 /* Ignore the difference of font point size less than this value. */
6249 #define FONT_POINT_SIZE_QUANTUM 5
6251 /* Value is non-zero if FONT1 is a better match for font attributes
6252 VALUES than FONT2. VALUES is an array of face attribute values in
6253 font sort order. COMPARE_PT_P zero means don't compare point
6254 sizes. AVGWIDTH, if not zero, is a specified font average width
6258 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6260 struct font_name
*font1
, *font2
;
6261 int compare_pt_p
, avgwidth
;
6265 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6267 int xlfd_idx
= font_sort_order
[i
];
6269 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6273 if (xlfd_idx
== XLFD_POINT_SIZE
)
6275 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6276 / font1
->rescale_ratio
));
6277 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6278 / font2
->rescale_ratio
));
6279 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6284 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6285 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6288 if (delta1
> delta2
)
6290 else if (delta1
< delta2
)
6294 /* The difference may be equal because, e.g., the face
6295 specifies `italic' but we have only `regular' and
6296 `oblique'. Prefer `oblique' in this case. */
6297 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6298 && font1
->numeric
[xlfd_idx
] > values
[i
]
6299 && font2
->numeric
[xlfd_idx
] < values
[i
])
6307 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6308 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6309 if (delta1
> delta2
)
6311 else if (delta1
< delta2
)
6317 /* We prefer a real scalable font; i.e. not what autoscaled. */
6318 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6319 && font1
->numeric
[XLFD_RESY
] > 0);
6320 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6321 && font2
->numeric
[XLFD_RESY
] > 0);
6323 if (auto_scaled_1
!= auto_scaled_2
)
6324 return auto_scaled_2
;
6327 return font1
->registry_priority
< font2
->registry_priority
;
6331 /* Value is non-zero if FONT is an exact match for face attributes in
6332 SPECIFIED. SPECIFIED is an array of face attribute values in font
6333 sort order. AVGWIDTH, if non-zero, is an average width to compare
6337 exact_face_match_p (specified
, font
, avgwidth
)
6339 struct font_name
*font
;
6344 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6345 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6348 return (i
== DIM (font_sort_order
)
6350 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6354 /* Value is the name of a scaled font, generated from scalable font
6355 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6356 Value is allocated from heap. */
6359 build_scalable_font_name (f
, font
, specified_pt
)
6361 struct font_name
*font
;
6364 char pixel_size
[20];
6366 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6369 /* If scalable font is for a specific resolution, compute
6370 the point size we must specify from the resolution of
6371 the display and the specified resolution of the font. */
6372 if (font
->numeric
[XLFD_RESY
] != 0)
6374 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6375 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
;
6380 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
;
6382 /* We may need a font of the different size. */
6383 pixel_value
*= font
->rescale_ratio
;
6385 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6386 font of the specified PIXEL_SIZE. */
6388 { /* Set point size of the font. */
6389 char point_size
[20];
6390 sprintf (point_size
, "%d", (int) pt
);
6391 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6392 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6396 /* Set pixel size. */
6397 sprintf (pixel_size
, "%d", pixel_value
);
6398 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6399 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6401 /* If font doesn't specify its resolution, use the
6402 resolution of the display. */
6403 if (font
->numeric
[XLFD_RESY
] == 0)
6406 sprintf (buffer
, "%d", (int) resy
);
6407 font
->fields
[XLFD_RESY
] = buffer
;
6408 font
->numeric
[XLFD_RESY
] = resy
;
6411 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6414 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6415 sprintf (buffer
, "%d", resx
);
6416 font
->fields
[XLFD_RESX
] = buffer
;
6417 font
->numeric
[XLFD_RESX
] = resx
;
6420 return build_font_name (font
);
6424 /* Value is non-zero if we are allowed to use scalable font FONT. We
6425 can't run a Lisp function here since this function may be called
6426 with input blocked. */
6429 may_use_scalable_font_p (font
)
6432 if (EQ (Vscalable_fonts_allowed
, Qt
))
6434 else if (CONSP (Vscalable_fonts_allowed
))
6436 Lisp_Object tail
, regexp
;
6438 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6440 regexp
= XCAR (tail
);
6441 if (STRINGP (regexp
)
6442 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6452 /* Return the name of the best matching font for face attributes ATTRS
6453 in the array of font_name structures FONTS which contains NFONTS
6454 elements. WIDTH_RATIO is a factor with which to multiply average
6455 widths if ATTRS specifies such a width.
6457 Value is a font name which is allocated from the heap. FONTS is
6458 freed by this function.
6460 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6461 indicate whether the resulting font should be drawn using overstrike
6462 to simulate bold-face. */
6465 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6468 struct font_name
*fonts
;
6471 int *needs_overstrike
;
6474 struct font_name
*best
;
6477 int exact_p
, avgwidth
;
6482 /* Make specified font attributes available in `specified',
6483 indexed by sort order. */
6484 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6486 int xlfd_idx
= font_sort_order
[i
];
6488 if (xlfd_idx
== XLFD_SWIDTH
)
6489 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6490 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6491 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6492 else if (xlfd_idx
== XLFD_WEIGHT
)
6493 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6494 else if (xlfd_idx
== XLFD_SLANT
)
6495 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6500 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6502 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6506 if (needs_overstrike
)
6507 *needs_overstrike
= 0;
6509 /* Start with the first non-scalable font in the list. */
6510 for (i
= 0; i
< nfonts
; ++i
)
6511 if (!font_scalable_p (fonts
+ i
))
6514 /* Find the best match among the non-scalable fonts. */
6519 for (i
= 1; i
< nfonts
; ++i
)
6520 if (!font_scalable_p (fonts
+ i
)
6521 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6525 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6533 /* Unless we found an exact match among non-scalable fonts, see if
6534 we can find a better match among scalable fonts. */
6537 /* A scalable font is better if
6539 1. its weight, slant, swidth attributes are better, or.
6541 2. the best non-scalable font doesn't have the required
6542 point size, and the scalable fonts weight, slant, swidth
6545 int non_scalable_has_exact_height_p
;
6547 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6548 non_scalable_has_exact_height_p
= 1;
6550 non_scalable_has_exact_height_p
= 0;
6552 for (i
= 0; i
< nfonts
; ++i
)
6553 if (font_scalable_p (fonts
+ i
))
6556 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6557 || (!non_scalable_has_exact_height_p
6558 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6560 non_scalable_has_exact_height_p
= 1;
6565 if (needs_overstrike
)
6567 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6568 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6570 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6572 /* We want a bold font, but didn't get one; try to use
6573 overstriking instead to simulate bold-face. However,
6574 don't overstrike an already-bold fontn unless the
6575 desired weight grossly exceeds the available weight. */
6576 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6577 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6579 *needs_overstrike
= 1;
6584 if (font_scalable_p (best
))
6585 font_name
= build_scalable_font_name (f
, best
, pt
);
6587 font_name
= build_font_name (best
);
6589 /* Free font_name structures. */
6590 free_font_names (fonts
, nfonts
);
6596 /* Get a list of matching fonts on frame F, considering FAMILY
6597 and alternative font families from Vface_alternative_font_registry_alist.
6599 FAMILY is the font family whose alternatives are considered.
6601 REGISTRY, if a string, specifies a font registry and encoding to
6602 match. A value of nil means include fonts of any registry and
6605 Return in *FONTS a pointer to a vector of font_name structures for
6606 the fonts matched. Value is the number of fonts found. */
6609 try_alternative_families (f
, family
, registry
, fonts
)
6611 Lisp_Object family
, registry
;
6612 struct font_name
**fonts
;
6617 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6620 /* Try alternative font families. */
6621 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6624 for (alter
= XCDR (alter
);
6625 CONSP (alter
) && nfonts
== 0;
6626 alter
= XCDR (alter
))
6628 if (STRINGP (XCAR (alter
)))
6629 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6633 /* Try all scalable fonts before giving up. */
6634 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6636 int count
= SPECPDL_INDEX ();
6637 specbind (Qscalable_fonts_allowed
, Qt
);
6638 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6639 unbind_to (count
, Qnil
);
6646 /* Get a list of matching fonts on frame F.
6648 FAMILY, if a string, specifies a font family derived from the fontset.
6649 It is only used if the face does not specify any family in ATTRS or
6650 if we cannot find any font of the face's family.
6652 REGISTRY, if a string, specifies a font registry and encoding to
6653 match. A value of nil means include fonts of any registry and
6656 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6657 Otherwise, prefer FAMILY.
6659 Return in *FONTS a pointer to a vector of font_name structures for
6660 the fonts matched. Value is the number of fonts found. */
6663 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6666 Lisp_Object family
, registry
;
6667 struct font_name
**fonts
;
6668 int prefer_face_family
;
6671 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6672 Lisp_Object try_family
;
6674 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6676 if (STRINGP (try_family
))
6677 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6680 /* When realizing the default face and a font spec does not matched
6681 exactly, Emacs looks for ones with the same registry as the
6682 default font. On the Mac, this is mac-roman, which does not work
6683 if the family is -etl-fixed, e.g. The following widens the
6684 choices and fixes that problem. */
6685 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
)
6686 && xstricmp (SDATA (registry
), "mac-roman") == 0)
6687 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6690 if (EQ (try_family
, family
))
6691 family
= face_family
;
6693 if (nfonts
== 0 && STRINGP (family
))
6694 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6696 /* Try font family of the default face or "fixed". */
6699 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6701 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6703 family
= build_string ("fixed");
6704 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6707 /* Try any family with the given registry. */
6709 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6715 /* Return the fontset id of the base fontset name or alias name given
6716 by the fontset attribute of ATTRS. Value is -1 if the fontset
6717 attribute of ATTRS doesn't name a fontset. */
6720 face_fontset (attrs
)
6725 name
= attrs
[LFACE_FONT_INDEX
];
6726 if (!STRINGP (name
))
6728 return fs_query_fontset (name
, 0);
6732 /* Choose a name of font to use on frame F to display character C with
6733 Lisp face attributes specified by ATTRS. The font name is
6734 determined by the font-related attributes in ATTRS and the name
6735 pattern for C in FONTSET. Value is the font name which is
6736 allocated from the heap and must be freed by the caller, or NULL if
6737 we can get no information about the font name of C. It is assured
6738 that we always get some information for a single byte
6741 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6742 indicate whether the resulting font should be drawn using overstrike
6743 to simulate bold-face. */
6746 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6750 int *needs_overstrike
;
6752 Lisp_Object pattern
;
6753 char *font_name
= NULL
;
6754 struct font_name
*fonts
;
6755 int nfonts
, width_ratio
;
6757 if (needs_overstrike
)
6758 *needs_overstrike
= 0;
6760 /* Get (foundry and) family name and registry (and encoding) name of
6762 pattern
= fontset_font_pattern (f
, fontset
, c
);
6765 xassert (!SINGLE_BYTE_CHAR_P (c
));
6769 /* If what we got is a name pattern, return it. */
6770 if (STRINGP (pattern
))
6771 return xstrdup (SDATA (pattern
));
6773 /* Get a list of fonts matching that pattern and choose the
6774 best match for the specified face attributes from it. */
6775 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6776 (SINGLE_BYTE_CHAR_P (c
)
6777 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6778 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6780 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6781 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6786 #endif /* HAVE_WINDOW_SYSTEM */
6790 /***********************************************************************
6792 ***********************************************************************/
6794 /* Realize basic faces on frame F. Value is zero if frame parameters
6795 of F don't contain enough information needed to realize the default
6799 realize_basic_faces (f
)
6803 int count
= SPECPDL_INDEX ();
6805 /* Block input here so that we won't be surprised by an X expose
6806 event, for instance, without having the faces set up. */
6808 specbind (Qscalable_fonts_allowed
, Qt
);
6810 if (realize_default_face (f
))
6812 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6813 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6814 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6815 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6816 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6817 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6818 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6819 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6820 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6821 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6823 /* Reflect changes in the `menu' face in menu bars. */
6824 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6826 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6827 #ifdef USE_X_TOOLKIT
6828 if (FRAME_WINDOW_P (f
))
6829 x_update_menu_appearance (f
);
6836 unbind_to (count
, Qnil
);
6842 /* Realize the default face on frame F. If the face is not fully
6843 specified, make it fully-specified. Attributes of the default face
6844 that are not explicitly specified are taken from frame parameters. */
6847 realize_default_face (f
)
6850 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6852 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6853 Lisp_Object frame_font
;
6856 /* If the `default' face is not yet known, create it. */
6857 lface
= lface_from_face_name (f
, Qdefault
, 0);
6861 XSETFRAME (frame
, f
);
6862 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6866 #ifdef HAVE_WINDOW_SYSTEM
6867 if (FRAME_WINDOW_P (f
))
6869 /* Set frame_font to the value of the `font' frame parameter. */
6870 frame_font
= Fassq (Qfont
, f
->param_alist
);
6871 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
6872 frame_font
= XCDR (frame_font
);
6873 set_lface_from_font_name (f
, lface
, frame_font
,
6874 f
->default_face_done_p
, 1);
6875 f
->default_face_done_p
= 1;
6877 #endif /* HAVE_WINDOW_SYSTEM */
6879 if (!FRAME_WINDOW_P (f
))
6881 LFACE_FAMILY (lface
) = build_string ("default");
6882 LFACE_SWIDTH (lface
) = Qnormal
;
6883 LFACE_HEIGHT (lface
) = make_number (1);
6884 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
6885 LFACE_WEIGHT (lface
) = Qnormal
;
6886 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
6887 LFACE_SLANT (lface
) = Qnormal
;
6888 LFACE_AVGWIDTH (lface
) = Qunspecified
;
6891 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
6892 LFACE_UNDERLINE (lface
) = Qnil
;
6894 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
6895 LFACE_OVERLINE (lface
) = Qnil
;
6897 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
6898 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
6900 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
6901 LFACE_BOX (lface
) = Qnil
;
6903 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
6904 LFACE_INVERSE (lface
) = Qnil
;
6906 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
6908 /* This function is called so early that colors are not yet
6909 set in the frame parameter list. */
6910 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
6912 if (CONSP (color
) && STRINGP (XCDR (color
)))
6913 LFACE_FOREGROUND (lface
) = XCDR (color
);
6914 else if (FRAME_WINDOW_P (f
))
6916 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6917 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
6922 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
6924 /* This function is called so early that colors are not yet
6925 set in the frame parameter list. */
6926 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
6927 if (CONSP (color
) && STRINGP (XCDR (color
)))
6928 LFACE_BACKGROUND (lface
) = XCDR (color
);
6929 else if (FRAME_WINDOW_P (f
))
6931 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6932 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
6937 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
6938 LFACE_STIPPLE (lface
) = Qnil
;
6940 /* Realize the face; it must be fully-specified now. */
6941 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
6942 check_lface (lface
);
6943 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
6944 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
6949 /* Realize basic faces other than the default face in face cache C.
6950 SYMBOL is the face name, ID is the face id the realized face must
6951 have. The default face must have been realized already. */
6954 realize_named_face (f
, symbol
, id
)
6959 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6960 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
6961 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6962 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6963 struct face
*new_face
;
6965 /* The default face must exist and be fully specified. */
6966 get_lface_attributes (f
, Qdefault
, attrs
, 1);
6967 check_lface_attrs (attrs
);
6968 xassert (lface_fully_specified_p (attrs
));
6970 /* If SYMBOL isn't know as a face, create it. */
6974 XSETFRAME (frame
, f
);
6975 lface
= Finternal_make_lisp_face (symbol
, frame
);
6978 /* Merge SYMBOL's face with the default face. */
6979 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
6980 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
6982 /* Realize the face. */
6983 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
6987 /* Realize the fully-specified face with attributes ATTRS in face
6988 cache CACHE for character C. If C is a multibyte character,
6989 BASE_FACE is a face that has the same attributes. Otherwise,
6990 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
6991 ID of face to remove before caching the new face. Value is a
6992 pointer to the newly created realized face. */
6994 static struct face
*
6995 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
6996 struct face_cache
*cache
;
6999 struct face
*base_face
;
7004 /* LFACE must be fully specified. */
7005 xassert (cache
!= NULL
);
7006 check_lface_attrs (attrs
);
7008 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7010 /* Remove the former face. */
7011 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7012 uncache_face (cache
, former_face
);
7013 free_realized_face (cache
->f
, former_face
);
7016 if (FRAME_WINDOW_P (cache
->f
))
7017 face
= realize_x_face (cache
, attrs
, c
, base_face
);
7018 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7019 face
= realize_tty_face (cache
, attrs
, c
);
7020 else if (FRAME_INITIAL_P (cache
->f
))
7022 /* Create a dummy face. */
7023 face
= make_realized_face (attrs
);
7028 /* Insert the new face. */
7029 cache_face (cache
, face
, lface_hash (attrs
));
7030 #ifdef HAVE_WINDOW_SYSTEM
7031 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
7032 load_face_font (cache
->f
, face
, c
);
7033 #endif /* HAVE_WINDOW_SYSTEM */
7038 /* Realize the fully-specified face with attributes ATTRS in face
7039 cache CACHE for character C. Do it for X frame CACHE->f. If C is
7040 a multibyte character, BASE_FACE is a face that has the same
7041 attributes. Otherwise, BASE_FACE is ignored. If the new face
7042 doesn't share font with the default face, a fontname is allocated
7043 from the heap and set in `font_name' of the new face, but it is not
7044 yet loaded here. Value is a pointer to the newly created realized
7047 static struct face
*
7048 realize_x_face (cache
, attrs
, c
, base_face
)
7049 struct face_cache
*cache
;
7052 struct face
*base_face
;
7054 #ifdef HAVE_WINDOW_SYSTEM
7055 struct face
*face
, *default_face
;
7057 Lisp_Object stipple
, overline
, strike_through
, box
;
7059 xassert (FRAME_WINDOW_P (cache
->f
));
7060 xassert (SINGLE_BYTE_CHAR_P (c
)
7063 /* Allocate a new realized face. */
7064 face
= make_realized_face (attrs
);
7068 /* If C is a multibyte character, we share all face attirbutes with
7069 BASE_FACE including the realized fontset. But, we must load a
7071 if (!SINGLE_BYTE_CHAR_P (c
))
7073 bcopy (base_face
, face
, sizeof *face
);
7076 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7077 face
->colors_copied_bitwise_p
= 1;
7079 /* to force realize_face to load font */
7084 /* Now we are realizing a face for ASCII (and unibyte) characters. */
7086 /* Determine the font to use. Most of the time, the font will be
7087 the same as the font of the default face, so try that first. */
7088 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7090 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
7091 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7093 face
->font
= default_face
->font
;
7094 face
->fontset
= default_face
->fontset
;
7095 face
->font_info_id
= default_face
->font_info_id
;
7096 face
->font_name
= default_face
->font_name
;
7097 face
->ascii_face
= face
;
7099 /* But, as we can't share the fontset, make a new realized
7100 fontset that has the same base fontset as of the default
7103 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
7107 /* If the face attribute ATTRS specifies a fontset, use it as
7108 the base of a new realized fontset. Otherwise, use the same
7109 base fontset as of the default face. The base determines
7110 registry and encoding of a font. It may also determine
7111 foundry and family. The other fields of font name pattern
7112 are constructed from ATTRS. */
7113 int fontset
= face_fontset (attrs
);
7115 if ((fontset
== -1) && default_face
)
7116 fontset
= default_face
->fontset
;
7117 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
7118 face
->font
= NULL
; /* to force realize_face to load font */
7121 /* Load colors, and set remaining attributes. */
7123 load_face_colors (f
, face
, attrs
);
7126 box
= attrs
[LFACE_BOX_INDEX
];
7129 /* A simple box of line width 1 drawn in color given by
7131 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7133 face
->box
= FACE_SIMPLE_BOX
;
7134 face
->box_line_width
= 1;
7136 else if (INTEGERP (box
))
7138 /* Simple box of specified line width in foreground color of the
7140 xassert (XINT (box
) != 0);
7141 face
->box
= FACE_SIMPLE_BOX
;
7142 face
->box_line_width
= XINT (box
);
7143 face
->box_color
= face
->foreground
;
7144 face
->box_color_defaulted_p
= 1;
7146 else if (CONSP (box
))
7148 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7149 being one of `raised' or `sunken'. */
7150 face
->box
= FACE_SIMPLE_BOX
;
7151 face
->box_color
= face
->foreground
;
7152 face
->box_color_defaulted_p
= 1;
7153 face
->box_line_width
= 1;
7157 Lisp_Object keyword
, value
;
7159 keyword
= XCAR (box
);
7167 if (EQ (keyword
, QCline_width
))
7169 if (INTEGERP (value
) && XINT (value
) != 0)
7170 face
->box_line_width
= XINT (value
);
7172 else if (EQ (keyword
, QCcolor
))
7174 if (STRINGP (value
))
7176 face
->box_color
= load_color (f
, face
, value
,
7178 face
->use_box_color_for_shadows_p
= 1;
7181 else if (EQ (keyword
, QCstyle
))
7183 if (EQ (value
, Qreleased_button
))
7184 face
->box
= FACE_RAISED_BOX
;
7185 else if (EQ (value
, Qpressed_button
))
7186 face
->box
= FACE_SUNKEN_BOX
;
7191 /* Text underline, overline, strike-through. */
7193 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7195 /* Use default color (same as foreground color). */
7196 face
->underline_p
= 1;
7197 face
->underline_defaulted_p
= 1;
7198 face
->underline_color
= 0;
7200 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7202 /* Use specified color. */
7203 face
->underline_p
= 1;
7204 face
->underline_defaulted_p
= 0;
7205 face
->underline_color
7206 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7207 LFACE_UNDERLINE_INDEX
);
7209 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7211 face
->underline_p
= 0;
7212 face
->underline_defaulted_p
= 0;
7213 face
->underline_color
= 0;
7216 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7217 if (STRINGP (overline
))
7219 face
->overline_color
7220 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7221 LFACE_OVERLINE_INDEX
);
7222 face
->overline_p
= 1;
7224 else if (EQ (overline
, Qt
))
7226 face
->overline_color
= face
->foreground
;
7227 face
->overline_color_defaulted_p
= 1;
7228 face
->overline_p
= 1;
7231 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7232 if (STRINGP (strike_through
))
7234 face
->strike_through_color
7235 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7236 LFACE_STRIKE_THROUGH_INDEX
);
7237 face
->strike_through_p
= 1;
7239 else if (EQ (strike_through
, Qt
))
7241 face
->strike_through_color
= face
->foreground
;
7242 face
->strike_through_color_defaulted_p
= 1;
7243 face
->strike_through_p
= 1;
7246 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7247 if (!NILP (stipple
))
7248 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7250 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7252 #endif /* HAVE_WINDOW_SYSTEM */
7256 /* Map a specified color of face FACE on frame F to a tty color index.
7257 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7258 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7259 default foreground/background colors. */
7262 map_tty_color (f
, face
, idx
, defaulted
)
7265 enum lface_attribute_index idx
;
7268 Lisp_Object frame
, color
, def
;
7269 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7270 unsigned long default_pixel
, default_other_pixel
, pixel
;
7272 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7276 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7277 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7281 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7282 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7285 XSETFRAME (frame
, f
);
7286 color
= face
->lface
[idx
];
7290 && CONSP (Vtty_defined_color_alist
)
7291 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7294 /* Associations in tty-defined-color-alist are of the form
7295 (NAME INDEX R G B). We need the INDEX part. */
7296 pixel
= XINT (XCAR (XCDR (def
)));
7299 if (pixel
== default_pixel
&& STRINGP (color
))
7301 pixel
= load_color (f
, face
, color
, idx
);
7303 #if defined (MSDOS) || defined (WINDOWSNT)
7304 /* If the foreground of the default face is the default color,
7305 use the foreground color defined by the frame. */
7307 if (FRAME_MSDOS_P (f
))
7310 if (pixel
== default_pixel
7311 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7314 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7316 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7317 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7320 else if (pixel
== default_other_pixel
)
7323 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7325 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7326 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7332 #endif /* MSDOS or WINDOWSNT */
7336 face
->foreground
= pixel
;
7338 face
->background
= pixel
;
7342 /* Realize the fully-specified face with attributes ATTRS in face
7343 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7344 pointer to the newly created realized face. */
7346 static struct face
*
7347 realize_tty_face (cache
, attrs
, c
)
7348 struct face_cache
*cache
;
7354 int face_colors_defaulted
= 0;
7355 struct frame
*f
= cache
->f
;
7357 /* Frame must be a termcap frame. */
7358 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7360 /* Allocate a new realized face. */
7361 face
= make_realized_face (attrs
);
7362 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7364 /* Map face attributes to TTY appearances. We map slant to
7365 dimmed text because we want italic text to appear differently
7366 and because dimmed text is probably used infrequently. */
7367 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7368 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7370 if (weight
> XLFD_WEIGHT_MEDIUM
)
7371 face
->tty_bold_p
= 1;
7372 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7373 face
->tty_dim_p
= 1;
7374 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7375 face
->tty_underline_p
= 1;
7376 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7377 face
->tty_reverse_p
= 1;
7379 /* Map color names to color indices. */
7380 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7381 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7383 /* Swap colors if face is inverse-video. If the colors are taken
7384 from the frame colors, they are already inverted, since the
7385 frame-creation function calls x-handle-reverse-video. */
7386 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7388 unsigned long tem
= face
->foreground
;
7389 face
->foreground
= face
->background
;
7390 face
->background
= tem
;
7393 if (tty_suppress_bold_inverse_default_colors_p
7395 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7396 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7397 face
->tty_bold_p
= 0;
7403 DEFUN ("tty-suppress-bold-inverse-default-colors",
7404 Ftty_suppress_bold_inverse_default_colors
,
7405 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7406 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7407 SUPPRESS non-nil means suppress it.
7408 This affects bold faces on TTYs whose foreground is the default background
7409 color of the display and whose background is the default foreground color.
7410 For such faces, the bold face attribute is ignored if this variable
7413 Lisp_Object suppress
;
7415 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7416 ++face_change_count
;
7422 /***********************************************************************
7424 ***********************************************************************/
7426 /* Return the ID of the face to use to display character CH with face
7427 property PROP on frame F in current_buffer. */
7430 compute_char_face (f
, ch
, prop
)
7437 if (NILP (current_buffer
->enable_multibyte_characters
))
7442 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7443 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7447 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7448 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7449 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7450 merge_face_ref (f
, prop
, attrs
, 1, 0);
7451 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7457 /* Return the face ID associated with buffer position POS for
7458 displaying ASCII characters. Return in *ENDPTR the position at
7459 which a different face is needed, as far as text properties and
7460 overlays are concerned. W is a window displaying current_buffer.
7462 REGION_BEG, REGION_END delimit the region, so it can be
7465 LIMIT is a position not to scan beyond. That is to limit the time
7466 this function can take.
7468 If MOUSE is non-zero, use the character's mouse-face, not its face.
7470 The face returned is suitable for displaying ASCII characters. */
7473 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7474 endptr
, limit
, mouse
)
7477 int region_beg
, region_end
;
7482 struct frame
*f
= XFRAME (w
->frame
);
7483 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7484 Lisp_Object prop
, position
;
7486 Lisp_Object
*overlay_vec
;
7489 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7490 Lisp_Object limit1
, end
;
7491 struct face
*default_face
;
7493 /* W must display the current buffer. We could write this function
7494 to use the frame and buffer of W, but right now it doesn't. */
7495 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7497 XSETFRAME (frame
, f
);
7498 XSETFASTINT (position
, pos
);
7501 if (pos
< region_beg
&& region_beg
< endpos
)
7502 endpos
= region_beg
;
7504 /* Get the `face' or `mouse_face' text property at POS, and
7505 determine the next position at which the property changes. */
7506 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7507 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7508 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7510 endpos
= XINT (end
);
7512 /* Look at properties from overlays. */
7516 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7517 if (next_overlay
< endpos
)
7518 endpos
= next_overlay
;
7523 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7525 /* Optimize common cases where we can use the default face. */
7528 && !(pos
>= region_beg
&& pos
< region_end
))
7529 return DEFAULT_FACE_ID
;
7531 /* Begin with attributes from the default face. */
7532 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7534 /* Merge in attributes specified via text properties. */
7536 merge_face_ref (f
, prop
, attrs
, 1, 0);
7538 /* Now merge the overlay data. */
7539 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7540 for (i
= 0; i
< noverlays
; i
++)
7545 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7547 merge_face_ref (f
, prop
, attrs
, 1, 0);
7549 oend
= OVERLAY_END (overlay_vec
[i
]);
7550 oendpos
= OVERLAY_POSITION (oend
);
7551 if (oendpos
< endpos
)
7555 /* If in the region, merge in the region face. */
7556 if (pos
>= region_beg
&& pos
< region_end
)
7558 merge_named_face (f
, Qregion
, attrs
, 0);
7560 if (region_end
< endpos
)
7561 endpos
= region_end
;
7566 /* Look up a realized face with the given face attributes,
7567 or realize a new one for ASCII characters. */
7568 return lookup_face (f
, attrs
, 0, NULL
);
7572 /* Compute the face at character position POS in Lisp string STRING on
7573 window W, for ASCII characters.
7575 If STRING is an overlay string, it comes from position BUFPOS in
7576 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7577 not an overlay string. W must display the current buffer.
7578 REGION_BEG and REGION_END give the start and end positions of the
7579 region; both are -1 if no region is visible.
7581 BASE_FACE_ID is the id of a face to merge with. For strings coming
7582 from overlays or the `display' property it is the face at BUFPOS.
7584 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7586 Set *ENDPTR to the next position where to check for faces in
7587 STRING; -1 if the face is constant from POS to the end of the
7590 Value is the id of the face to use. The face returned is suitable
7591 for displaying ASCII characters. */
7594 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7595 region_end
, endptr
, base_face_id
, mouse_p
)
7599 int region_beg
, region_end
;
7601 enum face_id base_face_id
;
7604 Lisp_Object prop
, position
, end
, limit
;
7605 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7606 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7607 struct face
*base_face
;
7608 int multibyte_p
= STRING_MULTIBYTE (string
);
7609 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7611 /* Get the value of the face property at the current position within
7612 STRING. Value is nil if there is no face property. */
7613 XSETFASTINT (position
, pos
);
7614 prop
= Fget_text_property (position
, prop_name
, string
);
7616 /* Get the next position at which to check for faces. Value of end
7617 is nil if face is constant all the way to the end of the string.
7618 Otherwise it is a string position where to check faces next.
7619 Limit is the maximum position up to which to check for property
7620 changes in Fnext_single_property_change. Strings are usually
7621 short, so set the limit to the end of the string. */
7622 XSETFASTINT (limit
, SCHARS (string
));
7623 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7625 *endptr
= XFASTINT (end
);
7629 base_face
= FACE_FROM_ID (f
, base_face_id
);
7630 xassert (base_face
);
7632 /* Optimize the default case that there is no face property and we
7633 are not in the region. */
7635 && (base_face_id
!= DEFAULT_FACE_ID
7636 /* BUFPOS <= 0 means STRING is not an overlay string, so
7637 that the region doesn't have to be taken into account. */
7639 || bufpos
< region_beg
7640 || bufpos
>= region_end
)
7642 /* We can't realize faces for different charsets differently
7643 if we don't have fonts, so we can stop here if not working
7644 on a window-system frame. */
7645 || !FRAME_WINDOW_P (f
)
7646 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7647 return base_face
->id
;
7649 /* Begin with attributes from the base face. */
7650 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7652 /* Merge in attributes specified via text properties. */
7654 merge_face_ref (f
, prop
, attrs
, 1, 0);
7656 /* If in the region, merge in the region face. */
7658 && bufpos
>= region_beg
7659 && bufpos
< region_end
)
7660 merge_named_face (f
, Qregion
, attrs
, 0);
7662 /* Look up a realized face with the given face attributes,
7663 or realize a new one for ASCII characters. */
7664 return lookup_face (f
, attrs
, 0, NULL
);
7669 /***********************************************************************
7671 ***********************************************************************/
7675 /* Print the contents of the realized face FACE to stderr. */
7678 dump_realized_face (face
)
7681 fprintf (stderr
, "ID: %d\n", face
->id
);
7682 #ifdef HAVE_X_WINDOWS
7683 fprintf (stderr
, "gc: %d\n", (int) face
->gc
);
7685 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7687 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7688 fprintf (stderr
, "background: 0x%lx (%s)\n",
7690 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7691 fprintf (stderr
, "font_name: %s (%s)\n",
7693 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7694 #ifdef HAVE_X_WINDOWS
7695 fprintf (stderr
, "font = %p\n", face
->font
);
7697 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7698 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7699 fprintf (stderr
, "underline: %d (%s)\n",
7701 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7702 fprintf (stderr
, "hash: %d\n", face
->hash
);
7703 fprintf (stderr
, "charset: %d\n", face
->charset
);
7707 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7715 fprintf (stderr
, "font selection order: ");
7716 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7717 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7718 fprintf (stderr
, "\n");
7720 fprintf (stderr
, "alternative fonts: ");
7721 debug_print (Vface_alternative_font_family_alist
);
7722 fprintf (stderr
, "\n");
7724 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7725 Fdump_face (make_number (i
));
7731 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7733 error ("Not a valid face");
7734 dump_realized_face (face
);
7741 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7742 0, 0, 0, doc
: /* */)
7745 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7746 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7747 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7751 #endif /* GLYPH_DEBUG != 0 */
7755 /***********************************************************************
7757 ***********************************************************************/
7762 Qface
= intern ("face");
7764 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7765 staticpro (&Qbitmap_spec_p
);
7766 Qframe_update_face_colors
= intern ("frame-update-face-colors");
7767 staticpro (&Qframe_update_face_colors
);
7769 /* Lisp face attribute keywords. */
7770 QCfamily
= intern (":family");
7771 staticpro (&QCfamily
);
7772 QCheight
= intern (":height");
7773 staticpro (&QCheight
);
7774 QCweight
= intern (":weight");
7775 staticpro (&QCweight
);
7776 QCslant
= intern (":slant");
7777 staticpro (&QCslant
);
7778 QCunderline
= intern (":underline");
7779 staticpro (&QCunderline
);
7780 QCinverse_video
= intern (":inverse-video");
7781 staticpro (&QCinverse_video
);
7782 QCreverse_video
= intern (":reverse-video");
7783 staticpro (&QCreverse_video
);
7784 QCforeground
= intern (":foreground");
7785 staticpro (&QCforeground
);
7786 QCbackground
= intern (":background");
7787 staticpro (&QCbackground
);
7788 QCstipple
= intern (":stipple");;
7789 staticpro (&QCstipple
);
7790 QCwidth
= intern (":width");
7791 staticpro (&QCwidth
);
7792 QCfont
= intern (":font");
7793 staticpro (&QCfont
);
7794 QCbold
= intern (":bold");
7795 staticpro (&QCbold
);
7796 QCitalic
= intern (":italic");
7797 staticpro (&QCitalic
);
7798 QCoverline
= intern (":overline");
7799 staticpro (&QCoverline
);
7800 QCstrike_through
= intern (":strike-through");
7801 staticpro (&QCstrike_through
);
7802 QCbox
= intern (":box");
7804 QCinherit
= intern (":inherit");
7805 staticpro (&QCinherit
);
7807 /* Symbols used for Lisp face attribute values. */
7808 QCcolor
= intern (":color");
7809 staticpro (&QCcolor
);
7810 QCline_width
= intern (":line-width");
7811 staticpro (&QCline_width
);
7812 QCstyle
= intern (":style");
7813 staticpro (&QCstyle
);
7814 Qreleased_button
= intern ("released-button");
7815 staticpro (&Qreleased_button
);
7816 Qpressed_button
= intern ("pressed-button");
7817 staticpro (&Qpressed_button
);
7818 Qnormal
= intern ("normal");
7819 staticpro (&Qnormal
);
7820 Qultra_light
= intern ("ultra-light");
7821 staticpro (&Qultra_light
);
7822 Qextra_light
= intern ("extra-light");
7823 staticpro (&Qextra_light
);
7824 Qlight
= intern ("light");
7825 staticpro (&Qlight
);
7826 Qsemi_light
= intern ("semi-light");
7827 staticpro (&Qsemi_light
);
7828 Qsemi_bold
= intern ("semi-bold");
7829 staticpro (&Qsemi_bold
);
7830 Qbold
= intern ("bold");
7832 Qextra_bold
= intern ("extra-bold");
7833 staticpro (&Qextra_bold
);
7834 Qultra_bold
= intern ("ultra-bold");
7835 staticpro (&Qultra_bold
);
7836 Qoblique
= intern ("oblique");
7837 staticpro (&Qoblique
);
7838 Qitalic
= intern ("italic");
7839 staticpro (&Qitalic
);
7840 Qreverse_oblique
= intern ("reverse-oblique");
7841 staticpro (&Qreverse_oblique
);
7842 Qreverse_italic
= intern ("reverse-italic");
7843 staticpro (&Qreverse_italic
);
7844 Qultra_condensed
= intern ("ultra-condensed");
7845 staticpro (&Qultra_condensed
);
7846 Qextra_condensed
= intern ("extra-condensed");
7847 staticpro (&Qextra_condensed
);
7848 Qcondensed
= intern ("condensed");
7849 staticpro (&Qcondensed
);
7850 Qsemi_condensed
= intern ("semi-condensed");
7851 staticpro (&Qsemi_condensed
);
7852 Qsemi_expanded
= intern ("semi-expanded");
7853 staticpro (&Qsemi_expanded
);
7854 Qexpanded
= intern ("expanded");
7855 staticpro (&Qexpanded
);
7856 Qextra_expanded
= intern ("extra-expanded");
7857 staticpro (&Qextra_expanded
);
7858 Qultra_expanded
= intern ("ultra-expanded");
7859 staticpro (&Qultra_expanded
);
7860 Qbackground_color
= intern ("background-color");
7861 staticpro (&Qbackground_color
);
7862 Qforeground_color
= intern ("foreground-color");
7863 staticpro (&Qforeground_color
);
7864 Qunspecified
= intern ("unspecified");
7865 staticpro (&Qunspecified
);
7867 Qface_alias
= intern ("face-alias");
7868 staticpro (&Qface_alias
);
7869 Qdefault
= intern ("default");
7870 staticpro (&Qdefault
);
7871 Qtool_bar
= intern ("tool-bar");
7872 staticpro (&Qtool_bar
);
7873 Qregion
= intern ("region");
7874 staticpro (&Qregion
);
7875 Qfringe
= intern ("fringe");
7876 staticpro (&Qfringe
);
7877 Qheader_line
= intern ("header-line");
7878 staticpro (&Qheader_line
);
7879 Qscroll_bar
= intern ("scroll-bar");
7880 staticpro (&Qscroll_bar
);
7881 Qmenu
= intern ("menu");
7883 Qcursor
= intern ("cursor");
7884 staticpro (&Qcursor
);
7885 Qborder
= intern ("border");
7886 staticpro (&Qborder
);
7887 Qmouse
= intern ("mouse");
7888 staticpro (&Qmouse
);
7889 Qmode_line_inactive
= intern ("mode-line-inactive");
7890 staticpro (&Qmode_line_inactive
);
7891 Qtty_color_desc
= intern ("tty-color-desc");
7892 staticpro (&Qtty_color_desc
);
7893 Qtty_color_standard_values
= intern ("tty-color-standard-values");
7894 staticpro (&Qtty_color_standard_values
);
7895 Qtty_color_by_index
= intern ("tty-color-by-index");
7896 staticpro (&Qtty_color_by_index
);
7897 Qtty_color_alist
= intern ("tty-color-alist");
7898 staticpro (&Qtty_color_alist
);
7899 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
7900 staticpro (&Qscalable_fonts_allowed
);
7902 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
7903 staticpro (&Vparam_value_alist
);
7904 Vface_alternative_font_family_alist
= Qnil
;
7905 staticpro (&Vface_alternative_font_family_alist
);
7906 Vface_alternative_font_registry_alist
= Qnil
;
7907 staticpro (&Vface_alternative_font_registry_alist
);
7909 defsubr (&Sinternal_make_lisp_face
);
7910 defsubr (&Sinternal_lisp_face_p
);
7911 defsubr (&Sinternal_set_lisp_face_attribute
);
7912 #ifdef HAVE_WINDOW_SYSTEM
7913 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
7915 defsubr (&Scolor_gray_p
);
7916 defsubr (&Scolor_supported_p
);
7917 defsubr (&Sface_attribute_relative_p
);
7918 defsubr (&Smerge_face_attribute
);
7919 defsubr (&Sinternal_get_lisp_face_attribute
);
7920 defsubr (&Sinternal_lisp_face_attribute_values
);
7921 defsubr (&Sinternal_lisp_face_equal_p
);
7922 defsubr (&Sinternal_lisp_face_empty_p
);
7923 defsubr (&Sinternal_copy_lisp_face
);
7924 defsubr (&Sinternal_merge_in_global_face
);
7925 defsubr (&Sface_font
);
7926 defsubr (&Sframe_face_alist
);
7927 defsubr (&Sdisplay_supports_face_attributes_p
);
7928 defsubr (&Scolor_distance
);
7929 defsubr (&Sinternal_set_font_selection_order
);
7930 defsubr (&Sinternal_set_alternative_font_family_alist
);
7931 defsubr (&Sinternal_set_alternative_font_registry_alist
);
7932 defsubr (&Sface_attributes_as_vector
);
7934 defsubr (&Sdump_face
);
7935 defsubr (&Sshow_face_resources
);
7936 #endif /* GLYPH_DEBUG */
7937 defsubr (&Sclear_face_cache
);
7938 defsubr (&Stty_suppress_bold_inverse_default_colors
);
7940 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
7941 defsubr (&Sdump_colors
);
7944 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
7945 doc
: /* *Limit for font matching.
7946 If an integer > 0, font matching functions won't load more than
7947 that number of fonts when searching for a matching font. */);
7948 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
7950 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
7951 doc
: /* List of global face definitions (for internal use only.) */);
7952 Vface_new_frame_defaults
= Qnil
;
7954 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
7955 doc
: /* *Default stipple pattern used on monochrome displays.
7956 This stipple pattern is used on monochrome displays
7957 instead of shades of gray for a face background color.
7958 See `set-face-stipple' for possible values for this variable. */);
7959 Vface_default_stipple
= build_string ("gray3");
7961 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
7962 doc
: /* An alist of defined terminal colors and their RGB values. */);
7963 Vtty_defined_color_alist
= Qnil
;
7965 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
7966 doc
: /* Allowed scalable fonts.
7967 A value of nil means don't allow any scalable fonts.
7968 A value of t means allow any scalable font.
7969 Otherwise, value must be a list of regular expressions. A font may be
7970 scaled if its name matches a regular expression in the list.
7971 Note that if value is nil, a scalable font might still be used, if no
7972 other font of the appropriate family and registry is available. */);
7973 Vscalable_fonts_allowed
= Qnil
;
7975 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
7976 doc
: /* List of ignored fonts.
7977 Each element is a regular expression that matches names of fonts to
7979 Vface_ignored_fonts
= Qnil
;
7981 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
7982 doc
: /* Alist of fonts vs the rescaling factors.
7983 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
7984 FONT-NAME-PATTERN is a regular expression matching a font name, and
7985 RESCALE-RATIO is a floating point number to specify how much larger
7986 \(or smaller) font we should use. For instance, if a face requests
7987 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
7988 Vface_font_rescale_alist
= Qnil
;
7990 #ifdef HAVE_WINDOW_SYSTEM
7991 defsubr (&Sbitmap_spec_p
);
7992 defsubr (&Sx_list_fonts
);
7993 defsubr (&Sinternal_face_x_get_resource
);
7994 defsubr (&Sx_family_fonts
);
7995 defsubr (&Sx_font_family_list
);
7996 #endif /* HAVE_WINDOW_SYSTEM */
7999 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8000 (do not change this comment) */