1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 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., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
77 Faces are frame-local by nature because Emacs allows to define the
78 same named face (face names are symbols) differently for different
79 frames. Each frame has an alist of face definitions for all named
80 faces. The value of a named face in such an alist is a Lisp vector
81 with the symbol `face' in slot 0, and a slot for each of the face
82 attributes mentioned above.
84 There is also a global face alist `Vface_new_frame_defaults'. Face
85 definitions from this list are used to initialize faces of newly
88 A face doesn't have to specify all attributes. Those not specified
89 have a value of `unspecified'. Faces specifying all attributes but
90 the 14th are called `fully-specified'.
95 The display style of a given character in the text is determined by
96 combining several faces. This process is called `face merging'.
97 Any aspect of the display style that isn't specified by overlays or
98 text properties is taken from the `default' face. Since it is made
99 sure that the default face is always fully-specified, face merging
100 always results in a fully-specified face.
105 After all face attributes for a character have been determined by
106 merging faces of that character, that face is `realized'. The
107 realization process maps face attributes to what is physically
108 available on the system where Emacs runs. The result is a
109 `realized face' in form of a struct face which is stored in the
110 face cache of the frame on which it was realized.
112 Face realization is done in the context of the character to display
113 because different fonts may be used for different characters. In
114 other words, for characters that have different font
115 specifications, different realized faces are needed to display
118 Font specification is done by fontsets. See the comment in
119 fontset.c for the details. In the current implementation, all ASCII
120 characters share the same font in a fontset.
122 Faces are at first realized for ASCII characters, and, at that
123 time, assigned a specific realized fontset. Hereafter, we call
124 such a face as `ASCII face'. When a face for a multibyte character
125 is realized, it inherits (thus shares) a fontset of an ASCII face
126 that has the same attributes other than font-related ones.
128 Thus, all realized faces have a realized fontset.
133 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
134 font as ASCII characters. That is because it is expected that
135 unibyte text users specify a font that is suitable both for ASCII
136 and raw 8-bit characters.
141 Font selection tries to find the best available matching font for a
142 given (character, face) combination.
144 If the face specifies a fontset name, that fontset determines a
145 pattern for fonts of the given character. If the face specifies a
146 font name or the other font-related attributes, a fontset is
147 realized from the default fontset. In that case, that
148 specification determines a pattern for ASCII characters and the
149 default fontset determines a pattern for multibyte characters.
151 Available fonts on the system on which Emacs runs are then matched
152 against the font pattern. The result of font selection is the best
153 match for the given face attributes in this font list.
155 Font selection can be influenced by the user.
157 1. The user can specify the relative importance he gives the face
158 attributes width, height, weight, and slant by setting
159 face-font-selection-order (faces.el) to a list of face attribute
160 names. The default is '(:width :height :weight :slant), and means
161 that font selection first tries to find a good match for the font
162 width specified by a face, then---within fonts with that
163 width---tries to find a best match for the specified font height,
166 2. Setting face-font-family-alternatives allows the user to
167 specify alternative font families to try if a family specified by a
170 3. Setting face-font-registry-alternatives allows the user to
171 specify all alternative font registries to try for a face
172 specifying a registry.
174 4. Setting face-ignored-fonts allows the user to ignore specific
178 Character composition.
180 Usually, the realization process is already finished when Emacs
181 actually reflects the desired glyph matrix on the screen. However,
182 on displaying a composition (sequence of characters to be composed
183 on the screen), a suitable font for the components of the
184 composition is selected and realized while drawing them on the
185 screen, i.e. the realization process is delayed but in principle
189 Initialization of basic faces.
191 The faces `default', `modeline' are considered `basic faces'.
192 When redisplay happens the first time for a newly created frame,
193 basic faces are realized for CHARSET_ASCII. Frame parameters are
194 used to fill in unspecified attributes of the default face. */
198 #include <sys/types.h>
199 #include <sys/stat.h>
202 #include "character.h"
204 #include "keyboard.h"
207 #ifdef HAVE_WINDOW_SYSTEM
209 #endif /* HAVE_WINDOW_SYSTEM */
211 #ifdef HAVE_X_WINDOWS
215 #include <Xm/XmStrDefs.h>
216 #endif /* USE_MOTIF */
217 #endif /* HAVE_X_WINDOWS */
226 /* Redefine X specifics to W32 equivalents to avoid cluttering the
227 code with #ifdef blocks. */
228 #undef FRAME_X_DISPLAY_INFO
229 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
230 #define x_display_info w32_display_info
231 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
232 #define check_x check_w32
233 #define x_list_fonts w32_list_fonts
234 #define GCGraphicsExposures 0
235 #endif /* WINDOWSNT */
239 #define x_display_info mac_display_info
240 #define check_x check_mac
244 #include "dispextern.h"
245 #include "blockinput.h"
247 #include "intervals.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 /* Non-zero if face attribute ATTR is `ignore-defface'. */
282 #define IGNORE_DEFFACE_P(ATTR) EQ ((ATTR), Qignore_defface)
284 /* Value is the number of elements of VECTOR. */
286 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
288 /* Make a copy of string S on the stack using alloca. Value is a pointer
291 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
293 /* Make a copy of the contents of Lisp string S on the stack using
294 alloca. Value is a pointer to the copy. */
296 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
298 /* Size of hash table of realized faces in face caches (should be a
301 #define FACE_CACHE_BUCKETS_SIZE 1001
303 /* Keyword symbols used for face attribute names. */
305 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
306 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
307 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
308 Lisp_Object QCreverse_video
;
309 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
310 Lisp_Object QCfontset
;
312 /* Symbols used for attribute values. */
314 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
315 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
316 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
317 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
318 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
319 Lisp_Object Qultra_expanded
;
320 Lisp_Object Qreleased_button
, Qpressed_button
;
321 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
322 Lisp_Object Qunspecified
;
323 Lisp_Object Qignore_defface
;
325 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
327 /* The name of the function to call when the background of the frame
328 has changed, frame_set_background_mode. */
330 Lisp_Object Qframe_set_background_mode
;
332 /* Names of basic faces. */
334 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
335 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
336 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
337 extern Lisp_Object Qmode_line
;
339 /* The symbol `face-alias'. A symbols having that property is an
340 alias for another face. Value of the property is the name of
343 Lisp_Object Qface_alias
;
345 extern Lisp_Object Qcircular_list
;
347 /* Default stipple pattern used on monochrome displays. This stipple
348 pattern is used on monochrome displays instead of shades of gray
349 for a face background color. See `set-face-stipple' for possible
350 values for this variable. */
352 Lisp_Object Vface_default_stipple
;
354 /* Alist of alternative font families. Each element is of the form
355 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
356 try FAMILY1, then FAMILY2, ... */
358 Lisp_Object Vface_alternative_font_family_alist
;
360 /* Alist of alternative font registries. Each element is of the form
361 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
362 loaded, try REGISTRY1, then REGISTRY2, ... */
364 Lisp_Object Vface_alternative_font_registry_alist
;
366 /* Allowed scalable fonts. A value of nil means don't allow any
367 scalable fonts. A value of t means allow the use of any scalable
368 font. Otherwise, value must be a list of regular expressions. A
369 font may be scaled if its name matches a regular expression in the
372 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
374 /* List of regular expressions that matches names of fonts to ignore. */
376 Lisp_Object Vface_ignored_fonts
;
378 /* Alist of font name patterns vs the rescaling factor. */
380 Lisp_Object Vface_font_rescale_alist
;
382 /* Maximum number of fonts to consider in font_list. If not an
383 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
385 Lisp_Object Vfont_list_limit
;
386 #define DEFAULT_FONT_LIST_LIMIT 100
388 /* The symbols `foreground-color' and `background-color' which can be
389 used as part of a `face' property. This is for compatibility with
392 Lisp_Object Qforeground_color
, Qbackground_color
;
394 /* The symbols `face' and `mouse-face' used as text properties. */
397 extern Lisp_Object Qmouse_face
;
399 /* Property for basic faces which other faces cannot inherit. */
401 Lisp_Object Qface_no_inherit
;
403 /* Error symbol for wrong_type_argument in load_pixmap. */
405 Lisp_Object Qbitmap_spec_p
;
407 /* Alist of global face definitions. Each element is of the form
408 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
409 is a Lisp vector of face attributes. These faces are used
410 to initialize faces for new frames. */
412 Lisp_Object Vface_new_frame_defaults
;
414 /* The next ID to assign to Lisp faces. */
416 static int next_lface_id
;
418 /* A vector mapping Lisp face Id's to face names. */
420 static Lisp_Object
*lface_id_to_name
;
421 static int lface_id_to_name_size
;
423 /* TTY color-related functions (defined in tty-colors.el). */
425 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
427 /* The name of the function used to compute colors on TTYs. */
429 Lisp_Object Qtty_color_alist
;
431 /* An alist of defined terminal colors and their RGB values. */
433 Lisp_Object Vtty_defined_color_alist
;
435 /* Counter for calls to clear_face_cache. If this counter reaches
436 CLEAR_FONT_TABLE_COUNT, and a frame has more than
437 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
439 static int clear_font_table_count
;
440 #define CLEAR_FONT_TABLE_COUNT 100
441 #define CLEAR_FONT_TABLE_NFONTS 10
443 /* Non-zero means face attributes have been changed since the last
444 redisplay. Used in redisplay_internal. */
446 int face_change_count
;
448 /* Non-zero means don't display bold text if a face's foreground
449 and background colors are the inverse of the default colors of the
450 display. This is a kluge to suppress `bold black' foreground text
451 which is hard to read on an LCD monitor. */
453 int tty_suppress_bold_inverse_default_colors_p
;
455 /* A list of the form `((x . y))' used to avoid consing in
456 Finternal_set_lisp_face_attribute. */
458 static Lisp_Object Vparam_value_alist
;
460 /* The total number of colors currently allocated. */
463 static int ncolors_allocated
;
464 static int npixmaps_allocated
;
468 /* Non-zero means the definition of the `menu' face for new frames has
471 int menu_face_changed_default
;
474 /* Function prototypes. */
478 struct named_merge_point
;
480 static void map_tty_color
P_ ((struct frame
*, struct face
*,
481 enum lface_attribute_index
, int *));
482 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
483 static int may_use_scalable_font_p
P_ ((const char *));
484 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
485 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
487 static int x_face_list_fonts
P_ ((struct frame
*, char *,
488 struct font_name
**, int, int));
489 static int font_scalable_p
P_ ((struct font_name
*));
490 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
491 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
492 static unsigned char *xstrlwr
P_ ((unsigned char *));
493 static void signal_error
P_ ((char *, Lisp_Object
));
494 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
495 static void load_face_font
P_ ((struct frame
*, struct face
*));
496 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
497 static void free_face_colors
P_ ((struct frame
*, struct face
*));
498 static int face_color_gray_p
P_ ((struct frame
*, char *));
499 static char *build_font_name
P_ ((struct font_name
*));
500 static void free_font_names
P_ ((struct font_name
*, int));
501 static int sorted_font_list
P_ ((struct frame
*, char *,
502 int (*cmpfn
) P_ ((const void *, const void *)),
503 struct font_name
**));
504 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
505 Lisp_Object
, struct font_name
**));
506 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
507 Lisp_Object
, struct font_name
**));
508 static int try_font_list
P_ ((struct frame
*, Lisp_Object
,
509 Lisp_Object
, Lisp_Object
, struct font_name
**));
510 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
511 Lisp_Object
, struct font_name
**));
512 static int cmp_font_names
P_ ((const void *, const void *));
513 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*,
515 static struct face
*realize_non_ascii_face
P_ ((struct frame
*, int,
517 static struct face
*realize_x_face
P_ ((struct face_cache
*, Lisp_Object
*));
518 static struct face
*realize_tty_face
P_ ((struct face_cache
*, Lisp_Object
*));
519 static int realize_basic_faces
P_ ((struct frame
*));
520 static int realize_default_face
P_ ((struct frame
*));
521 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
522 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
523 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
524 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
525 static unsigned lface_hash
P_ ((Lisp_Object
*));
526 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
527 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
528 static void clear_face_gcs
P_ ((struct face_cache
*));
529 static void free_face_cache
P_ ((struct face_cache
*));
530 static int face_numeric_weight
P_ ((Lisp_Object
));
531 static int face_numeric_slant
P_ ((Lisp_Object
));
532 static int face_numeric_swidth
P_ ((Lisp_Object
));
533 static int face_fontset
P_ ((Lisp_Object
*));
534 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
535 struct named_merge_point
*));
536 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
537 int, struct named_merge_point
*));
538 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
539 Lisp_Object
, int, int));
540 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
541 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
542 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
543 struct font_name
*, int, int, int *));
544 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
545 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
546 static int xlfd_numeric_slant
P_ ((struct font_name
*));
547 static int xlfd_numeric_weight
P_ ((struct font_name
*));
548 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
549 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
550 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
551 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
552 static int xlfd_fixed_p
P_ ((struct font_name
*));
553 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
555 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
556 struct font_name
*, int,
558 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
559 struct font_name
*, int));
561 #ifdef HAVE_WINDOW_SYSTEM
563 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
564 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
565 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
566 int (*cmpfn
) P_ ((const void *, const void *))));
567 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
568 static void x_free_gc
P_ ((struct frame
*, GC
));
569 static void clear_font_table
P_ ((struct x_display_info
*));
572 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
573 #endif /* WINDOWSNT */
576 static void x_update_menu_appearance
P_ ((struct frame
*));
578 extern void free_frame_menubar
P_ ((struct frame
*));
579 #endif /* USE_X_TOOLKIT */
581 #endif /* HAVE_WINDOW_SYSTEM */
584 /***********************************************************************
586 ***********************************************************************/
588 #ifdef HAVE_X_WINDOWS
590 #ifdef DEBUG_X_COLORS
592 /* The following is a poor mans infrastructure for debugging X color
593 allocation problems on displays with PseudoColor-8. Some X servers
594 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
595 color reference counts completely so that they don't signal an
596 error when a color is freed whose reference count is already 0.
597 Other X servers do. To help me debug this, the following code
598 implements a simple reference counting schema of its own, for a
599 single display/screen. --gerd. */
601 /* Reference counts for pixel colors. */
603 int color_count
[256];
605 /* Register color PIXEL as allocated. */
608 register_color (pixel
)
611 xassert (pixel
< 256);
612 ++color_count
[pixel
];
616 /* Register color PIXEL as deallocated. */
619 unregister_color (pixel
)
622 xassert (pixel
< 256);
623 if (color_count
[pixel
] > 0)
624 --color_count
[pixel
];
630 /* Register N colors from PIXELS as deallocated. */
633 unregister_colors (pixels
, n
)
634 unsigned long *pixels
;
638 for (i
= 0; i
< n
; ++i
)
639 unregister_color (pixels
[i
]);
643 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
644 doc
: /* Dump currently allocated colors to stderr. */)
649 fputc ('\n', stderr
);
651 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
654 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
657 fputc ('\n', stderr
);
659 fputc ('\t', stderr
);
663 fputc ('\n', stderr
);
667 #endif /* DEBUG_X_COLORS */
670 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
671 color values. Interrupt input must be blocked when this function
675 x_free_colors (f
, pixels
, npixels
)
677 unsigned long *pixels
;
680 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
682 /* If display has an immutable color map, freeing colors is not
683 necessary and some servers don't allow it. So don't do it. */
684 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
686 #ifdef DEBUG_X_COLORS
687 unregister_colors (pixels
, npixels
);
689 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
695 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
696 color values. Interrupt input must be blocked when this function
700 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
704 unsigned long *pixels
;
707 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
708 int class = dpyinfo
->visual
->class;
710 /* If display has an immutable color map, freeing colors is not
711 necessary and some servers don't allow it. So don't do it. */
712 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
714 #ifdef DEBUG_X_COLORS
715 unregister_colors (pixels
, npixels
);
717 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
722 /* Create and return a GC for use on frame F. GC values and mask
723 are given by XGCV and MASK. */
726 x_create_gc (f
, mask
, xgcv
)
733 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
740 /* Free GC which was used on frame F. */
748 IF_DEBUG (xassert (--ngcs
>= 0));
749 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
753 #endif /* HAVE_X_WINDOWS */
756 /* W32 emulation of GCs */
759 x_create_gc (f
, mask
, xgcv
)
766 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
773 /* Free GC which was used on frame F. */
781 IF_DEBUG (xassert (--ngcs
>= 0));
786 #endif /* WINDOWSNT */
789 /* Mac OS emulation of GCs */
792 x_create_gc (f
, mask
, xgcv
)
799 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
811 IF_DEBUG (xassert (--ngcs
>= 0));
812 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
818 /* Like stricmp. Used to compare parts of font names which are in
823 const unsigned char *s1
, *s2
;
827 unsigned char c1
= tolower (*s1
);
828 unsigned char c2
= tolower (*s2
);
830 return c1
< c2
? -1 : 1;
835 return *s2
== 0 ? 0 : -1;
840 /* Like strlwr, which might not always be available. */
842 static unsigned char *
846 unsigned char *p
= s
;
849 /* On Mac OS X 10.3, tolower also converts non-ASCII characters
858 /* Signal `error' with message S, and additional argument ARG. */
861 signal_error (s
, arg
)
865 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
869 /* If FRAME is nil, return a pointer to the selected frame.
870 Otherwise, check that FRAME is a live frame, and return a pointer
871 to it. NPARAM is the parameter number of FRAME, for
872 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
873 Lisp function definitions. */
875 static INLINE
struct frame
*
876 frame_or_selected_frame (frame
, nparam
)
881 frame
= selected_frame
;
883 CHECK_LIVE_FRAME (frame
);
884 return XFRAME (frame
);
888 /***********************************************************************
890 ***********************************************************************/
892 /* Initialize face cache and basic faces for frame F. */
898 /* Make a face cache, if F doesn't have one. */
899 if (FRAME_FACE_CACHE (f
) == NULL
)
900 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
902 #ifdef HAVE_WINDOW_SYSTEM
903 /* Make the image cache. */
904 if (FRAME_WINDOW_P (f
))
906 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
907 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
908 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
910 #endif /* HAVE_WINDOW_SYSTEM */
912 /* Realize basic faces. Must have enough information in frame
913 parameters to realize basic faces at this point. */
914 #ifdef HAVE_X_WINDOWS
915 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
918 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
921 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
923 if (!realize_basic_faces (f
))
928 /* Free face cache of frame F. Called from Fdelete_frame. */
934 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
938 free_face_cache (face_cache
);
939 FRAME_FACE_CACHE (f
) = NULL
;
942 #ifdef HAVE_WINDOW_SYSTEM
943 if (FRAME_WINDOW_P (f
))
945 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
948 --image_cache
->refcount
;
949 if (image_cache
->refcount
== 0)
950 free_image_cache (f
);
953 #endif /* HAVE_WINDOW_SYSTEM */
957 /* Clear face caches, and recompute basic faces for frame F. Call
958 this after changing frame parameters on which those faces depend,
959 or when realized faces have been freed due to changing attributes
963 recompute_basic_faces (f
)
966 if (FRAME_FACE_CACHE (f
))
968 clear_face_cache (0);
969 if (!realize_basic_faces (f
))
975 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
976 try to free unused fonts, too. */
979 clear_face_cache (clear_fonts_p
)
982 #ifdef HAVE_WINDOW_SYSTEM
983 Lisp_Object tail
, frame
;
987 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
989 struct x_display_info
*dpyinfo
;
991 /* Fonts are common for frames on one display, i.e. on
993 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
994 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
995 clear_font_table (dpyinfo
);
997 /* From time to time see if we can unload some fonts. This also
998 frees all realized faces on all frames. Fonts needed by
999 faces will be loaded again when faces are realized again. */
1000 clear_font_table_count
= 0;
1002 FOR_EACH_FRAME (tail
, frame
)
1004 struct frame
*f
= XFRAME (frame
);
1005 if (FRAME_WINDOW_P (f
)
1006 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
1007 free_all_realized_faces (frame
);
1012 /* Clear GCs of realized faces. */
1013 FOR_EACH_FRAME (tail
, frame
)
1016 if (FRAME_WINDOW_P (f
))
1018 clear_face_gcs (FRAME_FACE_CACHE (f
));
1019 clear_image_cache (f
, 0);
1023 #endif /* HAVE_WINDOW_SYSTEM */
1027 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1028 doc
: /* Clear face caches on all frames.
1029 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1031 Lisp_Object thoroughly
;
1033 clear_face_cache (!NILP (thoroughly
));
1034 ++face_change_count
;
1035 ++windows_or_buffers_changed
;
1041 #ifdef HAVE_WINDOW_SYSTEM
1044 /* Remove fonts from the font table of DPYINFO except for the default
1045 ASCII fonts of frames on that display. Called from clear_face_cache
1046 from time to time. */
1049 clear_font_table (dpyinfo
)
1050 struct x_display_info
*dpyinfo
;
1054 /* Free those fonts that are not used by frames on DPYINFO. */
1055 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1057 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1058 Lisp_Object tail
, frame
;
1060 /* Check if slot is already free. */
1061 if (font_info
->name
== NULL
)
1064 /* Don't free a default font of some frame. */
1065 FOR_EACH_FRAME (tail
, frame
)
1067 struct frame
*f
= XFRAME (frame
);
1068 if (FRAME_WINDOW_P (f
)
1069 && font_info
->font
== FRAME_FONT (f
))
1077 if (font_info
->full_name
!= font_info
->name
)
1078 xfree (font_info
->full_name
);
1079 xfree (font_info
->name
);
1081 /* Free the font. */
1083 #ifdef HAVE_X_WINDOWS
1084 XFreeFont (dpyinfo
->display
, font_info
->font
);
1087 w32_unload_font (dpyinfo
, font_info
->font
);
1090 mac_unload_font (dpyinfo
, font_info
->font
);
1094 /* Mark font table slot free. */
1095 font_info
->font
= NULL
;
1096 font_info
->name
= font_info
->full_name
= NULL
;
1100 #endif /* HAVE_WINDOW_SYSTEM */
1104 /***********************************************************************
1106 ***********************************************************************/
1108 #ifdef HAVE_WINDOW_SYSTEM
1110 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1111 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1112 A bitmap specification is either a string, a file name, or a list
1113 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1114 HEIGHT is its height, and DATA is a string containing the bits of
1115 the pixmap. Bits are stored row by row, each row occupies
1116 \(WIDTH + 7)/8 bytes. */)
1122 if (STRINGP (object
))
1123 /* If OBJECT is a string, it's a file name. */
1125 else if (CONSP (object
))
1127 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1128 HEIGHT must be integers > 0, and DATA must be string large
1129 enough to hold a bitmap of the specified size. */
1130 Lisp_Object width
, height
, data
;
1132 height
= width
= data
= Qnil
;
1136 width
= XCAR (object
);
1137 object
= XCDR (object
);
1140 height
= XCAR (object
);
1141 object
= XCDR (object
);
1143 data
= XCAR (object
);
1147 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1149 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1151 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1156 return pixmap_p
? Qt
: Qnil
;
1160 /* Load a bitmap according to NAME (which is either a file name or a
1161 pixmap spec) for use on frame F. Value is the bitmap_id (see
1162 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1163 bitmap cannot be loaded, display a message saying so, and return
1164 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1165 if these pointers are not null. */
1168 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1171 unsigned int *w_ptr
, *h_ptr
;
1179 tem
= Fbitmap_spec_p (name
);
1181 wrong_type_argument (Qbitmap_spec_p
, name
);
1186 /* Decode a bitmap spec into a bitmap. */
1191 w
= XINT (Fcar (name
));
1192 h
= XINT (Fcar (Fcdr (name
)));
1193 bits
= Fcar (Fcdr (Fcdr (name
)));
1195 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1200 /* It must be a string -- a file name. */
1201 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1207 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1218 ++npixmaps_allocated
;
1221 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1224 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1230 #endif /* HAVE_WINDOW_SYSTEM */
1234 /***********************************************************************
1236 ***********************************************************************/
1238 #ifdef HAVE_WINDOW_SYSTEM
1240 /* Load font of face FACE which is used on frame F to display ASCII
1241 characters. The name of the font to load is determined by lface. */
1244 load_face_font (f
, face
)
1248 struct font_info
*font_info
= NULL
;
1250 int needs_overstrike
;
1252 face
->font_info_id
= -1;
1254 face
->font_name
= NULL
;
1256 font_name
= choose_face_font (f
, face
->lface
, Qnil
, &needs_overstrike
);
1261 font_info
= FS_LOAD_FONT (f
, font_name
);
1266 face
->font_info_id
= font_info
->font_idx
;
1267 face
->font
= font_info
->font
;
1268 face
->font_name
= font_info
->full_name
;
1269 face
->overstrike
= needs_overstrike
;
1272 x_free_gc (f
, face
->gc
);
1277 add_to_log ("Unable to load font %s",
1278 build_string (font_name
), Qnil
);
1282 #endif /* HAVE_WINDOW_SYSTEM */
1286 /***********************************************************************
1288 ***********************************************************************/
1290 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1291 RGB_LIST should contain (at least) 3 lisp integers.
1292 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1295 parse_rgb_list (rgb_list
, color
)
1296 Lisp_Object rgb_list
;
1299 #define PARSE_RGB_LIST_FIELD(field) \
1300 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1302 color->field = XINT (XCAR (rgb_list)); \
1303 rgb_list = XCDR (rgb_list); \
1308 PARSE_RGB_LIST_FIELD (red
);
1309 PARSE_RGB_LIST_FIELD (green
);
1310 PARSE_RGB_LIST_FIELD (blue
);
1316 /* Lookup on frame F the color described by the lisp string COLOR.
1317 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1318 non-zero, then the `standard' definition of the same color is
1322 tty_lookup_color (f
, color
, tty_color
, std_color
)
1325 XColor
*tty_color
, *std_color
;
1327 Lisp_Object frame
, color_desc
;
1329 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1332 XSETFRAME (frame
, f
);
1334 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1335 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1339 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1342 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1344 rgb
= XCDR (XCDR (color_desc
));
1345 if (! parse_rgb_list (rgb
, tty_color
))
1348 /* Should we fill in STD_COLOR too? */
1351 /* Default STD_COLOR to the same as TTY_COLOR. */
1352 *std_color
= *tty_color
;
1354 /* Do a quick check to see if the returned descriptor is
1355 actually _exactly_ equal to COLOR, otherwise we have to
1356 lookup STD_COLOR separately. If it's impossible to lookup
1357 a standard color, we just give up and use TTY_COLOR. */
1358 if ((!STRINGP (XCAR (color_desc
))
1359 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1360 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1362 /* Look up STD_COLOR separately. */
1363 rgb
= call1 (Qtty_color_standard_values
, color
);
1364 if (! parse_rgb_list (rgb
, std_color
))
1371 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1372 /* We were called early during startup, and the colors are not
1373 yet set up in tty-defined-color-alist. Don't return a failure
1374 indication, since this produces the annoying "Unable to
1375 load color" messages in the *Messages* buffer. */
1378 /* tty-color-desc seems to have returned a bad value. */
1382 /* A version of defined_color for non-X frames. */
1385 tty_defined_color (f
, color_name
, color_def
, alloc
)
1394 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1396 color_def
->blue
= 0;
1397 color_def
->green
= 0;
1400 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, NULL
);
1402 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1404 if (strcmp (color_name
, "unspecified-fg") == 0)
1405 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1406 else if (strcmp (color_name
, "unspecified-bg") == 0)
1407 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1410 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1417 /* Decide if color named COLOR_NAME is valid for the display
1418 associated with the frame F; if so, return the rgb values in
1419 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1421 This does the right thing for any type of frame. */
1424 defined_color (f
, color_name
, color_def
, alloc
)
1430 if (!FRAME_WINDOW_P (f
))
1431 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1432 #ifdef HAVE_X_WINDOWS
1433 else if (FRAME_X_P (f
))
1434 return x_defined_color (f
, color_name
, color_def
, alloc
);
1437 else if (FRAME_W32_P (f
))
1438 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1441 else if (FRAME_MAC_P (f
))
1442 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1449 /* Given the index IDX of a tty color on frame F, return its name, a
1453 tty_color_name (f
, idx
)
1457 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1460 Lisp_Object coldesc
;
1462 XSETFRAME (frame
, f
);
1463 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1465 if (!NILP (coldesc
))
1466 return XCAR (coldesc
);
1469 /* We can have an MSDOG frame under -nw for a short window of
1470 opportunity before internal_terminal_init is called. DTRT. */
1471 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1472 return msdos_stdcolor_name (idx
);
1475 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1476 return build_string (unspecified_fg
);
1477 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1478 return build_string (unspecified_bg
);
1481 return vga_stdcolor_name (idx
);
1484 return Qunspecified
;
1488 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1491 The criterion implemented here is not a terribly sophisticated one. */
1494 face_color_gray_p (f
, color_name
)
1501 if (defined_color (f
, color_name
, &color
, 0))
1502 gray_p
= (/* Any color sufficiently close to black counts as grey. */
1503 (color
.red
< 5000 && color
.green
< 5000 && color
.blue
< 5000)
1505 ((abs (color
.red
- color
.green
)
1506 < max (color
.red
, color
.green
) / 20)
1507 && (abs (color
.green
- color
.blue
)
1508 < max (color
.green
, color
.blue
) / 20)
1509 && (abs (color
.blue
- color
.red
)
1510 < max (color
.blue
, color
.red
) / 20)));
1518 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1519 BACKGROUND_P non-zero means the color will be used as background
1523 face_color_supported_p (f
, color_name
, background_p
)
1531 XSETFRAME (frame
, f
);
1533 #ifdef HAVE_WINDOW_SYSTEM
1535 ? (!NILP (Fxw_display_color_p (frame
))
1536 || xstricmp (color_name
, "black") == 0
1537 || xstricmp (color_name
, "white") == 0
1539 && face_color_gray_p (f
, color_name
))
1540 || (!NILP (Fx_display_grayscale_p (frame
))
1541 && face_color_gray_p (f
, color_name
)))
1544 tty_defined_color (f
, color_name
, ¬_used
, 0);
1548 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1549 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1550 FRAME specifies the frame and thus the display for interpreting COLOR.
1551 If FRAME is nil or omitted, use the selected frame. */)
1553 Lisp_Object color
, frame
;
1557 CHECK_STRING (color
);
1559 frame
= selected_frame
;
1561 CHECK_FRAME (frame
);
1563 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1567 DEFUN ("color-supported-p", Fcolor_supported_p
,
1568 Scolor_supported_p
, 1, 3, 0,
1569 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1570 BACKGROUND-P non-nil means COLOR is used as a background.
1571 Otherwise, this function tells whether it can be used as a foreground.
1572 If FRAME is nil or omitted, use the selected frame.
1573 COLOR must be a valid color name. */)
1574 (color
, frame
, background_p
)
1575 Lisp_Object frame
, color
, background_p
;
1579 CHECK_STRING (color
);
1581 frame
= selected_frame
;
1583 CHECK_FRAME (frame
);
1585 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1591 /* Load color with name NAME for use by face FACE on frame F.
1592 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1593 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1594 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1595 pixel color. If color cannot be loaded, display a message, and
1596 return the foreground, background or underline color of F, but
1597 record that fact in flags of the face so that we don't try to free
1601 load_color (f
, face
, name
, target_index
)
1605 enum lface_attribute_index target_index
;
1609 xassert (STRINGP (name
));
1610 xassert (target_index
== LFACE_FOREGROUND_INDEX
1611 || target_index
== LFACE_BACKGROUND_INDEX
1612 || target_index
== LFACE_UNDERLINE_INDEX
1613 || target_index
== LFACE_OVERLINE_INDEX
1614 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1615 || target_index
== LFACE_BOX_INDEX
);
1617 /* if the color map is full, defined_color will return a best match
1618 to the values in an existing cell. */
1619 if (!defined_color (f
, SDATA (name
), &color
, 1))
1621 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1623 switch (target_index
)
1625 case LFACE_FOREGROUND_INDEX
:
1626 face
->foreground_defaulted_p
= 1;
1627 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1630 case LFACE_BACKGROUND_INDEX
:
1631 face
->background_defaulted_p
= 1;
1632 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1635 case LFACE_UNDERLINE_INDEX
:
1636 face
->underline_defaulted_p
= 1;
1637 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1640 case LFACE_OVERLINE_INDEX
:
1641 face
->overline_color_defaulted_p
= 1;
1642 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1645 case LFACE_STRIKE_THROUGH_INDEX
:
1646 face
->strike_through_color_defaulted_p
= 1;
1647 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1650 case LFACE_BOX_INDEX
:
1651 face
->box_color_defaulted_p
= 1;
1652 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1661 ++ncolors_allocated
;
1668 #ifdef HAVE_WINDOW_SYSTEM
1670 /* Load colors for face FACE which is used on frame F. Colors are
1671 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1672 of ATTRS. If the background color specified is not supported on F,
1673 try to emulate gray colors with a stipple from Vface_default_stipple. */
1676 load_face_colors (f
, face
, attrs
)
1683 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1684 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1686 /* Swap colors if face is inverse-video. */
1687 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1695 /* Check for support for foreground, not for background because
1696 face_color_supported_p is smart enough to know that grays are
1697 "supported" as background because we are supposed to use stipple
1699 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1700 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1702 x_destroy_bitmap (f
, face
->stipple
);
1703 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1704 &face
->pixmap_w
, &face
->pixmap_h
);
1707 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1708 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1712 /* Free color PIXEL on frame F. */
1715 unload_color (f
, pixel
)
1717 unsigned long pixel
;
1719 #ifdef HAVE_X_WINDOWS
1723 x_free_colors (f
, &pixel
, 1);
1730 /* Free colors allocated for FACE. */
1733 free_face_colors (f
, face
)
1737 #ifdef HAVE_X_WINDOWS
1738 if (face
->colors_copied_bitwise_p
)
1743 if (!face
->foreground_defaulted_p
)
1745 x_free_colors (f
, &face
->foreground
, 1);
1746 IF_DEBUG (--ncolors_allocated
);
1749 if (!face
->background_defaulted_p
)
1751 x_free_colors (f
, &face
->background
, 1);
1752 IF_DEBUG (--ncolors_allocated
);
1755 if (face
->underline_p
1756 && !face
->underline_defaulted_p
)
1758 x_free_colors (f
, &face
->underline_color
, 1);
1759 IF_DEBUG (--ncolors_allocated
);
1762 if (face
->overline_p
1763 && !face
->overline_color_defaulted_p
)
1765 x_free_colors (f
, &face
->overline_color
, 1);
1766 IF_DEBUG (--ncolors_allocated
);
1769 if (face
->strike_through_p
1770 && !face
->strike_through_color_defaulted_p
)
1772 x_free_colors (f
, &face
->strike_through_color
, 1);
1773 IF_DEBUG (--ncolors_allocated
);
1776 if (face
->box
!= FACE_NO_BOX
1777 && !face
->box_color_defaulted_p
)
1779 x_free_colors (f
, &face
->box_color
, 1);
1780 IF_DEBUG (--ncolors_allocated
);
1784 #endif /* HAVE_X_WINDOWS */
1787 #endif /* HAVE_WINDOW_SYSTEM */
1791 /***********************************************************************
1793 ***********************************************************************/
1795 /* An enumerator for each field of an XLFD font name. */
1816 /* An enumerator for each possible slant value of a font. Taken from
1817 the XLFD specification. */
1825 XLFD_SLANT_REVERSE_ITALIC
,
1826 XLFD_SLANT_REVERSE_OBLIQUE
,
1830 /* Relative font weight according to XLFD documentation. */
1834 XLFD_WEIGHT_UNKNOWN
,
1835 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1836 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1837 XLFD_WEIGHT_LIGHT
, /* 30 */
1838 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1839 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1840 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1841 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1842 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1843 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1846 /* Relative proportionate width. */
1850 XLFD_SWIDTH_UNKNOWN
,
1851 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1852 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1853 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1854 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1855 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1856 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1857 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1858 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1859 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1862 /* Structure used for tables mapping XLFD weight, slant, and width
1863 names to numeric and symbolic values. */
1869 Lisp_Object
*symbol
;
1872 /* Table of XLFD slant names and their numeric and symbolic
1873 representations. This table must be sorted by slant names in
1876 static struct table_entry slant_table
[] =
1878 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1879 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1880 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1881 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1882 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1883 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1886 /* Table of XLFD weight names. This table must be sorted by weight
1887 names in ascending order. */
1889 static struct table_entry weight_table
[] =
1891 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1892 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1893 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1894 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1895 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1896 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1897 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1898 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1899 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1900 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1901 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1902 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1903 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1904 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1905 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1906 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1909 /* Table of XLFD width names. This table must be sorted by width
1910 names in ascending order. */
1912 static struct table_entry swidth_table
[] =
1914 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1915 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1916 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1917 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1918 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1919 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1920 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1921 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1922 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1923 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1924 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1925 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1926 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1927 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1928 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1931 /* Structure used to hold the result of splitting font names in XLFD
1932 format into their fields. */
1936 /* The original name which is modified destructively by
1937 split_font_name. The pointer is kept here to be able to free it
1938 if it was allocated from the heap. */
1941 /* Font name fields. Each vector element points into `name' above.
1942 Fields are NUL-terminated. */
1943 char *fields
[XLFD_LAST
];
1945 /* Numeric values for those fields that interest us. See
1946 split_font_name for which these are. */
1947 int numeric
[XLFD_LAST
];
1949 /* If the original name matches one of Vface_font_rescale_alist,
1950 the value is the corresponding rescale ratio. Otherwise, the
1952 double rescale_ratio
;
1954 /* Lower value mean higher priority. */
1955 int registry_priority
;
1958 /* The frame in effect when sorting font names. Set temporarily in
1959 sort_fonts so that it is available in font comparison functions. */
1961 static struct frame
*font_frame
;
1963 /* Order by which font selection chooses fonts. The default values
1964 mean `first, find a best match for the font width, then for the
1965 font height, then for weight, then for slant.' This variable can be
1966 set via set-face-font-sort-order. */
1969 static int font_sort_order
[4] = {
1970 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1973 static int font_sort_order
[4];
1976 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1977 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1978 is a pointer to the matching table entry or null if no table entry
1981 static struct table_entry
*
1982 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1983 struct table_entry
*table
;
1985 struct font_name
*font
;
1988 /* Function split_font_name converts fields to lower-case, so there
1989 is no need to use xstrlwr or xstricmp here. */
1990 char *s
= font
->fields
[field_index
];
1991 int low
, mid
, high
, cmp
;
1998 mid
= (low
+ high
) / 2;
1999 cmp
= strcmp (table
[mid
].name
, s
);
2013 /* Return a numeric representation for font name field
2014 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2015 has DIM entries. Value is the numeric value found or DFLT if no
2016 table entry matches. This function is used to translate weight,
2017 slant, and swidth names of XLFD font names to numeric values. */
2020 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2021 struct table_entry
*table
;
2023 struct font_name
*font
;
2027 struct table_entry
*p
;
2028 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2029 return p
? p
->numeric
: dflt
;
2033 /* Return a symbolic representation for font name field
2034 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2035 has DIM entries. Value is the symbolic value found or DFLT if no
2036 table entry matches. This function is used to translate weight,
2037 slant, and swidth names of XLFD font names to symbols. */
2039 static INLINE Lisp_Object
2040 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2041 struct table_entry
*table
;
2043 struct font_name
*font
;
2047 struct table_entry
*p
;
2048 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2049 return p
? *p
->symbol
: dflt
;
2053 /* Return a numeric value for the slant of the font given by FONT. */
2056 xlfd_numeric_slant (font
)
2057 struct font_name
*font
;
2059 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2060 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2064 /* Return a symbol representing the weight of the font given by FONT. */
2066 static INLINE Lisp_Object
2067 xlfd_symbolic_slant (font
)
2068 struct font_name
*font
;
2070 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2071 font
, XLFD_SLANT
, Qnormal
);
2075 /* Return a numeric value for the weight of the font given by FONT. */
2078 xlfd_numeric_weight (font
)
2079 struct font_name
*font
;
2081 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2082 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2086 /* Return a symbol representing the slant of the font given by FONT. */
2088 static INLINE Lisp_Object
2089 xlfd_symbolic_weight (font
)
2090 struct font_name
*font
;
2092 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2093 font
, XLFD_WEIGHT
, Qnormal
);
2097 /* Return a numeric value for the swidth of the font whose XLFD font
2098 name fields are found in FONT. */
2101 xlfd_numeric_swidth (font
)
2102 struct font_name
*font
;
2104 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2105 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2109 /* Return a symbolic value for the swidth of FONT. */
2111 static INLINE Lisp_Object
2112 xlfd_symbolic_swidth (font
)
2113 struct font_name
*font
;
2115 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2116 font
, XLFD_SWIDTH
, Qnormal
);
2120 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2121 entries. Value is a pointer to the matching table entry or null if
2122 no element of TABLE contains SYMBOL. */
2124 static struct table_entry
*
2125 face_value (table
, dim
, symbol
)
2126 struct table_entry
*table
;
2132 xassert (SYMBOLP (symbol
));
2134 for (i
= 0; i
< dim
; ++i
)
2135 if (EQ (*table
[i
].symbol
, symbol
))
2138 return i
< dim
? table
+ i
: NULL
;
2142 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2143 entries. Value is -1 if SYMBOL is not found in TABLE. */
2146 face_numeric_value (table
, dim
, symbol
)
2147 struct table_entry
*table
;
2151 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2152 return p
? p
->numeric
: -1;
2156 /* Return a numeric value representing the weight specified by Lisp
2157 symbol WEIGHT. Value is one of the enumerators of enum
2161 face_numeric_weight (weight
)
2164 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2168 /* Return a numeric value representing the slant specified by Lisp
2169 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2172 face_numeric_slant (slant
)
2175 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2179 /* Return a numeric value representing the swidth specified by Lisp
2180 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2183 face_numeric_swidth (width
)
2186 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2189 #ifdef HAVE_WINDOW_SYSTEM
2192 split_font_name_into_vector (fontname
)
2193 Lisp_Object fontname
;
2195 struct font_name font
;
2199 font
.name
= LSTRDUPA (fontname
);
2200 if (! split_font_name (NULL
, &font
, 0))
2202 vec
= Fmake_vector (make_number (XLFD_LAST
), Qnil
);
2203 for (i
= 0; i
< XLFD_LAST
; i
++)
2204 if (font
.fields
[i
][0] != '*')
2205 ASET (vec
, i
, build_string (font
.fields
[i
]));
2210 build_font_name_from_vector (vec
)
2213 struct font_name font
;
2214 Lisp_Object fontname
;
2218 for (i
= 0; i
< XLFD_LAST
; i
++)
2220 font
.fields
[i
] = (NILP (AREF (vec
, i
))
2221 ? "*" : (char *) SDATA (AREF (vec
, i
)));
2222 if ((i
== XLFD_FAMILY
|| i
== XLFD_REGISTRY
)
2223 && (p
= strchr (font
.fields
[i
], '-')))
2225 char *p1
= STRDUPA (font
.fields
[i
]);
2227 p1
[p
- font
.fields
[i
]] = '\0';
2228 if (i
== XLFD_FAMILY
)
2230 font
.fields
[XLFD_FOUNDRY
] = p1
;
2231 font
.fields
[XLFD_FAMILY
] = p
+ 1;
2235 font
.fields
[XLFD_REGISTRY
] = p1
;
2236 font
.fields
[XLFD_ENCODING
] = p
+ 1;
2242 p
= build_font_name (&font
);
2243 fontname
= build_string (p
);
2248 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2252 struct font_name
*font
;
2254 /* Function split_font_name converts fields to lower-case, so there
2255 is no need to use tolower here. */
2256 return *font
->fields
[XLFD_SPACING
] != 'p';
2260 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2262 The actual height of the font when displayed on F depends on the
2263 resolution of both the font and frame. For example, a 10pt font
2264 designed for a 100dpi display will display larger than 10pt on a
2265 75dpi display. (It's not unusual to use fonts not designed for the
2266 display one is using. For example, some intlfonts are available in
2267 72dpi versions, only.)
2269 Value is the real point size of FONT on frame F, or 0 if it cannot
2272 By side effect, set FONT->numeric[XLFD_PIXEL_SIZE]. */
2275 xlfd_point_size (f
, font
)
2277 struct font_name
*font
;
2279 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2280 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2284 if (*pixel_field
== '[')
2286 /* The pixel size field is `[A B C D]' which specifies
2287 a transformation matrix.
2293 by which all glyphs of the font are transformed. The spec
2294 says that s scalar value N for the pixel size is equivalent
2295 to A = N * resx/resy, B = C = 0, D = N. */
2296 char *start
= pixel_field
+ 1, *end
;
2300 for (i
= 0; i
< 4; ++i
)
2302 matrix
[i
] = strtod (start
, &end
);
2309 pixel
= atoi (pixel_field
);
2311 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel
;
2315 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2321 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2322 of frame F. This function is used to guess a point size of font
2323 when only the pixel height of the font is available. */
2326 pixel_point_size (f
, pixel
)
2330 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2334 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2335 point size of one dot. */
2336 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2337 int_pt
= real_pt
+ 0.5;
2343 /* Return a rescaling ratio of a font of NAME. */
2346 font_rescale_ratio (name
)
2349 Lisp_Object tail
, elt
;
2351 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2354 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2355 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2356 return XFLOAT_DATA (XCDR (elt
));
2362 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2363 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2364 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2365 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2366 zero if the font name doesn't have the format we expect. The
2367 expected format is a font name that starts with a `-' and has
2368 XLFD_LAST fields separated by `-'. */
2371 split_font_name (f
, font
, numeric_p
)
2373 struct font_name
*font
;
2378 double rescale_ratio
;
2381 /* This must be done before splitting the font name. */
2382 rescale_ratio
= font_rescale_ratio (font
->name
);
2384 if (*font
->name
== '-')
2386 char *p
= xstrlwr (font
->name
) + 1;
2388 while (i
< XLFD_LAST
)
2390 font
->fields
[i
] = p
;
2393 /* Pixel and point size may be of the form `[....]'. For
2394 BNF, see XLFD spec, chapter 4. Negative values are
2395 indicated by tilde characters which we replace with
2396 `-' characters, here. */
2398 && (i
- 1 == XLFD_PIXEL_SIZE
2399 || i
- 1 == XLFD_POINT_SIZE
))
2404 for (++p
; *p
&& *p
!= ']'; ++p
)
2408 /* Check that the matrix contains 4 floating point
2410 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2413 if (strtod (start
, &end
) == 0 && start
== end
)
2420 while (*p
&& *p
!= '-')
2430 success_p
= i
== XLFD_LAST
;
2432 /* If requested, and font name was in the expected format,
2433 compute numeric values for some fields. */
2434 if (numeric_p
&& success_p
)
2436 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2437 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2438 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2439 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2440 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2441 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2442 font
->rescale_ratio
= rescale_ratio
;
2445 /* Initialize it to zero. It will be overridden by font_list while
2446 trying alternate registries. */
2447 font
->registry_priority
= 0;
2453 /* Build an XLFD font name from font name fields in FONT. Value is a
2454 pointer to the font name, which is allocated via xmalloc. */
2457 build_font_name (font
)
2458 struct font_name
*font
;
2462 char *font_name
= (char *) xmalloc (size
);
2463 int total_length
= 0;
2465 for (i
= 0; i
< XLFD_LAST
; ++i
)
2467 /* Add 1 because of the leading `-'. */
2468 int len
= strlen (font
->fields
[i
]) + 1;
2470 /* Reallocate font_name if necessary. Add 1 for the final
2472 if (total_length
+ len
+ 1 >= size
)
2474 int new_size
= max (2 * size
, size
+ len
+ 1);
2475 int sz
= new_size
* sizeof *font_name
;
2476 font_name
= (char *) xrealloc (font_name
, sz
);
2480 font_name
[total_length
] = '-';
2481 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2482 total_length
+= len
;
2485 font_name
[total_length
] = 0;
2490 /* Free an array FONTS of N font_name structures. This frees FONTS
2491 itself and all `name' fields in its elements. */
2494 free_font_names (fonts
, n
)
2495 struct font_name
*fonts
;
2499 xfree (fonts
[--n
].name
);
2504 /* Sort vector FONTS of font_name structures which contains NFONTS
2505 elements using qsort and comparison function CMPFN. F is the frame
2506 on which the fonts will be used. The global variable font_frame
2507 is temporarily set to F to make it available in CMPFN. */
2510 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2512 struct font_name
*fonts
;
2514 int (*cmpfn
) P_ ((const void *, const void *));
2517 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2522 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2523 display in x_display_list. FONTS is a pointer to a vector of
2524 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2525 alternative patterns from Valternate_fontname_alist if no fonts are
2526 found matching PATTERN.
2528 For all fonts found, set FONTS[i].name to the name of the font,
2529 allocated via xmalloc, and split font names into fields. Ignore
2530 fonts that we can't parse. Value is the number of fonts found. */
2533 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2536 struct font_name
**pfonts
;
2537 int nfonts
, try_alternatives_p
;
2541 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2542 better to do it the other way around. */
2544 Lisp_Object lpattern
, tem
;
2545 struct font_name
*fonts
= 0;
2546 int num_fonts
= nfonts
;
2549 lpattern
= build_string (pattern
);
2551 /* Get the list of fonts matching PATTERN. */
2554 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2557 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2560 if (nfonts
< 0 && CONSP (lfonts
))
2561 num_fonts
= XFASTINT (Flength (lfonts
));
2563 /* Make a copy of the font names we got from X, and
2564 split them into fields. */
2566 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2568 Lisp_Object elt
, tail
;
2569 const char *name
= SDATA (XCAR (tem
));
2571 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2572 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2576 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2587 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2591 /* Make a copy of the font name. */
2592 fonts
[n
].name
= xstrdup (name
);
2594 if (split_font_name (f
, fonts
+ n
, 1))
2596 if (font_scalable_p (fonts
+ n
)
2597 && !may_use_scalable_font_p (name
))
2600 xfree (fonts
[n
].name
);
2606 xfree (fonts
[n
].name
);
2609 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2610 if (n
== 0 && try_alternatives_p
)
2612 Lisp_Object list
= Valternate_fontname_alist
;
2620 while (CONSP (list
))
2622 Lisp_Object entry
= XCAR (list
);
2624 && STRINGP (XCAR (entry
))
2625 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2632 Lisp_Object patterns
= XCAR (list
);
2635 while (CONSP (patterns
)
2636 /* If list is screwed up, give up. */
2637 && (name
= XCAR (patterns
),
2639 /* Ignore patterns equal to PATTERN because we tried that
2640 already with no success. */
2641 && (strcmp (SDATA (name
), pattern
) == 0
2642 || (n
= x_face_list_fonts (f
, SDATA (name
),
2645 patterns
= XCDR (patterns
);
2653 /* Check if a font matching pattern_offset_t on frame F is available
2654 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2655 a font name pattern is generated from FAMILY and REGISTRY. */
2658 face_font_available_p (f
, pattern
)
2660 Lisp_Object pattern
;
2664 if (! STRINGP (pattern
))
2666 Lisp_Object family
, registry
;
2667 char *family_str
, *registry_str
, *pattern_str
;
2669 CHECK_CONS (pattern
);
2670 family
= XCAR (pattern
);
2675 CHECK_STRING (family
);
2676 family_str
= (char *) SDATA (family
);
2678 registry
= XCDR (pattern
);
2679 if (NILP (registry
))
2683 CHECK_STRING (registry
);
2684 registry_str
= (char *) SDATA (registry
);
2687 pattern_str
= (char *) alloca (strlen (family_str
)
2688 + strlen (registry_str
)
2690 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2691 strcat (pattern_str
, family_str
);
2692 strcat (pattern_str
, "-*-");
2693 strcat (pattern_str
, registry_str
);
2694 if (!index (registry_str
, '-'))
2696 if (registry_str
[strlen (registry_str
) - 1] == '*')
2697 strcat (pattern_str
, "-*");
2699 strcat (pattern_str
, "*-*");
2701 pattern
= build_string (pattern_str
);
2704 /* Get the list of fonts matching PATTERN. */
2707 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2710 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2712 return XINT (Flength (fonts
));
2716 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2717 using comparison function CMPFN. Value is the number of fonts
2718 found. If value is non-zero, *FONTS is set to a vector of
2719 font_name structures allocated from the heap containing matching
2720 fonts. Each element of *FONTS contains a name member that is also
2721 allocated from the heap. Font names in these structures are split
2722 into fields. Use free_font_names to free such an array. */
2725 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2728 int (*cmpfn
) P_ ((const void *, const void *));
2729 struct font_name
**fonts
;
2733 /* Get the list of fonts matching pattern. 100 should suffice. */
2734 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2735 if (INTEGERP (Vfont_list_limit
))
2736 nfonts
= XINT (Vfont_list_limit
);
2739 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2741 /* Sort the resulting array and return it in *FONTS. If no
2742 fonts were found, make sure to set *FONTS to null. */
2744 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2755 /* Compare two font_name structures *A and *B. Value is analogous to
2756 strcmp. Sort order is given by the global variable
2757 font_sort_order. Font names are sorted so that, everything else
2758 being equal, fonts with a resolution closer to that of the frame on
2759 which they are used are listed first. The global variable
2760 font_frame is the frame on which we operate. */
2763 cmp_font_names (a
, b
)
2766 struct font_name
*x
= (struct font_name
*) a
;
2767 struct font_name
*y
= (struct font_name
*) b
;
2770 /* All strings have been converted to lower-case by split_font_name,
2771 so we can use strcmp here. */
2772 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2777 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2779 int j
= font_sort_order
[i
];
2780 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2785 /* Everything else being equal, we prefer fonts with an
2786 y-resolution closer to that of the frame. */
2787 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2788 int x_resy
= x
->numeric
[XLFD_RESY
];
2789 int y_resy
= y
->numeric
[XLFD_RESY
];
2790 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2798 /* Get a sorted list of fonts matching PATTERN on frame F. If PATTERN
2799 is nil, list fonts matching FAMILY and REGISTRY. FAMILY is a
2800 family name string or nil. REGISTRY is a registry name string.
2801 Set *FONTS to a vector of font_name structures allocated from the
2802 heap containing the fonts found. Value is the number of fonts
2806 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2808 Lisp_Object pattern
, family
, registry
;
2809 struct font_name
**fonts
;
2811 char *pattern_str
, *family_str
, *registry_str
;
2815 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2816 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2818 pattern_str
= (char *) alloca (strlen (family_str
)
2819 + strlen (registry_str
)
2821 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2822 strcat (pattern_str
, family_str
);
2823 strcat (pattern_str
, "-*-");
2824 strcat (pattern_str
, registry_str
);
2825 if (!index (registry_str
, '-'))
2827 if (registry_str
[strlen (registry_str
) - 1] == '*')
2828 strcat (pattern_str
, "-*");
2830 strcat (pattern_str
, "*-*");
2834 pattern_str
= (char *) SDATA (pattern
);
2836 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2840 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2841 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2842 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2845 static struct font_name
*
2846 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2847 struct font_name
*fonts1
, *fonts2
;
2848 int nfonts1
, nfonts2
;
2850 int new_nfonts
= nfonts1
+ nfonts2
;
2851 struct font_name
*new_fonts
;
2853 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2854 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2855 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2862 /* Get a sorted list of fonts of family FAMILY on frame F.
2864 If PATTERN is non-nil, list fonts matching that pattern.
2866 If REGISTRY is non-nil, it is a list of registry (and encoding)
2867 names. Return fonts with those registries and the alternative
2868 registries from Vface_alternative_font_registry_alist.
2870 If REGISTRY is nil return fonts of any registry.
2872 Set *FONTS to a vector of font_name structures allocated from the
2873 heap containing the fonts found. Value is the number of fonts
2877 font_list (f
, pattern
, family
, registry
, fonts
)
2879 Lisp_Object pattern
, family
, registry
;
2880 struct font_name
**fonts
;
2886 if (NILP (registry
))
2887 return font_list_1 (f
, pattern
, family
, registry
, fonts
);
2889 for (reg_prio
= 0, nfonts
= 0; CONSP (registry
); registry
= XCDR (registry
))
2891 Lisp_Object elt
, alter
;
2893 struct font_name
*fonts2
;
2895 elt
= XCAR (registry
);
2896 alter
= Fassoc (elt
, Vface_alternative_font_registry_alist
);
2898 alter
= Fcons (elt
, Qnil
);
2899 for (; CONSP (alter
); alter
= XCDR (alter
), reg_prio
++)
2901 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
), &fonts2
);
2905 for (i
= 0; i
< nfonts2
; i
++)
2906 fonts2
[i
].registry_priority
= reg_prio
;
2908 *fonts
= concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
);
2920 /* Remove elements from LIST whose cars are `equal'. Called from
2921 x-family-fonts and x-font-family-list to remove duplicate font
2925 remove_duplicates (list
)
2928 Lisp_Object tail
= list
;
2930 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2932 Lisp_Object next
= XCDR (tail
);
2933 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2934 XSETCDR (tail
, XCDR (next
));
2941 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2942 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2943 If FAMILY is omitted or nil, list all families.
2944 Otherwise, FAMILY must be a string, possibly containing wildcards
2946 If FRAME is omitted or nil, use the selected frame.
2947 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2948 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2949 FAMILY is the font family name. POINT-SIZE is the size of the
2950 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2951 width, weight and slant of the font. These symbols are the same as for
2952 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2953 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2954 giving the registry and encoding of the font.
2955 The result list is sorted according to the current setting of
2956 the face font sort order. */)
2958 Lisp_Object family
, frame
;
2960 struct frame
*f
= check_x_frame (frame
);
2961 struct font_name
*fonts
;
2964 struct gcpro gcpro1
;
2967 CHECK_STRING (family
);
2971 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2972 for (i
= nfonts
- 1; i
>= 0; --i
)
2974 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2977 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2978 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2979 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2980 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2981 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2982 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2983 tem
= build_font_name (fonts
+ i
);
2984 ASET (v
, 6, build_string (tem
));
2985 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2986 fonts
[i
].fields
[XLFD_ENCODING
]);
2987 ASET (v
, 7, build_string (tem
));
2990 result
= Fcons (v
, result
);
2993 remove_duplicates (result
);
2994 free_font_names (fonts
, nfonts
);
3000 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
3002 doc
: /* Return a list of available font families on FRAME.
3003 If FRAME is omitted or nil, use the selected frame.
3004 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
3005 is a font family, and FIXED-P is non-nil if fonts of that family
3006 are fixed-pitch. */)
3010 struct frame
*f
= check_x_frame (frame
);
3012 struct font_name
*fonts
;
3014 struct gcpro gcpro1
;
3015 int count
= SPECPDL_INDEX ();
3017 /* Let's consider all fonts. */
3018 specbind (intern ("font-list-limit"), make_number (-1));
3019 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
3023 for (i
= nfonts
- 1; i
>= 0; --i
)
3024 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
3025 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
3028 remove_duplicates (result
);
3029 free_font_names (fonts
, nfonts
);
3031 return unbind_to (count
, result
);
3035 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
3036 doc
: /* Return a list of the names of available fonts matching PATTERN.
3037 If optional arguments FACE and FRAME are specified, return only fonts
3038 the same size as FACE on FRAME.
3039 PATTERN is a string, perhaps with wildcard characters;
3040 the * character matches any substring, and
3041 the ? character matches any single character.
3042 PATTERN is case-insensitive.
3043 FACE is a face name--a symbol.
3045 The return value is a list of strings, suitable as arguments to
3048 Fonts Emacs can't use may or may not be excluded
3049 even if they match PATTERN and FACE.
3050 The optional fourth argument MAXIMUM sets a limit on how many
3051 fonts to match. The first MAXIMUM fonts are reported.
3052 The optional fifth argument WIDTH, if specified, is a number of columns
3053 occupied by a character of a font. In that case, return only fonts
3054 the WIDTH times as wide as FACE on FRAME. */)
3055 (pattern
, face
, frame
, maximum
, width
)
3056 Lisp_Object pattern
, face
, frame
, maximum
, width
;
3063 CHECK_STRING (pattern
);
3069 CHECK_NATNUM (maximum
);
3070 maxnames
= XINT (maximum
);
3074 CHECK_NUMBER (width
);
3076 /* We can't simply call check_x_frame because this function may be
3077 called before any frame is created. */
3078 f
= frame_or_selected_frame (frame
, 2);
3079 if (!FRAME_WINDOW_P (f
))
3081 /* Perhaps we have not yet created any frame. */
3086 /* Determine the width standard for comparison with the fonts we find. */
3092 /* This is of limited utility since it works with character
3093 widths. Keep it for compatibility. --gerd. */
3094 int face_id
= lookup_named_face (f
, face
, 0);
3095 struct face
*face
= (face_id
< 0
3097 : FACE_FROM_ID (f
, face_id
));
3100 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3101 not maximum as on X. Redefine here. */
3103 #define FONT_WIDTH FONT_MAX_WIDTH
3106 if (face
&& face
->font
)
3107 size
= FONT_WIDTH (face
->font
);
3109 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3112 size
*= XINT (width
);
3116 Lisp_Object args
[2];
3118 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3120 /* We don't have to check fontsets. */
3122 args
[1] = list_fontsets (f
, pattern
, size
);
3123 return Fnconc (2, args
);
3127 #endif /* HAVE_WINDOW_SYSTEM */
3131 /***********************************************************************
3133 ***********************************************************************/
3135 /* Access face attributes of face LFACE, a Lisp vector. */
3137 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3138 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3139 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3140 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3141 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3142 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3143 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3144 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3145 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3146 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3147 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3148 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3149 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3150 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3151 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3152 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3153 #define LFACE_FONTSET(LFACE) AREF ((LFACE), LFACE_FONTSET_INDEX)
3155 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3156 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3158 #define LFACEP(LFACE) \
3160 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3161 && EQ (AREF (LFACE, 0), Qface))
3166 /* Check consistency of Lisp face attribute vector ATTRS. */
3169 check_lface_attrs (attrs
)
3172 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3173 || IGNORE_DEFFACE_P (attrs
[LFACE_FAMILY_INDEX
])
3174 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3175 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3176 || IGNORE_DEFFACE_P (attrs
[LFACE_SWIDTH_INDEX
])
3177 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3178 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3179 || IGNORE_DEFFACE_P (attrs
[LFACE_AVGWIDTH_INDEX
])
3180 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3181 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3182 || IGNORE_DEFFACE_P (attrs
[LFACE_HEIGHT_INDEX
])
3183 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3184 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3185 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3186 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3187 || IGNORE_DEFFACE_P (attrs
[LFACE_WEIGHT_INDEX
])
3188 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3189 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3190 || IGNORE_DEFFACE_P (attrs
[LFACE_SLANT_INDEX
])
3191 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3192 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3193 || IGNORE_DEFFACE_P (attrs
[LFACE_UNDERLINE_INDEX
])
3194 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3195 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3196 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3197 || IGNORE_DEFFACE_P (attrs
[LFACE_OVERLINE_INDEX
])
3198 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3199 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3200 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3201 || IGNORE_DEFFACE_P (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3202 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3203 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3204 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3205 || IGNORE_DEFFACE_P (attrs
[LFACE_BOX_INDEX
])
3206 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3207 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3208 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3209 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3210 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3211 || IGNORE_DEFFACE_P (attrs
[LFACE_INVERSE_INDEX
])
3212 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3213 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3214 || IGNORE_DEFFACE_P (attrs
[LFACE_FOREGROUND_INDEX
])
3215 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3216 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3217 || IGNORE_DEFFACE_P (attrs
[LFACE_BACKGROUND_INDEX
])
3218 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3219 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3220 || IGNORE_DEFFACE_P (attrs
[LFACE_INHERIT_INDEX
])
3221 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3222 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3223 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3224 #ifdef HAVE_WINDOW_SYSTEM
3225 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3226 || IGNORE_DEFFACE_P (attrs
[LFACE_STIPPLE_INDEX
])
3227 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3228 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3229 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3230 || IGNORE_DEFFACE_P (attrs
[LFACE_FONT_INDEX
])
3231 || NILP (attrs
[LFACE_FONT_INDEX
])
3232 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3233 xassert (UNSPECIFIEDP (attrs
[LFACE_FONTSET_INDEX
])
3234 || STRINGP (attrs
[LFACE_FONTSET_INDEX
]));
3239 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3247 xassert (LFACEP (lface
));
3248 check_lface_attrs (XVECTOR (lface
)->contents
);
3252 #else /* GLYPH_DEBUG == 0 */
3254 #define check_lface_attrs(attrs) (void) 0
3255 #define check_lface(lface) (void) 0
3257 #endif /* GLYPH_DEBUG == 0 */
3261 /* Face-merge cycle checking. */
3263 /* A `named merge point' is simply a point during face-merging where we
3264 look up a face by name. We keep a stack of which named lookups we're
3265 currently processing so that we can easily detect cycles, using a
3266 linked- list of struct named_merge_point structures, typically
3267 allocated on the stack frame of the named lookup functions which are
3268 active (so no consing is required). */
3269 struct named_merge_point
3271 Lisp_Object face_name
;
3272 struct named_merge_point
*prev
;
3276 /* If a face merging cycle is detected for FACE_NAME, return 0,
3277 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3278 FACE_NAME, as the head of the linked list pointed to by
3279 NAMED_MERGE_POINTS, and return 1. */
3282 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3283 Lisp_Object face_name
,
3284 struct named_merge_point
**named_merge_points
)
3286 struct named_merge_point
*prev
;
3288 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3289 if (EQ (face_name
, prev
->face_name
))
3292 new_named_merge_point
->face_name
= face_name
;
3293 new_named_merge_point
->prev
= *named_merge_points
;
3295 *named_merge_points
= new_named_merge_point
;
3303 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3304 to make it a symbol. If FACE_NAME is an alias for another face,
3305 return that face's name.
3307 Return default face in case of errors. */
3310 resolve_face_name (face_name
, signal_p
)
3311 Lisp_Object face_name
;
3314 Lisp_Object orig_face
;
3315 Lisp_Object tortoise
, hare
;
3317 if (STRINGP (face_name
))
3318 face_name
= intern (SDATA (face_name
));
3320 if (NILP (face_name
) || !SYMBOLP (face_name
))
3323 orig_face
= face_name
;
3324 tortoise
= hare
= face_name
;
3329 hare
= Fget (hare
, Qface_alias
);
3330 if (NILP (hare
) || !SYMBOLP (hare
))
3334 hare
= Fget (hare
, Qface_alias
);
3335 if (NILP (hare
) || !SYMBOLP (hare
))
3338 tortoise
= Fget (tortoise
, Qface_alias
);
3339 if (EQ (hare
, tortoise
))
3342 Fsignal (Qcircular_list
, Fcons (orig_face
, Qnil
));
3351 /* Return the face definition of FACE_NAME on frame F. F null means
3352 return the definition for new frames. FACE_NAME may be a string or
3353 a symbol (apparently Emacs 20.2 allowed strings as face names in
3354 face text properties; Ediff uses that). If FACE_NAME is an alias
3355 for another face, return that face's definition. If SIGNAL_P is
3356 non-zero, signal an error if FACE_NAME is not a valid face name.
3357 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3360 static INLINE Lisp_Object
3361 lface_from_face_name (f
, face_name
, signal_p
)
3363 Lisp_Object face_name
;
3368 face_name
= resolve_face_name (face_name
, signal_p
);
3371 lface
= assq_no_quit (face_name
, f
->face_alist
);
3373 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3376 lface
= XCDR (lface
);
3378 signal_error ("Invalid face", face_name
);
3380 check_lface (lface
);
3385 /* Get face attributes of face FACE_NAME from frame-local faces on
3386 frame F. Store the resulting attributes in ATTRS which must point
3387 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3388 is non-zero, signal an error if FACE_NAME does not name a face.
3389 Otherwise, value is zero if FACE_NAME is not a face. */
3392 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3394 Lisp_Object face_name
;
3401 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3404 bcopy (XVECTOR (lface
)->contents
, attrs
,
3405 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3415 /* Non-zero if all attributes in face attribute vector ATTRS are
3416 specified, i.e. are non-nil. */
3419 lface_fully_specified_p (attrs
)
3424 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3425 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3426 && i
!= LFACE_AVGWIDTH_INDEX
&& i
!= LFACE_FONTSET_INDEX
)
3427 if ((UNSPECIFIEDP (attrs
[i
]) || IGNORE_DEFFACE_P (attrs
[i
]))
3429 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3430 always unspecified. */
3431 && i
!= LFACE_STIPPLE_INDEX
3436 return i
== LFACE_VECTOR_SIZE
;
3439 #ifdef HAVE_WINDOW_SYSTEM
3441 /* Set font-related attributes of Lisp face LFACE from the fullname of
3442 the font opened by FONTNAME. If FORCE_P is zero, set only
3443 unspecified attributes of LFACE. The exception is `font'
3444 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3446 If FONTNAME is not available on frame F,
3447 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3448 If the fullname is not in a valid XLFD format,
3449 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3450 in LFACE and return 1.
3451 Otherwise, return 1. */
3454 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3457 Lisp_Object fontname
;
3458 int force_p
, may_fail_p
;
3460 struct font_name font
;
3465 char *font_name
= SDATA (fontname
);
3466 struct font_info
*font_info
;
3468 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3469 fontset
= fs_query_fontset (fontname
, 0);
3471 font_name
= SDATA (fontset_ascii (fontset
));
3472 else if (fontset
== 0)
3479 /* Check if FONT_NAME is surely available on the system. Usually
3480 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3481 returns quickly. But, even if FONT_NAME is not yet cached,
3482 caching it now is not futail because we anyway load the font
3485 font_info
= FS_LOAD_FONT (f
, font_name
);
3495 font
.name
= STRDUPA (font_info
->full_name
);
3496 have_xlfd_p
= split_font_name (f
, &font
, 1);
3498 /* Set attributes only if unspecified, otherwise face defaults for
3499 new frames would never take effect. If we couldn't get a font
3500 name conforming to XLFD, set normal values. */
3502 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3507 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3508 + strlen (font
.fields
[XLFD_FOUNDRY
])
3510 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3511 font
.fields
[XLFD_FAMILY
]);
3512 val
= build_string (buffer
);
3515 val
= build_string ("*");
3516 LFACE_FAMILY (lface
) = val
;
3519 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3522 pt
= xlfd_point_size (f
, &font
);
3524 pt
= pixel_point_size (f
, font_info
->height
* 10);
3526 LFACE_HEIGHT (lface
) = make_number (pt
);
3529 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3530 LFACE_SWIDTH (lface
)
3531 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3533 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3534 LFACE_AVGWIDTH (lface
)
3536 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3539 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3540 LFACE_WEIGHT (lface
)
3541 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3543 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3545 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3549 LFACE_FONT (lface
) = build_string (font_info
->full_name
);
3550 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3554 LFACE_FONT (lface
) = fontname
;
3556 = new_fontset_from_font_name (build_string (font_info
->full_name
));
3557 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3562 #endif /* HAVE_WINDOW_SYSTEM */
3565 /* Merges the face height FROM with the face height TO, and returns the
3566 merged height. If FROM is an invalid height, then INVALID is
3567 returned instead. FROM and TO may be either absolute face heights or
3568 `relative' heights; the returned value is always an absolute height
3569 unless both FROM and TO are relative. GCPRO is a lisp value that
3570 will be protected from garbage-collection if this function makes a
3574 merge_face_heights (from
, to
, invalid
)
3575 Lisp_Object from
, to
, invalid
;
3577 Lisp_Object result
= invalid
;
3579 if (INTEGERP (from
))
3580 /* FROM is absolute, just use it as is. */
3582 else if (FLOATP (from
))
3583 /* FROM is a scale, use it to adjust TO. */
3586 /* relative X absolute => absolute */
3587 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3588 else if (FLOATP (to
))
3589 /* relative X relative => relative */
3590 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3591 else if (UNSPECIFIEDP (to
))
3594 else if (FUNCTIONP (from
))
3595 /* FROM is a function, which use to adjust TO. */
3597 /* Call function with current height as argument.
3598 From is the new height. */
3599 Lisp_Object args
[2];
3603 result
= safe_call (2, args
);
3605 /* Ensure that if TO was absolute, so is the result. */
3606 if (INTEGERP (to
) && !INTEGERP (result
))
3614 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3615 store the resulting attributes in TO, which must be already be
3616 completely specified and contain only absolute attributes. Every
3617 specified attribute of FROM overrides the corresponding attribute of
3618 TO; relative attributes in FROM are merged with the absolute value in
3619 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3620 loops in face inheritance; it should be 0 when called from other
3624 merge_face_vectors (f
, from
, to
, named_merge_points
)
3626 Lisp_Object
*from
, *to
;
3627 struct named_merge_point
*named_merge_points
;
3631 /* If FROM inherits from some other faces, merge their attributes into
3632 TO before merging FROM's direct attributes. Note that an :inherit
3633 attribute of `unspecified' is the same as one of nil; we never
3634 merge :inherit attributes, so nil is more correct, but lots of
3635 other code uses `unspecified' as a generic value for face attributes. */
3636 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3637 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3638 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3640 /* If TO specifies a :font attribute, and FROM specifies some
3641 font-related attribute, we need to clear TO's :font attribute
3642 (because it will be inconsistent with whatever FROM specifies, and
3643 FROM takes precedence). */
3644 if (!NILP (to
[LFACE_FONT_INDEX
])
3645 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3646 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3647 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3648 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3649 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3650 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3651 to
[LFACE_FONT_INDEX
] = Qnil
;
3653 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3654 if (!UNSPECIFIEDP (from
[i
]))
3656 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3657 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3662 /* TO is always an absolute face, which should inherit from nothing.
3663 We blindly copy the :inherit attribute above and fix it up here. */
3664 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3667 /* Merge the named face FACE_NAME on frame F, into the vector of face
3668 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3669 inheritance. Returns true if FACE_NAME is a valid face name and
3670 merging succeeded. */
3673 merge_named_face (f
, face_name
, to
, named_merge_points
)
3675 Lisp_Object face_name
;
3677 struct named_merge_point
*named_merge_points
;
3679 struct named_merge_point named_merge_point
;
3681 if (push_named_merge_point (&named_merge_point
,
3682 face_name
, &named_merge_points
))
3684 struct gcpro gcpro1
;
3685 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3686 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3690 GCPRO1 (named_merge_point
.face_name
);
3691 merge_face_vectors (f
, from
, to
, named_merge_points
);
3702 /* Merge face attributes from the lisp `face reference' FACE_REF on
3703 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3704 problems with FACE_REF cause an error message to be shown. Return
3705 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3706 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3707 list structure; it may be 0 for most callers.
3709 FACE_REF may be a single face specification or a list of such
3710 specifications. Each face specification can be:
3712 1. A symbol or string naming a Lisp face.
3714 2. A property list of the form (KEYWORD VALUE ...) where each
3715 KEYWORD is a face attribute name, and value is an appropriate value
3718 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3719 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3720 for compatibility with 20.2.
3722 Face specifications earlier in lists take precedence over later
3726 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3728 Lisp_Object face_ref
;
3731 struct named_merge_point
*named_merge_points
;
3733 int ok
= 1; /* Succeed without an error? */
3735 if (CONSP (face_ref
))
3737 Lisp_Object first
= XCAR (face_ref
);
3739 if (EQ (first
, Qforeground_color
)
3740 || EQ (first
, Qbackground_color
))
3742 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3743 . COLOR). COLOR must be a string. */
3744 Lisp_Object color_name
= XCDR (face_ref
);
3745 Lisp_Object color
= first
;
3747 if (STRINGP (color_name
))
3749 if (EQ (color
, Qforeground_color
))
3750 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3752 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3757 add_to_log ("Invalid face color", color_name
, Qnil
);
3761 else if (SYMBOLP (first
)
3762 && *SDATA (SYMBOL_NAME (first
)) == ':')
3764 /* Assume this is the property list form. */
3765 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3767 Lisp_Object keyword
= XCAR (face_ref
);
3768 Lisp_Object value
= XCAR (XCDR (face_ref
));
3771 /* Specifying `unspecified' is a no-op. */
3772 if (EQ (value
, Qunspecified
))
3774 else if (EQ (keyword
, QCfamily
))
3776 if (STRINGP (value
))
3777 to
[LFACE_FAMILY_INDEX
] = value
;
3781 else if (EQ (keyword
, QCheight
))
3783 Lisp_Object new_height
=
3784 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3786 if (! NILP (new_height
))
3787 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3791 else if (EQ (keyword
, QCweight
))
3794 && face_numeric_weight (value
) >= 0)
3795 to
[LFACE_WEIGHT_INDEX
] = value
;
3799 else if (EQ (keyword
, QCslant
))
3802 && face_numeric_slant (value
) >= 0)
3803 to
[LFACE_SLANT_INDEX
] = value
;
3807 else if (EQ (keyword
, QCunderline
))
3812 to
[LFACE_UNDERLINE_INDEX
] = value
;
3816 else if (EQ (keyword
, QCoverline
))
3821 to
[LFACE_OVERLINE_INDEX
] = value
;
3825 else if (EQ (keyword
, QCstrike_through
))
3830 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3834 else if (EQ (keyword
, QCbox
))
3837 value
= make_number (1);
3838 if (INTEGERP (value
)
3842 to
[LFACE_BOX_INDEX
] = value
;
3846 else if (EQ (keyword
, QCinverse_video
)
3847 || EQ (keyword
, QCreverse_video
))
3849 if (EQ (value
, Qt
) || NILP (value
))
3850 to
[LFACE_INVERSE_INDEX
] = value
;
3854 else if (EQ (keyword
, QCforeground
))
3856 if (STRINGP (value
))
3857 to
[LFACE_FOREGROUND_INDEX
] = value
;
3861 else if (EQ (keyword
, QCbackground
))
3863 if (STRINGP (value
))
3864 to
[LFACE_BACKGROUND_INDEX
] = value
;
3868 else if (EQ (keyword
, QCstipple
))
3870 #ifdef HAVE_X_WINDOWS
3871 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3872 if (!NILP (pixmap_p
))
3873 to
[LFACE_STIPPLE_INDEX
] = value
;
3878 else if (EQ (keyword
, QCwidth
))
3881 && face_numeric_swidth (value
) >= 0)
3882 to
[LFACE_SWIDTH_INDEX
] = value
;
3886 else if (EQ (keyword
, QCinherit
))
3888 /* This is not really very useful; it's just like a
3889 normal face reference. */
3890 if (! merge_face_ref (f
, value
, to
,
3891 err_msgs
, named_merge_points
))
3899 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3903 face_ref
= XCDR (XCDR (face_ref
));
3908 /* This is a list of face refs. Those at the beginning of the
3909 list take precedence over what follows, so we have to merge
3910 from the end backwards. */
3911 Lisp_Object next
= XCDR (face_ref
);
3914 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3916 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3922 /* FACE_REF ought to be a face name. */
3923 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3924 if (!ok
&& err_msgs
)
3925 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3932 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3933 Sinternal_make_lisp_face
, 1, 2, 0,
3934 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3935 If FACE was not known as a face before, create a new one.
3936 If optional argument FRAME is specified, make a frame-local face
3937 for that frame. Otherwise operate on the global face definition.
3938 Value is a vector of face attributes. */)
3940 Lisp_Object face
, frame
;
3942 Lisp_Object global_lface
, lface
;
3946 CHECK_SYMBOL (face
);
3947 global_lface
= lface_from_face_name (NULL
, face
, 0);
3951 CHECK_LIVE_FRAME (frame
);
3953 lface
= lface_from_face_name (f
, face
, 0);
3956 f
= NULL
, lface
= Qnil
;
3958 /* Add a global definition if there is none. */
3959 if (NILP (global_lface
))
3961 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3963 AREF (global_lface
, 0) = Qface
;
3964 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3965 Vface_new_frame_defaults
);
3967 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3968 face id to Lisp face is given by the vector lface_id_to_name.
3969 The mapping from Lisp face to Lisp face id is given by the
3970 property `face' of the Lisp face name. */
3971 if (next_lface_id
== lface_id_to_name_size
)
3973 int new_size
= max (50, 2 * lface_id_to_name_size
);
3974 int sz
= new_size
* sizeof *lface_id_to_name
;
3975 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3976 lface_id_to_name_size
= new_size
;
3979 lface_id_to_name
[next_lface_id
] = face
;
3980 Fput (face
, Qface
, make_number (next_lface_id
));
3984 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3985 AREF (global_lface
, i
) = Qunspecified
;
3987 /* Add a frame-local definition. */
3992 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3994 AREF (lface
, 0) = Qface
;
3995 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3998 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3999 AREF (lface
, i
) = Qunspecified
;
4002 lface
= global_lface
;
4004 /* Changing a named face means that all realized faces depending on
4005 that face are invalid. Since we cannot tell which realized faces
4006 depend on the face, make sure they are all removed. This is done
4007 by incrementing face_change_count. The next call to
4008 init_iterator will then free realized faces. */
4009 if (NILP (Fget (face
, Qface_no_inherit
)))
4011 ++face_change_count
;
4012 ++windows_or_buffers_changed
;
4015 xassert (LFACEP (lface
));
4016 check_lface (lface
);
4021 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
4022 Sinternal_lisp_face_p
, 1, 2, 0,
4023 doc
: /* Return non-nil if FACE names a face.
4024 If optional second argument FRAME is non-nil, check for the
4025 existence of a frame-local face with name FACE on that frame.
4026 Otherwise check for the existence of a global face. */)
4028 Lisp_Object face
, frame
;
4034 CHECK_LIVE_FRAME (frame
);
4035 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4038 lface
= lface_from_face_name (NULL
, face
, 0);
4044 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
4045 Sinternal_copy_lisp_face
, 4, 4, 0,
4046 doc
: /* Copy face FROM to TO.
4047 If FRAME is t, copy the global face definition of FROM.
4048 Otherwise, copy the frame-local definition of FROM on FRAME.
4049 If NEW-FRAME is a frame, copy that data into the frame-local
4050 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
4051 FRAME controls where the data is copied to.
4053 The value is TO. */)
4054 (from
, to
, frame
, new_frame
)
4055 Lisp_Object from
, to
, frame
, new_frame
;
4057 Lisp_Object lface
, copy
;
4059 CHECK_SYMBOL (from
);
4064 /* Copy global definition of FROM. We don't make copies of
4065 strings etc. because 20.2 didn't do it either. */
4066 lface
= lface_from_face_name (NULL
, from
, 1);
4067 copy
= Finternal_make_lisp_face (to
, Qnil
);
4071 /* Copy frame-local definition of FROM. */
4072 if (NILP (new_frame
))
4074 CHECK_LIVE_FRAME (frame
);
4075 CHECK_LIVE_FRAME (new_frame
);
4076 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
4077 copy
= Finternal_make_lisp_face (to
, new_frame
);
4080 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
4081 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
4083 /* Changing a named face means that all realized faces depending on
4084 that face are invalid. Since we cannot tell which realized faces
4085 depend on the face, make sure they are all removed. This is done
4086 by incrementing face_change_count. The next call to
4087 init_iterator will then free realized faces. */
4088 if (NILP (Fget (to
, Qface_no_inherit
)))
4090 ++face_change_count
;
4091 ++windows_or_buffers_changed
;
4098 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4099 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4100 doc
: /* Set attribute ATTR of FACE to VALUE.
4101 FRAME being a frame means change the face on that frame.
4102 FRAME nil means change the face of the selected frame.
4103 FRAME t means change the default for new frames.
4104 FRAME 0 means change the face on all frames, and change the default
4106 (face
, attr
, value
, frame
)
4107 Lisp_Object face
, attr
, value
, frame
;
4110 Lisp_Object old_value
= Qnil
;
4111 /* Set 1 if ATTR is QCfont. */
4112 int font_attr_p
= 0;
4113 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4114 int font_related_attr_p
= 0;
4116 CHECK_SYMBOL (face
);
4117 CHECK_SYMBOL (attr
);
4119 face
= resolve_face_name (face
, 1);
4121 /* If FRAME is 0, change face on all frames, and change the
4122 default for new frames. */
4123 if (INTEGERP (frame
) && XINT (frame
) == 0)
4126 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4127 FOR_EACH_FRAME (tail
, frame
)
4128 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4132 /* Set lface to the Lisp attribute vector of FACE. */
4135 lface
= lface_from_face_name (NULL
, face
, 1);
4137 /* When updating face-new-frame-defaults, we put :ignore-defface
4138 where the caller wants `unspecified'. This forces the frame
4139 defaults to ignore the defface value. Otherwise, the defface
4140 will take effect, which is generally not what is intended.
4141 The value of that attribute will be inherited from some other
4142 face during face merging. See internal_merge_in_global_face. */
4143 if (UNSPECIFIEDP (value
))
4144 value
= Qignore_defface
;
4149 frame
= selected_frame
;
4151 CHECK_LIVE_FRAME (frame
);
4152 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4154 /* If a frame-local face doesn't exist yet, create one. */
4156 lface
= Finternal_make_lisp_face (face
, frame
);
4159 if (EQ (attr
, QCfamily
))
4161 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4163 CHECK_STRING (value
);
4164 if (SCHARS (value
) == 0)
4165 signal_error ("Invalid face family", value
);
4167 old_value
= LFACE_FAMILY (lface
);
4168 LFACE_FAMILY (lface
) = value
;
4169 font_related_attr_p
= 1;
4171 else if (EQ (attr
, QCheight
))
4173 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4177 test
= (EQ (face
, Qdefault
)
4179 /* The default face must have an absolute size,
4180 otherwise, we do a test merge with a random
4181 height to see if VALUE's ok. */
4182 : merge_face_heights (value
, make_number (10), Qnil
));
4184 if (!INTEGERP (test
) || XINT (test
) <= 0)
4185 signal_error ("Invalid face height", value
);
4188 old_value
= LFACE_HEIGHT (lface
);
4189 LFACE_HEIGHT (lface
) = value
;
4190 font_related_attr_p
= 1;
4192 else if (EQ (attr
, QCweight
))
4194 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4196 CHECK_SYMBOL (value
);
4197 if (face_numeric_weight (value
) < 0)
4198 signal_error ("Invalid face weight", value
);
4200 old_value
= LFACE_WEIGHT (lface
);
4201 LFACE_WEIGHT (lface
) = value
;
4202 font_related_attr_p
= 1;
4204 else if (EQ (attr
, QCslant
))
4206 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4208 CHECK_SYMBOL (value
);
4209 if (face_numeric_slant (value
) < 0)
4210 signal_error ("Invalid face slant", value
);
4212 old_value
= LFACE_SLANT (lface
);
4213 LFACE_SLANT (lface
) = value
;
4214 font_related_attr_p
= 1;
4216 else if (EQ (attr
, QCunderline
))
4218 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4219 if ((SYMBOLP (value
)
4221 && !EQ (value
, Qnil
))
4222 /* Underline color. */
4224 && SCHARS (value
) == 0))
4225 signal_error ("Invalid face underline", value
);
4227 old_value
= LFACE_UNDERLINE (lface
);
4228 LFACE_UNDERLINE (lface
) = value
;
4230 else if (EQ (attr
, QCoverline
))
4232 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4233 if ((SYMBOLP (value
)
4235 && !EQ (value
, Qnil
))
4236 /* Overline color. */
4238 && SCHARS (value
) == 0))
4239 signal_error ("Invalid face overline", value
);
4241 old_value
= LFACE_OVERLINE (lface
);
4242 LFACE_OVERLINE (lface
) = value
;
4244 else if (EQ (attr
, QCstrike_through
))
4246 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4247 if ((SYMBOLP (value
)
4249 && !EQ (value
, Qnil
))
4250 /* Strike-through color. */
4252 && SCHARS (value
) == 0))
4253 signal_error ("Invalid face strike-through", value
);
4255 old_value
= LFACE_STRIKE_THROUGH (lface
);
4256 LFACE_STRIKE_THROUGH (lface
) = value
;
4258 else if (EQ (attr
, QCbox
))
4262 /* Allow t meaning a simple box of width 1 in foreground color
4265 value
= make_number (1);
4267 if (UNSPECIFIEDP (value
) || IGNORE_DEFFACE_P (value
))
4269 else if (NILP (value
))
4271 else if (INTEGERP (value
))
4272 valid_p
= XINT (value
) != 0;
4273 else if (STRINGP (value
))
4274 valid_p
= SCHARS (value
) > 0;
4275 else if (CONSP (value
))
4291 if (EQ (k
, QCline_width
))
4293 if (!INTEGERP (v
) || XINT (v
) == 0)
4296 else if (EQ (k
, QCcolor
))
4298 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4301 else if (EQ (k
, QCstyle
))
4303 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4310 valid_p
= NILP (tem
);
4316 signal_error ("Invalid face box", value
);
4318 old_value
= LFACE_BOX (lface
);
4319 LFACE_BOX (lface
) = value
;
4321 else if (EQ (attr
, QCinverse_video
)
4322 || EQ (attr
, QCreverse_video
))
4324 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4326 CHECK_SYMBOL (value
);
4327 if (!EQ (value
, Qt
) && !NILP (value
))
4328 signal_error ("Invalid inverse-video face attribute value", value
);
4330 old_value
= LFACE_INVERSE (lface
);
4331 LFACE_INVERSE (lface
) = value
;
4333 else if (EQ (attr
, QCforeground
))
4335 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4337 /* Don't check for valid color names here because it depends
4338 on the frame (display) whether the color will be valid
4339 when the face is realized. */
4340 CHECK_STRING (value
);
4341 if (SCHARS (value
) == 0)
4342 signal_error ("Empty foreground color value", value
);
4344 old_value
= LFACE_FOREGROUND (lface
);
4345 LFACE_FOREGROUND (lface
) = value
;
4347 else if (EQ (attr
, QCbackground
))
4349 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4351 /* Don't check for valid color names here because it depends
4352 on the frame (display) whether the color will be valid
4353 when the face is realized. */
4354 CHECK_STRING (value
);
4355 if (SCHARS (value
) == 0)
4356 signal_error ("Empty background color value", value
);
4358 old_value
= LFACE_BACKGROUND (lface
);
4359 LFACE_BACKGROUND (lface
) = value
;
4361 else if (EQ (attr
, QCstipple
))
4363 #ifdef HAVE_X_WINDOWS
4364 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4366 && NILP (Fbitmap_spec_p (value
)))
4367 signal_error ("Invalid stipple attribute", value
);
4368 old_value
= LFACE_STIPPLE (lface
);
4369 LFACE_STIPPLE (lface
) = value
;
4370 #endif /* HAVE_X_WINDOWS */
4372 else if (EQ (attr
, QCwidth
))
4374 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4376 CHECK_SYMBOL (value
);
4377 if (face_numeric_swidth (value
) < 0)
4378 signal_error ("Invalid face width", value
);
4380 old_value
= LFACE_SWIDTH (lface
);
4381 LFACE_SWIDTH (lface
) = value
;
4382 font_related_attr_p
= 1;
4384 else if (EQ (attr
, QCfont
) || EQ (attr
, QCfontset
))
4386 #ifdef HAVE_WINDOW_SYSTEM
4387 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4389 /* Set font-related attributes of the Lisp face from an XLFD
4395 f
= SELECTED_FRAME ();
4397 f
= check_x_frame (frame
);
4399 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4401 CHECK_STRING (value
);
4403 /* VALUE may be a fontset name or an alias of fontset. In
4404 such a case, use the base fontset name. */
4405 tmp
= Fquery_fontset (value
, Qnil
);
4408 else if (EQ (attr
, QCfontset
))
4409 signal_error ("Invalid fontset name", value
);
4411 if (EQ (attr
, QCfont
))
4413 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4414 signal_error ("Invalid font or fontset name", value
);
4417 LFACE_FONTSET (lface
) = value
;
4422 #endif /* HAVE_WINDOW_SYSTEM */
4424 else if (EQ (attr
, QCinherit
))
4427 if (SYMBOLP (value
))
4430 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4431 if (!SYMBOLP (XCAR (tail
)))
4434 LFACE_INHERIT (lface
) = value
;
4436 signal_error ("Invalid face inheritance", value
);
4438 else if (EQ (attr
, QCbold
))
4440 old_value
= LFACE_WEIGHT (lface
);
4441 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4442 font_related_attr_p
= 1;
4444 else if (EQ (attr
, QCitalic
))
4446 old_value
= LFACE_SLANT (lface
);
4447 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4448 font_related_attr_p
= 1;
4451 signal_error ("Invalid face attribute name", attr
);
4453 if (font_related_attr_p
4454 && !UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4455 /* If a font-related attribute other than QCfont is specified, the
4456 original `font' attribute nor that of default face is useless
4457 to determine a new font. Thus, we set it to nil so that font
4458 selection mechanism doesn't use it. */
4459 LFACE_FONT (lface
) = Qnil
;
4461 /* Changing a named face means that all realized faces depending on
4462 that face are invalid. Since we cannot tell which realized faces
4463 depend on the face, make sure they are all removed. This is done
4464 by incrementing face_change_count. The next call to
4465 init_iterator will then free realized faces. */
4467 && NILP (Fget (face
, Qface_no_inherit
))
4468 && (EQ (attr
, QCfont
)
4469 || EQ (attr
, QCfontset
)
4470 || NILP (Fequal (old_value
, value
))))
4472 ++face_change_count
;
4473 ++windows_or_buffers_changed
;
4476 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4477 && NILP (Fequal (old_value
, value
)))
4483 if (EQ (face
, Qdefault
))
4485 #ifdef HAVE_WINDOW_SYSTEM
4486 /* Changed font-related attributes of the `default' face are
4487 reflected in changed `font' frame parameters. */
4489 && (font_related_attr_p
|| font_attr_p
)
4490 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4491 set_font_frame_param (frame
, lface
);
4493 #endif /* HAVE_WINDOW_SYSTEM */
4495 if (EQ (attr
, QCforeground
))
4496 param
= Qforeground_color
;
4497 else if (EQ (attr
, QCbackground
))
4498 param
= Qbackground_color
;
4500 #ifdef HAVE_WINDOW_SYSTEM
4502 else if (EQ (face
, Qscroll_bar
))
4504 /* Changing the colors of `scroll-bar' sets frame parameters
4505 `scroll-bar-foreground' and `scroll-bar-background'. */
4506 if (EQ (attr
, QCforeground
))
4507 param
= Qscroll_bar_foreground
;
4508 else if (EQ (attr
, QCbackground
))
4509 param
= Qscroll_bar_background
;
4511 #endif /* not WINDOWSNT */
4512 else if (EQ (face
, Qborder
))
4514 /* Changing background color of `border' sets frame parameter
4516 if (EQ (attr
, QCbackground
))
4517 param
= Qborder_color
;
4519 else if (EQ (face
, Qcursor
))
4521 /* Changing background color of `cursor' sets frame parameter
4523 if (EQ (attr
, QCbackground
))
4524 param
= Qcursor_color
;
4526 else if (EQ (face
, Qmouse
))
4528 /* Changing background color of `mouse' sets frame parameter
4530 if (EQ (attr
, QCbackground
))
4531 param
= Qmouse_color
;
4533 #endif /* HAVE_WINDOW_SYSTEM */
4534 else if (EQ (face
, Qmenu
))
4536 /* Indicate that we have to update the menu bar when
4537 realizing faces on FRAME. FRAME t change the
4538 default for new frames. We do this by setting
4539 setting the flag in new face caches */
4542 struct frame
*f
= XFRAME (frame
);
4543 if (FRAME_FACE_CACHE (f
) == NULL
)
4544 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4545 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4548 menu_face_changed_default
= 1;
4554 /* Update `default-frame-alist', which is used for new frames. */
4556 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4559 /* Update the current frame's parameters. */
4562 cons
= XCAR (Vparam_value_alist
);
4563 XSETCAR (cons
, param
);
4564 XSETCDR (cons
, value
);
4565 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4574 #ifdef HAVE_WINDOW_SYSTEM
4576 /* Set the `font' frame parameter of FRAME determined from `default'
4577 face attributes LFACE. If a font name is explicitely
4578 specfied in LFACE, use it as is. Otherwise, determine a font name
4579 from the other font-related atrributes of LFACE. In that case, if
4580 there's no matching font, signals an error. */
4583 set_font_frame_param (frame
, lface
)
4584 Lisp_Object frame
, lface
;
4586 struct frame
*f
= XFRAME (frame
);
4588 if (FRAME_WINDOW_P (f
))
4590 Lisp_Object font_name
;
4593 if (STRINGP (LFACE_FONT (lface
)))
4594 font_name
= LFACE_FONT (lface
);
4597 /* Choose a font name that reflects LFACE's attributes and has
4598 the registry and encoding pattern specified in the default
4599 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4600 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, Qnil
, NULL
);
4602 error ("No font matches the specified attribute");
4603 font_name
= build_string (font
);
4607 f
->default_face_done_p
= 0;
4608 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4613 /* Update the corresponding face when frame parameter PARAM on frame F
4614 has been assigned the value NEW_VALUE. */
4617 update_face_from_frame_parameter (f
, param
, new_value
)
4619 Lisp_Object param
, new_value
;
4621 Lisp_Object face
= Qnil
;
4624 /* If there are no faces yet, give up. This is the case when called
4625 from Fx_create_frame, and we do the necessary things later in
4626 face-set-after-frame-defaults. */
4627 if (NILP (f
->face_alist
))
4630 if (EQ (param
, Qforeground_color
))
4633 lface
= lface_from_face_name (f
, face
, 1);
4634 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4635 ? new_value
: Qunspecified
);
4636 realize_basic_faces (f
);
4638 else if (EQ (param
, Qbackground_color
))
4642 /* Changing the background color might change the background
4643 mode, so that we have to load new defface specs.
4644 Call frame-set-background-mode to do that. */
4645 XSETFRAME (frame
, f
);
4646 call1 (Qframe_set_background_mode
, frame
);
4649 lface
= lface_from_face_name (f
, face
, 1);
4650 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4651 ? new_value
: Qunspecified
);
4652 realize_basic_faces (f
);
4654 else if (EQ (param
, Qborder_color
))
4657 lface
= lface_from_face_name (f
, face
, 1);
4658 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4659 ? new_value
: Qunspecified
);
4661 else if (EQ (param
, Qcursor_color
))
4664 lface
= lface_from_face_name (f
, face
, 1);
4665 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4666 ? new_value
: Qunspecified
);
4668 else if (EQ (param
, Qmouse_color
))
4671 lface
= lface_from_face_name (f
, face
, 1);
4672 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4673 ? new_value
: Qunspecified
);
4676 /* Changing a named face means that all realized faces depending on
4677 that face are invalid. Since we cannot tell which realized faces
4678 depend on the face, make sure they are all removed. This is done
4679 by incrementing face_change_count. The next call to
4680 init_iterator will then free realized faces. */
4682 && NILP (Fget (face
, Qface_no_inherit
)))
4684 ++face_change_count
;
4685 ++windows_or_buffers_changed
;
4690 /* Get the value of X resource RESOURCE, class CLASS for the display
4691 of frame FRAME. This is here because ordinary `x-get-resource'
4692 doesn't take a frame argument. */
4694 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4695 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4696 (resource
, class, frame
)
4697 Lisp_Object resource
, class, frame
;
4699 Lisp_Object value
= Qnil
;
4700 CHECK_STRING (resource
);
4701 CHECK_STRING (class);
4702 CHECK_LIVE_FRAME (frame
);
4704 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4705 resource
, class, Qnil
, Qnil
);
4711 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4712 If VALUE is "on" or "true", return t. If VALUE is "off" or
4713 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4714 error; if SIGNAL_P is zero, return 0. */
4717 face_boolean_x_resource_value (value
, signal_p
)
4721 Lisp_Object result
= make_number (0);
4723 xassert (STRINGP (value
));
4725 if (xstricmp (SDATA (value
), "on") == 0
4726 || xstricmp (SDATA (value
), "true") == 0)
4728 else if (xstricmp (SDATA (value
), "off") == 0
4729 || xstricmp (SDATA (value
), "false") == 0)
4731 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4732 result
= Qunspecified
;
4734 signal_error ("Invalid face attribute value from X resource", value
);
4740 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4741 Finternal_set_lisp_face_attribute_from_resource
,
4742 Sinternal_set_lisp_face_attribute_from_resource
,
4743 3, 4, 0, doc
: /* */)
4744 (face
, attr
, value
, frame
)
4745 Lisp_Object face
, attr
, value
, frame
;
4747 CHECK_SYMBOL (face
);
4748 CHECK_SYMBOL (attr
);
4749 CHECK_STRING (value
);
4751 if (xstricmp (SDATA (value
), "unspecified") == 0)
4752 value
= Qunspecified
;
4753 else if (EQ (attr
, QCheight
))
4755 value
= Fstring_to_number (value
, make_number (10));
4756 if (XINT (value
) <= 0)
4757 signal_error ("Invalid face height from X resource", value
);
4759 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4760 value
= face_boolean_x_resource_value (value
, 1);
4761 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4762 value
= intern (SDATA (value
));
4763 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4764 value
= face_boolean_x_resource_value (value
, 1);
4765 else if (EQ (attr
, QCunderline
)
4766 || EQ (attr
, QCoverline
)
4767 || EQ (attr
, QCstrike_through
))
4769 Lisp_Object boolean_value
;
4771 /* If the result of face_boolean_x_resource_value is t or nil,
4772 VALUE does NOT specify a color. */
4773 boolean_value
= face_boolean_x_resource_value (value
, 0);
4774 if (SYMBOLP (boolean_value
))
4775 value
= boolean_value
;
4777 else if (EQ (attr
, QCbox
) || EQ (attr
, QCinherit
))
4778 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4780 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4783 #endif /* HAVE_WINDOW_SYSTEM */
4786 /***********************************************************************
4788 ***********************************************************************/
4790 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4792 /* Make menus on frame F appear as specified by the `menu' face. */
4795 x_update_menu_appearance (f
)
4798 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4802 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4806 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4807 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4808 const char *myname
= SDATA (Vx_resource_name
);
4811 const char *popup_path
= "popup_menu";
4813 const char *popup_path
= "menu.popup";
4816 if (STRINGP (LFACE_FOREGROUND (lface
)))
4818 sprintf (line
, "%s.%s*foreground: %s",
4820 SDATA (LFACE_FOREGROUND (lface
)));
4821 XrmPutLineResource (&rdb
, line
);
4822 sprintf (line
, "%s.pane.menubar*foreground: %s",
4823 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4824 XrmPutLineResource (&rdb
, line
);
4828 if (STRINGP (LFACE_BACKGROUND (lface
)))
4830 sprintf (line
, "%s.%s*background: %s",
4832 SDATA (LFACE_BACKGROUND (lface
)));
4833 XrmPutLineResource (&rdb
, line
);
4834 sprintf (line
, "%s.pane.menubar*background: %s",
4835 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4836 XrmPutLineResource (&rdb
, line
);
4841 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4842 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4843 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4844 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4845 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4846 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4849 const char *suffix
= "List";
4852 #if defined HAVE_X_I18N
4854 const char *suffix
= "Set";
4856 const char *suffix
= "";
4860 #if defined HAVE_X_I18N
4861 extern char *xic_create_fontsetname
4862 P_ ((char *base_fontname
, Bool motif
));
4863 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
4865 char *fontsetname
= face
->font_name
;
4867 sprintf (line
, "%s.pane.menubar*font%s: %s",
4868 myname
, suffix
, fontsetname
);
4869 XrmPutLineResource (&rdb
, line
);
4870 sprintf (line
, "%s.%s*font%s: %s",
4871 myname
, popup_path
, suffix
, fontsetname
);
4872 XrmPutLineResource (&rdb
, line
);
4874 if (fontsetname
!= face
->font_name
)
4875 xfree (fontsetname
);
4878 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4879 free_frame_menubar (f
);
4883 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4886 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4887 Sface_attribute_relative_p
,
4889 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4891 Lisp_Object attribute
, value
;
4893 if (EQ (value
, Qunspecified
) || (EQ (value
, Qignore_defface
)))
4895 else if (EQ (attribute
, QCheight
))
4896 return INTEGERP (value
) ? Qnil
: Qt
;
4901 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4903 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4904 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4905 the result will be absolute, otherwise it will be relative. */)
4906 (attribute
, value1
, value2
)
4907 Lisp_Object attribute
, value1
, value2
;
4909 if (EQ (value1
, Qunspecified
) || EQ (value1
, Qignore_defface
))
4911 else if (EQ (attribute
, QCheight
))
4912 return merge_face_heights (value1
, value2
, value1
);
4918 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4919 Sinternal_get_lisp_face_attribute
,
4921 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4922 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4923 face attribute name, signal an error.
4924 If the optional argument FRAME is given, report on face SYMBOL in that
4925 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4926 frames). If FRAME is omitted or nil, use the selected frame. */)
4927 (symbol
, keyword
, frame
)
4928 Lisp_Object symbol
, keyword
, frame
;
4930 Lisp_Object lface
, value
= Qnil
;
4932 CHECK_SYMBOL (symbol
);
4933 CHECK_SYMBOL (keyword
);
4936 lface
= lface_from_face_name (NULL
, symbol
, 1);
4940 frame
= selected_frame
;
4941 CHECK_LIVE_FRAME (frame
);
4942 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4945 if (EQ (keyword
, QCfamily
))
4946 value
= LFACE_FAMILY (lface
);
4947 else if (EQ (keyword
, QCheight
))
4948 value
= LFACE_HEIGHT (lface
);
4949 else if (EQ (keyword
, QCweight
))
4950 value
= LFACE_WEIGHT (lface
);
4951 else if (EQ (keyword
, QCslant
))
4952 value
= LFACE_SLANT (lface
);
4953 else if (EQ (keyword
, QCunderline
))
4954 value
= LFACE_UNDERLINE (lface
);
4955 else if (EQ (keyword
, QCoverline
))
4956 value
= LFACE_OVERLINE (lface
);
4957 else if (EQ (keyword
, QCstrike_through
))
4958 value
= LFACE_STRIKE_THROUGH (lface
);
4959 else if (EQ (keyword
, QCbox
))
4960 value
= LFACE_BOX (lface
);
4961 else if (EQ (keyword
, QCinverse_video
)
4962 || EQ (keyword
, QCreverse_video
))
4963 value
= LFACE_INVERSE (lface
);
4964 else if (EQ (keyword
, QCforeground
))
4965 value
= LFACE_FOREGROUND (lface
);
4966 else if (EQ (keyword
, QCbackground
))
4967 value
= LFACE_BACKGROUND (lface
);
4968 else if (EQ (keyword
, QCstipple
))
4969 value
= LFACE_STIPPLE (lface
);
4970 else if (EQ (keyword
, QCwidth
))
4971 value
= LFACE_SWIDTH (lface
);
4972 else if (EQ (keyword
, QCinherit
))
4973 value
= LFACE_INHERIT (lface
);
4974 else if (EQ (keyword
, QCfont
))
4975 value
= LFACE_FONT (lface
);
4976 else if (EQ (keyword
, QCfontset
))
4977 value
= LFACE_FONTSET (lface
);
4979 signal_error ("Invalid face attribute name", keyword
);
4981 if (IGNORE_DEFFACE_P (value
))
4982 return Qunspecified
;
4988 DEFUN ("internal-lisp-face-attribute-values",
4989 Finternal_lisp_face_attribute_values
,
4990 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4991 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4992 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4996 Lisp_Object result
= Qnil
;
4998 CHECK_SYMBOL (attr
);
5000 if (EQ (attr
, QCweight
)
5001 || EQ (attr
, QCslant
)
5002 || EQ (attr
, QCwidth
))
5004 /* Extract permissible symbols from tables. */
5005 struct table_entry
*table
;
5008 if (EQ (attr
, QCweight
))
5009 table
= weight_table
, dim
= DIM (weight_table
);
5010 else if (EQ (attr
, QCslant
))
5011 table
= slant_table
, dim
= DIM (slant_table
);
5013 table
= swidth_table
, dim
= DIM (swidth_table
);
5015 for (i
= 0; i
< dim
; ++i
)
5017 Lisp_Object symbol
= *table
[i
].symbol
;
5018 Lisp_Object tail
= result
;
5021 && !EQ (XCAR (tail
), symbol
))
5025 result
= Fcons (symbol
, result
);
5028 else if (EQ (attr
, QCunderline
))
5029 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5030 else if (EQ (attr
, QCoverline
))
5031 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5032 else if (EQ (attr
, QCstrike_through
))
5033 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5034 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
5035 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5041 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
5042 Sinternal_merge_in_global_face
, 2, 2, 0,
5043 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
5044 Default face attributes override any local face attributes. */)
5046 Lisp_Object face
, frame
;
5049 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
5051 CHECK_LIVE_FRAME (frame
);
5052 global_lface
= lface_from_face_name (NULL
, face
, 1);
5053 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
5054 if (NILP (local_lface
))
5055 local_lface
= Finternal_make_lisp_face (face
, frame
);
5057 /* Make every specified global attribute override the local one.
5058 BEWARE!! This is only used from `face-set-after-frame-default' where
5059 the local frame is defined from default specs in `face-defface-spec'
5060 and those should be overridden by global settings. Hence the strange
5061 "global before local" priority. */
5062 lvec
= XVECTOR (local_lface
)->contents
;
5063 gvec
= XVECTOR (global_lface
)->contents
;
5064 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5065 if (! UNSPECIFIEDP (gvec
[i
]))
5066 if (IGNORE_DEFFACE_P (gvec
[i
]))
5067 lvec
[i
] = Qunspecified
;
5075 /* The following function is implemented for compatibility with 20.2.
5076 The function is used in x-resolve-fonts when it is asked to
5077 return fonts with the same size as the font of a face. This is
5078 done in fontset.el. */
5080 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 3, 0,
5081 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
5082 The font name is, by default, for ASCII characters.
5083 If the optional argument FRAME is given, report on face FACE in that frame.
5084 If FRAME is t, report on the defaults for face FACE (for new frames).
5085 The font default for a face is either nil, or a list
5086 of the form (bold), (italic) or (bold italic).
5087 If FRAME is omitted or nil, use the selected frame. And, in this case,
5088 if the optional third argument CHARACTER is given,
5089 return the font name used for CHARACTER. */)
5090 (face
, frame
, character
)
5091 Lisp_Object face
, frame
, character
;
5095 Lisp_Object result
= Qnil
;
5096 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
5098 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
5099 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
5100 result
= Fcons (Qbold
, result
);
5102 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
5103 && !EQ (LFACE_SLANT (lface
), Qnormal
))
5104 result
= Fcons (Qitalic
, result
);
5110 struct frame
*f
= frame_or_selected_frame (frame
, 1);
5111 int face_id
= lookup_named_face (f
, face
, 1);
5112 struct face
*face
= FACE_FROM_ID (f
, face_id
);
5116 #ifdef HAVE_WINDOW_SYSTEM
5117 if (FRAME_WINDOW_P (f
) && !NILP (character
))
5119 CHECK_CHARACTER (character
);
5120 face_id
= FACE_FOR_CHAR (f
, face
, XINT (character
), -1, Qnil
);
5121 face
= FACE_FROM_ID (f
, face_id
);
5122 return (face
->font
&& face
->font_name
5123 ? build_string (face
->font_name
)
5127 return build_string (face
->font_name
);
5132 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
5133 all attributes are `equal'. Tries to be fast because this function
5134 is called quite often. */
5137 face_attr_equal_p (v1
, v2
)
5140 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5141 and the other is specified. */
5142 if (XTYPE (v1
) != XTYPE (v2
))
5151 if (SBYTES (v1
) != SBYTES (v2
))
5154 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5161 return !NILP (Fequal (v1
, v2
));
5166 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5167 all attributes are `equal'. Tries to be fast because this function
5168 is called quite often. */
5171 lface_equal_p (v1
, v2
)
5172 Lisp_Object
*v1
, *v2
;
5176 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5177 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5183 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5184 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5185 doc
: /* True if FACE1 and FACE2 are equal.
5186 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
5187 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
5188 If FRAME is omitted or nil, use the selected frame. */)
5189 (face1
, face2
, frame
)
5190 Lisp_Object face1
, face2
, frame
;
5194 Lisp_Object lface1
, lface2
;
5199 /* Don't use check_x_frame here because this function is called
5200 before X frames exist. At that time, if FRAME is nil,
5201 selected_frame will be used which is the frame dumped with
5202 Emacs. That frame is not an X frame. */
5203 f
= frame_or_selected_frame (frame
, 2);
5205 lface1
= lface_from_face_name (f
, face1
, 1);
5206 lface2
= lface_from_face_name (f
, face2
, 1);
5207 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5208 XVECTOR (lface2
)->contents
);
5209 return equal_p
? Qt
: Qnil
;
5213 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5214 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5215 doc
: /* True if FACE has no attribute specified.
5216 If the optional argument FRAME is given, report on face FACE in that frame.
5217 If FRAME is t, report on the defaults for face FACE (for new frames).
5218 If FRAME is omitted or nil, use the selected frame. */)
5220 Lisp_Object face
, frame
;
5227 frame
= selected_frame
;
5228 CHECK_LIVE_FRAME (frame
);
5232 lface
= lface_from_face_name (NULL
, face
, 1);
5234 lface
= lface_from_face_name (f
, face
, 1);
5236 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5237 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5240 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5244 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5246 doc
: /* Return an alist of frame-local faces defined on FRAME.
5247 For internal use only. */)
5251 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5252 return f
->face_alist
;
5256 /* Return a hash code for Lisp string STRING with case ignored. Used
5257 below in computing a hash value for a Lisp face. */
5259 static INLINE
unsigned
5260 hash_string_case_insensitive (string
)
5263 const unsigned char *s
;
5265 xassert (STRINGP (string
));
5266 for (s
= SDATA (string
); *s
; ++s
)
5267 hash
= (hash
<< 1) ^ tolower (*s
);
5272 /* Return a hash code for face attribute vector V. */
5274 static INLINE
unsigned
5278 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5279 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5280 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5281 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5282 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5283 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5284 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5288 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5289 considering charsets/registries). They do if they specify the same
5290 family, point size, weight, width, slant, font, and fontset. Both
5291 LFACE1 and LFACE2 must be fully-specified. */
5294 lface_same_font_attributes_p (lface1
, lface2
)
5295 Lisp_Object
*lface1
, *lface2
;
5297 xassert (lface_fully_specified_p (lface1
)
5298 && lface_fully_specified_p (lface2
));
5299 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5300 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5301 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5302 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5303 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5304 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5305 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5306 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5307 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5308 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5309 && ! xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5310 SDATA (lface2
[LFACE_FONT_INDEX
]))))
5311 && (EQ (lface1
[LFACE_FONTSET_INDEX
], lface2
[LFACE_FONTSET_INDEX
])
5312 || (STRINGP (lface1
[LFACE_FONTSET_INDEX
])
5313 && STRINGP (lface2
[LFACE_FONTSET_INDEX
])
5314 && ! xstricmp (SDATA (lface1
[LFACE_FONTSET_INDEX
]),
5315 SDATA (lface2
[LFACE_FONTSET_INDEX
]))))
5321 /***********************************************************************
5323 ***********************************************************************/
5325 /* Allocate and return a new realized face for Lisp face attribute
5328 static struct face
*
5329 make_realized_face (attr
)
5332 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5333 bzero (face
, sizeof *face
);
5334 face
->ascii_face
= face
;
5335 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5340 /* Free realized face FACE, including its X resources. FACE may
5344 free_realized_face (f
, face
)
5350 #ifdef HAVE_WINDOW_SYSTEM
5351 if (FRAME_WINDOW_P (f
))
5353 /* Free fontset of FACE if it is ASCII face. */
5354 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5355 free_face_fontset (f
, face
);
5358 x_free_gc (f
, face
->gc
);
5362 free_face_colors (f
, face
);
5363 x_destroy_bitmap (f
, face
->stipple
);
5365 #endif /* HAVE_WINDOW_SYSTEM */
5372 /* Prepare face FACE for subsequent display on frame F. This
5373 allocated GCs if they haven't been allocated yet or have been freed
5374 by clearing the face cache. */
5377 prepare_face_for_display (f
, face
)
5381 #ifdef HAVE_WINDOW_SYSTEM
5382 xassert (FRAME_WINDOW_P (f
));
5387 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5389 xgcv
.foreground
= face
->foreground
;
5390 xgcv
.background
= face
->background
;
5391 #ifdef HAVE_X_WINDOWS
5392 xgcv
.graphics_exposures
= False
;
5394 /* The font of FACE may be null if we couldn't load it. */
5397 #ifdef HAVE_X_WINDOWS
5398 xgcv
.font
= face
->font
->fid
;
5401 xgcv
.font
= face
->font
;
5404 xgcv
.font
= face
->font
;
5410 #ifdef HAVE_X_WINDOWS
5413 xgcv
.fill_style
= FillOpaqueStippled
;
5414 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5415 mask
|= GCFillStyle
| GCStipple
;
5418 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5421 #endif /* HAVE_WINDOW_SYSTEM */
5425 /* Returns the `distance' between the colors X and Y. */
5428 color_distance (x
, y
)
5431 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5432 Quoting from that paper:
5434 This formula has results that are very close to L*u*v* (with the
5435 modified lightness curve) and, more importantly, it is a more even
5436 algorithm: it does not have a range of colours where it suddenly
5437 gives far from optimal results.
5439 See <http://www.compuphase.com/cmetric.htm> for more info. */
5441 long r
= (x
->red
- y
->red
) >> 8;
5442 long g
= (x
->green
- y
->green
) >> 8;
5443 long b
= (x
->blue
- y
->blue
) >> 8;
5444 long r_mean
= (x
->red
+ y
->red
) >> 9;
5447 (((512 + r_mean
) * r
* r
) >> 8)
5449 + (((767 - r_mean
) * b
* b
) >> 8);
5453 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5454 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5455 COLOR1 and COLOR2 may be either strings containing the color name,
5456 or lists of the form (RED GREEN BLUE).
5457 If FRAME is unspecified or nil, the current frame is used. */)
5458 (color1
, color2
, frame
)
5459 Lisp_Object color1
, color2
, frame
;
5462 XColor cdef1
, cdef2
;
5465 frame
= selected_frame
;
5466 CHECK_LIVE_FRAME (frame
);
5469 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5470 || !STRINGP (color1
)
5471 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5472 signal_error ("Invalid color", color1
);
5473 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5474 || !STRINGP (color2
)
5475 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5476 signal_error ("Invalid color", color2
);
5478 return make_number (color_distance (&cdef1
, &cdef2
));
5482 /***********************************************************************
5484 ***********************************************************************/
5486 /* Return a new face cache for frame F. */
5488 static struct face_cache
*
5492 struct face_cache
*c
;
5495 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5496 bzero (c
, sizeof *c
);
5497 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5498 c
->buckets
= (struct face
**) xmalloc (size
);
5499 bzero (c
->buckets
, size
);
5501 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5503 c
->menu_face_changed_p
= menu_face_changed_default
;
5508 /* Clear out all graphics contexts for all realized faces, except for
5509 the basic faces. This should be done from time to time just to avoid
5510 keeping too many graphics contexts that are no longer needed. */
5514 struct face_cache
*c
;
5516 if (c
&& FRAME_WINDOW_P (c
->f
))
5518 #ifdef HAVE_WINDOW_SYSTEM
5520 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5522 struct face
*face
= c
->faces_by_id
[i
];
5523 if (face
&& face
->gc
)
5525 x_free_gc (c
->f
, face
->gc
);
5529 #endif /* HAVE_WINDOW_SYSTEM */
5534 /* Free all realized faces in face cache C, including basic faces.
5535 C may be null. If faces are freed, make sure the frame's current
5536 matrix is marked invalid, so that a display caused by an expose
5537 event doesn't try to use faces we destroyed. */
5540 free_realized_faces (c
)
5541 struct face_cache
*c
;
5546 struct frame
*f
= c
->f
;
5548 /* We must block input here because we can't process X events
5549 safely while only some faces are freed, or when the frame's
5550 current matrix still references freed faces. */
5553 for (i
= 0; i
< c
->used
; ++i
)
5555 free_realized_face (f
, c
->faces_by_id
[i
]);
5556 c
->faces_by_id
[i
] = NULL
;
5560 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5561 bzero (c
->buckets
, size
);
5563 /* Must do a thorough redisplay the next time. Mark current
5564 matrices as invalid because they will reference faces freed
5565 above. This function is also called when a frame is
5566 destroyed. In this case, the root window of F is nil. */
5567 if (WINDOWP (f
->root_window
))
5569 clear_current_matrices (f
);
5570 ++windows_or_buffers_changed
;
5578 /* Free all realized faces that are using FONTSET on frame F. */
5581 free_realized_faces_for_fontset (f
, fontset
)
5585 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5589 /* We must block input here because we can't process X events safely
5590 while only some faces are freed, or when the frame's current
5591 matrix still references freed faces. */
5594 for (i
= 0; i
< cache
->used
; i
++)
5596 face
= cache
->faces_by_id
[i
];
5598 && face
->fontset
== fontset
)
5600 uncache_face (cache
, face
);
5601 free_realized_face (f
, face
);
5605 /* Must do a thorough redisplay the next time. Mark current
5606 matrices as invalid because they will reference faces freed
5607 above. This function is also called when a frame is destroyed.
5608 In this case, the root window of F is nil. */
5609 if (WINDOWP (f
->root_window
))
5611 clear_current_matrices (f
);
5612 ++windows_or_buffers_changed
;
5619 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5620 This is done after attributes of a named face have been changed,
5621 because we can't tell which realized faces depend on that face. */
5624 free_all_realized_faces (frame
)
5630 FOR_EACH_FRAME (rest
, frame
)
5631 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5634 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5638 /* Free face cache C and faces in it, including their X resources. */
5642 struct face_cache
*c
;
5646 free_realized_faces (c
);
5648 xfree (c
->faces_by_id
);
5654 /* Cache realized face FACE in face cache C. HASH is the hash value
5655 of FACE. If FACE is for ASCII characters (i.e. FACE->ascii_face ==
5656 FACE), insert the new face to the beginning of the collision list
5657 of the face hash table of C. Otherwise, add the new face to the
5658 end of the collision list. This way, lookup_face can quickly find
5659 that a requested face is not cached. */
5662 cache_face (c
, face
, hash
)
5663 struct face_cache
*c
;
5667 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5671 if (face
->ascii_face
!= face
)
5673 struct face
*last
= c
->buckets
[i
];
5684 c
->buckets
[i
] = face
;
5685 face
->prev
= face
->next
= NULL
;
5691 face
->next
= c
->buckets
[i
];
5693 face
->next
->prev
= face
;
5694 c
->buckets
[i
] = face
;
5697 /* Find a free slot in C->faces_by_id and use the index of the free
5698 slot as FACE->id. */
5699 for (i
= 0; i
< c
->used
; ++i
)
5700 if (c
->faces_by_id
[i
] == NULL
)
5704 /* Maybe enlarge C->faces_by_id. */
5707 if (c
->used
== c
->size
)
5710 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5711 if (new_size
== c
->size
)
5712 abort (); /* Alternatives? ++kfs */
5713 sz
= new_size
* sizeof *c
->faces_by_id
;
5714 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5721 /* Check that FACE got a unique id. */
5726 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5727 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5733 #endif /* GLYPH_DEBUG */
5735 c
->faces_by_id
[i
] = face
;
5739 /* Remove face FACE from cache C. */
5742 uncache_face (c
, face
)
5743 struct face_cache
*c
;
5746 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5749 face
->prev
->next
= face
->next
;
5751 c
->buckets
[i
] = face
->next
;
5754 face
->next
->prev
= face
->prev
;
5756 c
->faces_by_id
[face
->id
] = NULL
;
5757 if (face
->id
== c
->used
)
5762 /* Look up a realized face with face attributes ATTR in the face cache
5763 of frame F. The face will be used to display ASCII characters.
5764 Value is the ID of the face found. If no suitable face is found,
5765 realize a new one. */
5768 lookup_face (f
, attr
)
5772 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5777 xassert (cache
!= NULL
);
5778 check_lface_attrs (attr
);
5780 /* Look up ATTR in the face cache. */
5781 hash
= lface_hash (attr
);
5782 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5784 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5786 if (face
->ascii_face
!= face
)
5788 /* There's no more ASCII face. */
5792 if (face
->hash
== hash
5793 && lface_equal_p (face
->lface
, attr
))
5797 /* If not found, realize a new face. */
5799 face
= realize_face (cache
, attr
, -1);
5802 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5803 #endif /* GLYPH_DEBUG */
5808 #ifdef HAVE_WINDOW_SYSTEM
5809 /* Look up a realized face that has the same attributes as BASE_FACE
5810 except for the font in the face cache of frame F. If FONT_ID is
5811 not negative, it is an ID number of an already opened font that is
5812 used by the face. If FONT_ID is negative, the face has no font.
5813 Value is the ID of the face found. If no suitable face is found,
5814 realize a new one. */
5817 lookup_non_ascii_face (f
, font_id
, base_face
)
5820 struct face
*base_face
;
5822 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5827 xassert (cache
!= NULL
);
5828 base_face
= base_face
->ascii_face
;
5829 hash
= lface_hash (base_face
->lface
);
5830 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5832 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5834 if (face
->ascii_face
== face
)
5836 if (face
->ascii_face
== base_face
5837 && face
->font_info_id
== font_id
)
5841 /* If not found, realize a new face. */
5843 face
= realize_non_ascii_face (f
, font_id
, base_face
);
5846 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5847 #endif /* GLYPH_DEBUG */
5851 #endif /* HAVE_WINDOW_SYSTEM */
5853 /* Return the face id of the realized face for named face SYMBOL on
5854 frame F suitable for displaying ASCII characters. Value is -1 if
5855 the face couldn't be determined, which might happen if the default
5856 face isn't realized and cannot be realized. */
5859 lookup_named_face (f
, symbol
, signal_p
)
5864 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5865 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5866 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5868 if (default_face
== NULL
)
5870 if (!realize_basic_faces (f
))
5872 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5875 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
5878 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5879 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5881 return lookup_face (f
, attrs
);
5885 /* Return the ID of the realized ASCII face of Lisp face with ID
5886 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5889 ascii_face_of_lisp_face (f
, lface_id
)
5895 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5897 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5898 face_id
= lookup_named_face (f
, face_name
, 1);
5907 /* Return a face for charset ASCII that is like the face with id
5908 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5909 STEPS < 0 means larger. Value is the id of the face. */
5912 smaller_face (f
, face_id
, steps
)
5916 #ifdef HAVE_WINDOW_SYSTEM
5918 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5919 int pt
, last_pt
, last_height
;
5922 struct face
*new_face
;
5924 /* If not called for an X frame, just return the original face. */
5925 if (FRAME_TERMCAP_P (f
))
5928 /* Try in increments of 1/2 pt. */
5929 delta
= steps
< 0 ? 5 : -5;
5930 steps
= abs (steps
);
5932 face
= FACE_FROM_ID (f
, face_id
);
5933 bcopy (face
->lface
, attrs
, sizeof attrs
);
5934 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5935 new_face_id
= face_id
;
5936 last_height
= FONT_HEIGHT (face
->font
);
5940 /* Give up if we cannot find a font within 10pt. */
5941 && abs (last_pt
- pt
) < 100)
5943 /* Look up a face for a slightly smaller/larger font. */
5945 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5946 new_face_id
= lookup_face (f
, attrs
);
5947 new_face
= FACE_FROM_ID (f
, new_face_id
);
5949 /* If height changes, count that as one step. */
5950 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5951 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5954 last_height
= FONT_HEIGHT (new_face
->font
);
5961 #else /* not HAVE_WINDOW_SYSTEM */
5965 #endif /* not HAVE_WINDOW_SYSTEM */
5969 /* Return a face for charset ASCII that is like the face with id
5970 FACE_ID on frame F, but has height HEIGHT. */
5973 face_with_height (f
, face_id
, height
)
5978 #ifdef HAVE_WINDOW_SYSTEM
5980 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5982 if (FRAME_TERMCAP_P (f
)
5986 face
= FACE_FROM_ID (f
, face_id
);
5987 bcopy (face
->lface
, attrs
, sizeof attrs
);
5988 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5989 face_id
= lookup_face (f
, attrs
);
5990 #endif /* HAVE_WINDOW_SYSTEM */
5996 /* Return the face id of the realized face for named face SYMBOL on
5997 frame F suitable for displaying ASCII characters, and use
5998 attributes of the face FACE_ID for attributes that aren't
5999 completely specified by SYMBOL. This is like lookup_named_face,
6000 except that the default attributes come from FACE_ID, not from the
6001 default face. FACE_ID is assumed to be already realized. */
6004 lookup_derived_face (f
, symbol
, face_id
, signal_p
)
6010 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6011 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6012 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
6017 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
6018 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6019 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
6020 return lookup_face (f
, attrs
);
6023 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
6024 Sface_attributes_as_vector
, 1, 1, 0,
6025 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
6030 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
6032 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
6039 /***********************************************************************
6040 Face capability testing
6041 ***********************************************************************/
6044 /* If the distance (as returned by color_distance) between two colors is
6045 less than this, then they are considered the same, for determining
6046 whether a color is supported or not. The range of values is 0-65535. */
6048 #define TTY_SAME_COLOR_THRESHOLD 10000
6050 #ifdef HAVE_WINDOW_SYSTEM
6052 /* Return non-zero if all the face attributes in ATTRS are supported
6053 on the window-system frame F.
6055 The definition of `supported' is somewhat heuristic, but basically means
6056 that a face containing all the attributes in ATTRS, when merged with the
6057 default face for display, can be represented in a way that's
6059 \(1) different in appearance than the default face, and
6060 \(2) `close in spirit' to what the attributes specify, if not exact. */
6063 x_supports_face_attributes_p (f
, attrs
, def_face
)
6066 struct face
*def_face
;
6068 Lisp_Object
*def_attrs
= def_face
->lface
;
6070 /* Check that other specified attributes are different that the default
6072 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
6073 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
6074 def_attrs
[LFACE_UNDERLINE_INDEX
]))
6075 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
6076 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
6077 def_attrs
[LFACE_INVERSE_INDEX
]))
6078 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
6079 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
6080 def_attrs
[LFACE_FOREGROUND_INDEX
]))
6081 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
6082 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
6083 def_attrs
[LFACE_BACKGROUND_INDEX
]))
6084 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6085 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
6086 def_attrs
[LFACE_STIPPLE_INDEX
]))
6087 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6088 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
6089 def_attrs
[LFACE_OVERLINE_INDEX
]))
6090 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6091 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
6092 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
6093 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6094 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
6095 def_attrs
[LFACE_BOX_INDEX
])))
6098 /* Check font-related attributes, as those are the most commonly
6099 "unsupported" on a window-system (because of missing fonts). */
6100 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6101 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6102 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
6103 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
6104 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6105 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
6109 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
6111 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
6113 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
6115 face_id
= lookup_face (f
, merged_attrs
);
6116 face
= FACE_FROM_ID (f
, face_id
);
6119 error ("Cannot make face");
6121 /* If the font is the same, then not supported. */
6122 if (face
->font
== def_face
->font
)
6126 /* Everything checks out, this face is supported. */
6130 #endif /* HAVE_WINDOW_SYSTEM */
6132 /* Return non-zero if all the face attributes in ATTRS are supported
6135 The definition of `supported' is somewhat heuristic, but basically means
6136 that a face containing all the attributes in ATTRS, when merged
6137 with the default face for display, can be represented in a way that's
6139 \(1) different in appearance than the default face, and
6140 \(2) `close in spirit' to what the attributes specify, if not exact.
6142 Point (2) implies that a `:weight black' attribute will be satisfied
6143 by any terminal that can display bold, and a `:foreground "yellow"' as
6144 long as the terminal can display a yellowish color, but `:slant italic'
6145 will _not_ be satisfied by the tty display code's automatic
6146 substitution of a `dim' face for italic. */
6149 tty_supports_face_attributes_p (f
, attrs
, def_face
)
6152 struct face
*def_face
;
6155 Lisp_Object val
, fg
, bg
;
6156 XColor fg_tty_color
, fg_std_color
;
6157 XColor bg_tty_color
, bg_std_color
;
6158 unsigned test_caps
= 0;
6159 Lisp_Object
*def_attrs
= def_face
->lface
;
6162 /* First check some easy-to-check stuff; ttys support none of the
6163 following attributes, so we can just return false if any are requested
6164 (even if `nominal' values are specified, we should still return false,
6165 as that will be the same value that the default face uses). We
6166 consider :slant unsupportable on ttys, even though the face code
6167 actually `fakes' them using a dim attribute if possible. This is
6168 because the faked result is too different from what the face
6170 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6171 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6172 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6173 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6174 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6175 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6176 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6177 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
6181 /* Test for terminal `capabilities' (non-color character attributes). */
6183 /* font weight (bold/dim) */
6184 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6187 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6189 if (weight
> XLFD_WEIGHT_MEDIUM
)
6191 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6192 return 0; /* same as default */
6193 test_caps
= TTY_CAP_BOLD
;
6195 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6197 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6198 return 0; /* same as default */
6199 test_caps
= TTY_CAP_DIM
;
6201 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6202 return 0; /* same as default */
6206 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6207 if (!UNSPECIFIEDP (val
))
6210 return 0; /* ttys can't use colored underlines */
6211 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6212 return 0; /* same as default */
6214 test_caps
|= TTY_CAP_UNDERLINE
;
6218 val
= attrs
[LFACE_INVERSE_INDEX
];
6219 if (!UNSPECIFIEDP (val
))
6221 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6222 return 0; /* same as default */
6224 test_caps
|= TTY_CAP_INVERSE
;
6228 /* Color testing. */
6230 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6231 we use them when calling `tty_capable_p' below, even if the face
6232 specifies no colors. */
6233 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6234 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6236 /* Check if foreground color is close enough. */
6237 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6240 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6242 if (face_attr_equal_p (fg
, def_fg
))
6243 return 0; /* same as default */
6244 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6245 return 0; /* not a valid color */
6246 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6247 > TTY_SAME_COLOR_THRESHOLD
)
6248 return 0; /* displayed color is too different */
6250 /* Make sure the color is really different than the default. */
6252 XColor def_fg_color
;
6253 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6254 && (color_distance (&fg_tty_color
, &def_fg_color
)
6255 <= TTY_SAME_COLOR_THRESHOLD
))
6260 /* Check if background color is close enough. */
6261 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6264 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6266 if (face_attr_equal_p (bg
, def_bg
))
6267 return 0; /* same as default */
6268 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6269 return 0; /* not a valid color */
6270 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6271 > TTY_SAME_COLOR_THRESHOLD
)
6272 return 0; /* displayed color is too different */
6274 /* Make sure the color is really different than the default. */
6276 XColor def_bg_color
;
6277 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6278 && (color_distance (&bg_tty_color
, &def_bg_color
)
6279 <= TTY_SAME_COLOR_THRESHOLD
))
6284 /* If both foreground and background are requested, see if the
6285 distance between them is OK. We just check to see if the distance
6286 between the tty's foreground and background is close enough to the
6287 distance between the standard foreground and background. */
6288 if (STRINGP (fg
) && STRINGP (bg
))
6291 = (color_distance (&fg_std_color
, &bg_std_color
)
6292 - color_distance (&fg_tty_color
, &bg_tty_color
));
6293 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6294 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6299 /* See if the capabilities we selected above are supported, with the
6301 if (test_caps
!= 0 &&
6302 ! tty_capable_p (f
, test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6306 /* Hmmm, everything checks out, this terminal must support this face. */
6311 DEFUN ("display-supports-face-attributes-p",
6312 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6314 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6315 The optional argument DISPLAY can be a display name, a frame, or
6316 nil (meaning the selected frame's display).
6318 The definition of `supported' is somewhat heuristic, but basically means
6319 that a face containing all the attributes in ATTRIBUTES, when merged
6320 with the default face for display, can be represented in a way that's
6322 \(1) different in appearance than the default face, and
6323 \(2) `close in spirit' to what the attributes specify, if not exact.
6325 Point (2) implies that a `:weight black' attribute will be satisfied by
6326 any display that can display bold, and a `:foreground \"yellow\"' as long
6327 as it can display a yellowish color, but `:slant italic' will _not_ be
6328 satisfied by the tty display code's automatic substitution of a `dim'
6329 face for italic. */)
6330 (attributes
, display
)
6331 Lisp_Object attributes
, display
;
6336 struct face
*def_face
;
6337 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6339 if (noninteractive
|| !initialized
)
6340 /* We may not be able to access low-level face information in batch
6341 mode, or before being dumped, and this function is not going to
6342 be very useful in those cases anyway, so just give up. */
6346 frame
= selected_frame
;
6347 else if (FRAMEP (display
))
6351 /* Find any frame on DISPLAY. */
6352 Lisp_Object fl_tail
;
6355 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6357 frame
= XCAR (fl_tail
);
6358 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6359 XFRAME (frame
)->param_alist
)),
6365 CHECK_LIVE_FRAME (frame
);
6368 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6369 attrs
[i
] = Qunspecified
;
6370 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6372 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6373 if (def_face
== NULL
)
6375 if (! realize_basic_faces (f
))
6376 error ("Cannot realize default face");
6377 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6380 /* Dispatch to the appropriate handler. */
6381 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6382 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6383 #ifdef HAVE_WINDOW_SYSTEM
6385 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6388 return supports
? Qt
: Qnil
;
6392 /***********************************************************************
6394 ***********************************************************************/
6396 DEFUN ("internal-set-font-selection-order",
6397 Finternal_set_font_selection_order
,
6398 Sinternal_set_font_selection_order
, 1, 1, 0,
6399 doc
: /* Set font selection order for face font selection to ORDER.
6400 ORDER must be a list of length 4 containing the symbols `:width',
6401 `:height', `:weight', and `:slant'. Face attributes appearing
6402 first in ORDER are matched first, e.g. if `:height' appears before
6403 `:weight' in ORDER, font selection first tries to find a font with
6404 a suitable height, and then tries to match the font weight.
6411 int indices
[DIM (font_sort_order
)];
6414 bzero (indices
, sizeof indices
);
6418 CONSP (list
) && i
< DIM (indices
);
6419 list
= XCDR (list
), ++i
)
6421 Lisp_Object attr
= XCAR (list
);
6424 if (EQ (attr
, QCwidth
))
6426 else if (EQ (attr
, QCheight
))
6427 xlfd
= XLFD_POINT_SIZE
;
6428 else if (EQ (attr
, QCweight
))
6430 else if (EQ (attr
, QCslant
))
6435 if (indices
[i
] != 0)
6440 if (!NILP (list
) || i
!= DIM (indices
))
6441 signal_error ("Invalid font sort order", order
);
6442 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6443 if (indices
[i
] == 0)
6444 signal_error ("Invalid font sort order", order
);
6446 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6448 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6449 free_all_realized_faces (Qnil
);
6456 DEFUN ("internal-set-alternative-font-family-alist",
6457 Finternal_set_alternative_font_family_alist
,
6458 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6459 doc
: /* Define alternative font families to try in face font selection.
6460 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6461 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6462 be found. Value is ALIST. */)
6467 Vface_alternative_font_family_alist
= alist
;
6468 free_all_realized_faces (Qnil
);
6473 DEFUN ("internal-set-alternative-font-registry-alist",
6474 Finternal_set_alternative_font_registry_alist
,
6475 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6476 doc
: /* Define alternative font registries to try in face font selection.
6477 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6478 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6479 be found. Value is ALIST. */)
6484 Vface_alternative_font_registry_alist
= alist
;
6485 free_all_realized_faces (Qnil
);
6490 #ifdef HAVE_WINDOW_SYSTEM
6492 /* Value is non-zero if FONT is the name of a scalable font. The
6493 X11R6 XLFD spec says that point size, pixel size, and average width
6494 are zero for scalable fonts. Intlfonts contain at least one
6495 scalable font ("*-muleindian-1") for which this isn't true, so we
6496 just test average width. */
6499 font_scalable_p (font
)
6500 struct font_name
*font
;
6502 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6503 return (*s
== '0' && *(s
+ 1) == '\0')
6505 /* Windows implementation of XLFD is slightly broken for backward
6506 compatibility with previous broken versions, so test for
6507 wildcards as well as 0. */
6514 /* Ignore the difference of font point size less than this value. */
6516 #define FONT_POINT_SIZE_QUANTUM 5
6518 /* Value is non-zero if FONT1 is a better match for font attributes
6519 VALUES than FONT2. VALUES is an array of face attribute values in
6520 font sort order. COMPARE_PT_P zero means don't compare point
6521 sizes. AVGWIDTH, if not zero, is a specified font average width
6525 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6527 struct font_name
*font1
, *font2
;
6528 int compare_pt_p
, avgwidth
;
6532 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6534 int xlfd_idx
= font_sort_order
[i
];
6536 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6540 if (xlfd_idx
== XLFD_POINT_SIZE
)
6542 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6543 / font1
->rescale_ratio
));
6544 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6545 / font2
->rescale_ratio
));
6546 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6551 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6552 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6555 if (delta1
> delta2
)
6557 else if (delta1
< delta2
)
6561 /* The difference may be equal because, e.g., the face
6562 specifies `italic' but we have only `regular' and
6563 `oblique'. Prefer `oblique' in this case. */
6564 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6565 && font1
->numeric
[xlfd_idx
] > values
[i
]
6566 && font2
->numeric
[xlfd_idx
] < values
[i
])
6574 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6575 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6576 if (delta1
> delta2
)
6578 else if (delta1
< delta2
)
6584 /* We prefer a real scalable font; i.e. not what autoscaled. */
6585 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6586 && font1
->numeric
[XLFD_RESY
] > 0);
6587 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6588 && font2
->numeric
[XLFD_RESY
] > 0);
6590 if (auto_scaled_1
!= auto_scaled_2
)
6591 return auto_scaled_2
;
6594 return font1
->registry_priority
< font2
->registry_priority
;
6598 /* Value is non-zero if FONT is an exact match for face attributes in
6599 SPECIFIED. SPECIFIED is an array of face attribute values in font
6600 sort order. AVGWIDTH, if non-zero, is an average width to compare
6604 exact_face_match_p (specified
, font
, avgwidth
)
6606 struct font_name
*font
;
6611 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6612 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6615 return (i
== DIM (font_sort_order
)
6617 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6621 /* Value is the name of a scaled font, generated from scalable font
6622 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6623 Value is allocated from heap. */
6626 build_scalable_font_name (f
, font
, specified_pt
)
6628 struct font_name
*font
;
6631 char pixel_size
[20];
6633 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6636 if (font
->numeric
[XLFD_PIXEL_SIZE
] != 0
6637 || font
->numeric
[XLFD_POINT_SIZE
] != 0)
6638 /* This is a scalable font but is requested for a specific size.
6639 We should not change that size. */
6640 return build_font_name (font
);
6642 /* If scalable font is for a specific resolution, compute
6643 the point size we must specify from the resolution of
6644 the display and the specified resolution of the font. */
6645 if (font
->numeric
[XLFD_RESY
] != 0)
6647 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6648 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6653 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6655 /* We may need a font of the different size. */
6656 pixel_value
*= font
->rescale_ratio
;
6658 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6659 font of the specified PIXEL_SIZE. */
6661 { /* Set point size of the font. */
6662 char point_size
[20];
6663 sprintf (point_size
, "%d", (int) pt
);
6664 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6665 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6669 /* Set pixel size. */
6670 sprintf (pixel_size
, "%d", pixel_value
);
6671 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6672 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6674 /* If font doesn't specify its resolution, use the
6675 resolution of the display. */
6676 if (font
->numeric
[XLFD_RESY
] == 0)
6679 sprintf (buffer
, "%d", (int) resy
);
6680 font
->fields
[XLFD_RESY
] = buffer
;
6681 font
->numeric
[XLFD_RESY
] = resy
;
6684 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6687 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6688 sprintf (buffer
, "%d", resx
);
6689 font
->fields
[XLFD_RESX
] = buffer
;
6690 font
->numeric
[XLFD_RESX
] = resx
;
6693 return build_font_name (font
);
6697 /* Value is non-zero if we are allowed to use scalable font FONT. We
6698 can't run a Lisp function here since this function may be called
6699 with input blocked. */
6702 may_use_scalable_font_p (font
)
6705 if (EQ (Vscalable_fonts_allowed
, Qt
))
6707 else if (CONSP (Vscalable_fonts_allowed
))
6709 Lisp_Object tail
, regexp
;
6711 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6713 regexp
= XCAR (tail
);
6714 if (STRINGP (regexp
)
6715 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6725 /* Return the name of the best matching font for face attributes ATTRS
6726 in the array of font_name structures FONTS which contains NFONTS
6727 elements. WIDTH_RATIO is a factor with which to multiply average
6728 widths if ATTRS specifies such a width.
6730 Value is a font name which is allocated from the heap. FONTS is
6731 freed by this function.
6733 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6734 indicate whether the resulting font should be drawn using overstrike
6735 to simulate bold-face. */
6738 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6741 struct font_name
*fonts
;
6744 int *needs_overstrike
;
6747 struct font_name
*best
;
6750 int exact_p
, avgwidth
;
6755 /* Make specified font attributes available in `specified',
6756 indexed by sort order. */
6757 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6759 int xlfd_idx
= font_sort_order
[i
];
6761 if (xlfd_idx
== XLFD_SWIDTH
)
6762 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6763 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6764 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6765 else if (xlfd_idx
== XLFD_WEIGHT
)
6766 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6767 else if (xlfd_idx
== XLFD_SLANT
)
6768 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6773 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6775 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6779 if (needs_overstrike
)
6780 *needs_overstrike
= 0;
6782 /* Start with the first non-scalable font in the list. */
6783 for (i
= 0; i
< nfonts
; ++i
)
6784 if (!font_scalable_p (fonts
+ i
))
6787 /* Find the best match among the non-scalable fonts. */
6792 for (i
= 1; i
< nfonts
; ++i
)
6793 if (!font_scalable_p (fonts
+ i
)
6794 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6798 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6806 /* Unless we found an exact match among non-scalable fonts, see if
6807 we can find a better match among scalable fonts. */
6810 /* A scalable font is better if
6812 1. its weight, slant, swidth attributes are better, or.
6814 2. the best non-scalable font doesn't have the required
6815 point size, and the scalable fonts weight, slant, swidth
6818 int non_scalable_has_exact_height_p
;
6820 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6821 non_scalable_has_exact_height_p
= 1;
6823 non_scalable_has_exact_height_p
= 0;
6825 for (i
= 0; i
< nfonts
; ++i
)
6826 if (font_scalable_p (fonts
+ i
))
6829 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6830 || (!non_scalable_has_exact_height_p
6831 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6833 non_scalable_has_exact_height_p
= 1;
6838 if (needs_overstrike
)
6840 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6841 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6843 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6845 /* We want a bold font, but didn't get one; try to use
6846 overstriking instead to simulate bold-face. However,
6847 don't overstrike an already-bold fontn unless the
6848 desired weight grossly exceeds the available weight. */
6849 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6850 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6852 *needs_overstrike
= 1;
6857 if (font_scalable_p (best
))
6858 font_name
= build_scalable_font_name (f
, best
, pt
);
6860 font_name
= build_font_name (best
);
6862 /* Free font_name structures. */
6863 free_font_names (fonts
, nfonts
);
6869 /* Get a list of matching fonts on frame F, considering FAMILY
6870 and alternative font families from Vface_alternative_font_registry_alist.
6872 FAMILY is the font family whose alternatives are considered.
6874 REGISTRY, if a string, specifies a font registry and encoding to
6875 match. A value of nil means include fonts of any registry and
6878 Return in *FONTS a pointer to a vector of font_name structures for
6879 the fonts matched. Value is the number of fonts found. */
6882 try_alternative_families (f
, family
, registry
, fonts
)
6884 Lisp_Object family
, registry
;
6885 struct font_name
**fonts
;
6890 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6893 /* Try alternative font families. */
6894 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6897 for (alter
= XCDR (alter
);
6898 CONSP (alter
) && nfonts
== 0;
6899 alter
= XCDR (alter
))
6901 if (STRINGP (XCAR (alter
)))
6902 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6906 /* Try all scalable fonts before giving up. */
6907 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6909 int count
= SPECPDL_INDEX ();
6910 specbind (Qscalable_fonts_allowed
, Qt
);
6911 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6912 unbind_to (count
, Qnil
);
6919 /* Get a list of matching fonts on frame F.
6921 PATTERN, if a string, specifies a font name pattern to match while
6922 ignoring FAMILY and REGISTRY.
6924 FAMILY, if a list, specifies a list of font families to try.
6926 REGISTRY, if a list, specifies a list of font registries and
6929 Return in *FONTS a pointer to a vector of font_name structures for
6930 the fonts matched. Value is the number of fonts found. */
6933 try_font_list (f
, pattern
, family
, registry
, fonts
)
6935 Lisp_Object pattern
, family
, registry
;
6936 struct font_name
**fonts
;
6940 if (STRINGP (pattern
))
6942 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
6943 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6945 int count
= SPECPDL_INDEX ();
6946 specbind (Qscalable_fonts_allowed
, Qt
);
6947 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
6948 unbind_to (count
, Qnil
);
6956 nfonts
= font_list (f
, Qnil
, Qnil
, registry
, fonts
);
6958 for (tail
= family
; ! nfonts
&& CONSP (tail
); tail
= XCDR (tail
))
6959 nfonts
= try_alternative_families (f
, XCAR (tail
), registry
, fonts
);
6961 /* Try font family of the default face or "fixed". */
6962 if (nfonts
== 0 && !NILP (family
))
6964 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6966 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6968 family
= build_string ("fixed");
6969 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6972 /* Try any family with the given registry. */
6973 if (nfonts
== 0 && !NILP (family
))
6974 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6981 /* Return the fontset id of the base fontset name or alias name given
6982 by the fontset attribute of ATTRS. Value is -1 if the fontset
6983 attribute of ATTRS doesn't name a fontset. */
6986 face_fontset (attrs
)
6991 name
= attrs
[LFACE_FONTSET_INDEX
];
6992 if (!STRINGP (name
))
6994 return fs_query_fontset (name
, 0);
6998 /* Choose a name of font to use on frame F to display characters with
6999 Lisp face attributes specified by ATTRS. The font name is
7000 determined by the font-related attributes in ATTRS and FONT-SPEC
7003 When we are choosing a font for ASCII characters, FONT-SPEC is
7004 always nil. Otherwise FONT-SPEC is a list
7005 [ FAMILY WEIGHT SLANT SWIDTH ADSTYLE REGISTRY ]
7006 or a string specifying a font name pattern.
7008 If NEEDS_OVERSTRIKE is not NULL, a boolean is returned in it to
7009 indicate whether the resulting font should be drawn using
7010 overstrike to simulate bold-face.
7012 Value is the font name which is allocated from the heap and must be
7013 freed by the caller. */
7016 choose_face_font (f
, attrs
, font_spec
, needs_overstrike
)
7019 Lisp_Object font_spec
;
7020 int *needs_overstrike
;
7022 Lisp_Object pattern
, family
, adstyle
, registry
;
7023 char *font_name
= NULL
;
7024 struct font_name
*fonts
;
7027 if (needs_overstrike
)
7028 *needs_overstrike
= 0;
7030 /* If we are choosing an ASCII font and a font name is explicitly
7031 specified in ATTRS, return it. */
7032 if (NILP (font_spec
) && STRINGP (attrs
[LFACE_FONT_INDEX
]))
7033 return xstrdup (SDATA (attrs
[LFACE_FONT_INDEX
]));
7035 if (NILP (attrs
[LFACE_FAMILY_INDEX
]))
7038 family
= Fcons (attrs
[LFACE_FAMILY_INDEX
], Qnil
);
7040 /* Decide FAMILY, ADSTYLE, and REGISTRY from FONT_SPEC. But,
7041 ADSTYLE is not used in the font selector for the moment. */
7042 if (VECTORP (font_spec
))
7045 if (STRINGP (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
)))
7046 family
= Fcons (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
), family
);
7047 adstyle
= AREF (font_spec
, FONT_SPEC_ADSTYLE_INDEX
);
7048 registry
= Fcons (AREF (font_spec
, FONT_SPEC_REGISTRY_INDEX
), Qnil
);
7050 else if (STRINGP (font_spec
))
7052 pattern
= font_spec
;
7059 /* We are choosing an ASCII font. By default, use the registry
7060 name "iso8859-1". But, if the registry name of the ASCII
7061 font specified in the fontset of ATTRS is not "iso8859-1"
7062 (e.g "iso10646-1"), use also that name with higher
7064 int fontset
= face_fontset (attrs
);
7067 struct font_name font
;
7071 registry
= Fcons (build_string ("iso8859-1"), Qnil
);
7073 ascii
= fontset_ascii (fontset
);
7074 len
= SBYTES (ascii
);
7076 || strcmp (SDATA (ascii
) + len
- 9, "iso8859-1"))
7078 font
.name
= LSTRDUPA (ascii
);
7079 /* Check if the name is in XLFD. */
7080 if (split_font_name (f
, &font
, 0))
7082 font
.fields
[XLFD_ENCODING
][-1] = '-';
7083 registry
= Fcons (build_string (font
.fields
[XLFD_REGISTRY
]),
7089 /* Get a list of fonts matching that pattern and choose the
7090 best match for the specified face attributes from it. */
7091 nfonts
= try_font_list (f
, pattern
, family
, registry
, &fonts
);
7092 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, NILP (font_spec
),
7097 #endif /* HAVE_WINDOW_SYSTEM */
7101 /***********************************************************************
7103 ***********************************************************************/
7105 /* Realize basic faces on frame F. Value is zero if frame parameters
7106 of F don't contain enough information needed to realize the default
7110 realize_basic_faces (f
)
7114 int count
= SPECPDL_INDEX ();
7116 /* Block input here so that we won't be surprised by an X expose
7117 event, for instance, without having the faces set up. */
7119 specbind (Qscalable_fonts_allowed
, Qt
);
7121 if (realize_default_face (f
))
7123 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
7124 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
7125 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
7126 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
7127 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
7128 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
7129 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
7130 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
7131 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
7132 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
7133 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
7135 /* Reflect changes in the `menu' face in menu bars. */
7136 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
7138 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
7139 #ifdef USE_X_TOOLKIT
7140 x_update_menu_appearance (f
);
7147 unbind_to (count
, Qnil
);
7153 /* Realize the default face on frame F. If the face is not fully
7154 specified, make it fully-specified. Attributes of the default face
7155 that are not explicitly specified are taken from frame parameters. */
7158 realize_default_face (f
)
7161 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7163 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7164 Lisp_Object frame_font
;
7167 /* If the `default' face is not yet known, create it. */
7168 lface
= lface_from_face_name (f
, Qdefault
, 0);
7172 XSETFRAME (frame
, f
);
7173 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
7177 #ifdef HAVE_WINDOW_SYSTEM
7178 if (FRAME_WINDOW_P (f
))
7180 /* Set frame_font to the value of the `font' frame parameter. */
7181 frame_font
= Fassq (Qfont
, f
->param_alist
);
7182 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
7183 frame_font
= XCDR (frame_font
);
7184 set_lface_from_font_name (f
, lface
, frame_font
,
7185 f
->default_face_done_p
, 1);
7186 f
->default_face_done_p
= 1;
7188 #endif /* HAVE_WINDOW_SYSTEM */
7190 if (!FRAME_WINDOW_P (f
))
7192 LFACE_FAMILY (lface
) = build_string ("default");
7193 LFACE_SWIDTH (lface
) = Qnormal
;
7194 LFACE_HEIGHT (lface
) = make_number (1);
7195 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
7196 LFACE_WEIGHT (lface
) = Qnormal
;
7197 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
7198 LFACE_SLANT (lface
) = Qnormal
;
7199 LFACE_AVGWIDTH (lface
) = Qunspecified
;
7202 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
7203 LFACE_UNDERLINE (lface
) = Qnil
;
7205 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
7206 LFACE_OVERLINE (lface
) = Qnil
;
7208 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
7209 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
7211 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
7212 LFACE_BOX (lface
) = Qnil
;
7214 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
7215 LFACE_INVERSE (lface
) = Qnil
;
7217 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
7219 /* This function is called so early that colors are not yet
7220 set in the frame parameter list. */
7221 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7223 if (CONSP (color
) && STRINGP (XCDR (color
)))
7224 LFACE_FOREGROUND (lface
) = XCDR (color
);
7225 else if (FRAME_WINDOW_P (f
))
7227 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7228 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7233 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7235 /* This function is called so early that colors are not yet
7236 set in the frame parameter list. */
7237 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7238 if (CONSP (color
) && STRINGP (XCDR (color
)))
7239 LFACE_BACKGROUND (lface
) = XCDR (color
);
7240 else if (FRAME_WINDOW_P (f
))
7242 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7243 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7248 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7249 LFACE_STIPPLE (lface
) = Qnil
;
7251 /* Realize the face; it must be fully-specified now. */
7252 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7253 check_lface (lface
);
7254 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7255 face
= realize_face (c
, attrs
, DEFAULT_FACE_ID
);
7260 /* Realize basic faces other than the default face in face cache C.
7261 SYMBOL is the face name, ID is the face id the realized face must
7262 have. The default face must have been realized already. */
7265 realize_named_face (f
, symbol
, id
)
7270 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7271 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7272 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7273 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7274 struct face
*new_face
;
7276 /* The default face must exist and be fully specified. */
7277 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7278 check_lface_attrs (attrs
);
7279 xassert (lface_fully_specified_p (attrs
));
7281 /* If SYMBOL isn't know as a face, create it. */
7285 XSETFRAME (frame
, f
);
7286 lface
= Finternal_make_lisp_face (symbol
, frame
);
7289 /* Merge SYMBOL's face with the default face. */
7290 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7291 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7293 /* Realize the face. */
7294 new_face
= realize_face (c
, attrs
, id
);
7298 /* Realize the fully-specified face with attributes ATTRS in face
7299 cache CACHE for ASCII characters. If FORMER_FACE_ID is
7300 non-negative, it is an ID of face to remove before caching the new
7301 face. Value is a pointer to the newly created realized face. */
7303 static struct face
*
7304 realize_face (cache
, attrs
, former_face_id
)
7305 struct face_cache
*cache
;
7311 /* LFACE must be fully specified. */
7312 xassert (cache
!= NULL
);
7313 check_lface_attrs (attrs
);
7315 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7317 /* Remove the former face. */
7318 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7319 uncache_face (cache
, former_face
);
7320 free_realized_face (cache
->f
, former_face
);
7323 if (FRAME_WINDOW_P (cache
->f
))
7324 face
= realize_x_face (cache
, attrs
);
7325 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7326 face
= realize_tty_face (cache
, attrs
);
7330 /* Insert the new face. */
7331 cache_face (cache
, face
, lface_hash (attrs
));
7336 #ifdef HAVE_WINDOW_SYSTEM
7337 /* Realize the fully-specified face that has the same attributes as
7338 BASE_FACE except for the font on frame F. If FONT_ID is not
7339 negative, it is an ID number of an already opened font that should
7340 be used by the face. If FONT_ID is negative, the face has no font,
7341 i.e., characters are displayed by empty boxes. */
7343 static struct face
*
7344 realize_non_ascii_face (f
, font_id
, base_face
)
7347 struct face
*base_face
;
7349 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
7351 struct font_info
*font_info
;
7353 face
= (struct face
*) xmalloc (sizeof *face
);
7357 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7358 face
->colors_copied_bitwise_p
= 1;
7360 face
->font_info_id
= font_id
;
7363 font_info
= FONT_INFO_FROM_ID (f
, font_id
);
7364 face
->font
= font_info
->font
;
7365 face
->font_name
= font_info
->full_name
;
7370 face
->font_name
= NULL
;
7375 cache_face (cache
, face
, face
->hash
);
7379 #endif /* HAVE_WINDOW_SYSTEM */
7382 /* Realize the fully-specified face with attributes ATTRS in face
7383 cache CACHE for ASCII characters. Do it for X frame CACHE->f. If
7384 the new face doesn't share font with the default face, a fontname
7385 is allocated from the heap and set in `font_name' of the new face,
7386 but it is not yet loaded here. Value is a pointer to the newly
7387 created realized face. */
7389 static struct face
*
7390 realize_x_face (cache
, attrs
)
7391 struct face_cache
*cache
;
7394 struct face
*face
= NULL
;
7395 #ifdef HAVE_WINDOW_SYSTEM
7396 struct face
*default_face
;
7398 Lisp_Object stipple
, overline
, strike_through
, box
;
7400 xassert (FRAME_WINDOW_P (cache
->f
));
7402 /* Allocate a new realized face. */
7403 face
= make_realized_face (attrs
);
7404 face
->ascii_face
= face
;
7408 /* Determine the font to use. Most of the time, the font will be
7409 the same as the font of the default face, so try that first. */
7410 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7412 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7414 face
->font
= default_face
->font
;
7415 face
->font_info_id
= default_face
->font_info_id
;
7416 face
->font_name
= default_face
->font_name
;
7418 = make_fontset_for_ascii_face (f
, default_face
->fontset
, face
);
7422 /* If the face attribute ATTRS specifies a fontset, use it as
7423 the base of a new realized fontset. Otherwise, use the same
7424 base fontset as of the default face. The base determines
7425 registry and encoding of a font. It may also determine
7426 foundry and family. The other fields of font name pattern
7427 are constructed from ATTRS. */
7428 int fontset
= face_fontset (attrs
);
7430 /* If we are realizing the default face, ATTRS should specify a
7431 fontset. In other words, if FONTSET is -1, we are not
7432 realizing the default face, thus the default face should have
7433 already been realized. */
7435 fontset
= default_face
->fontset
;
7438 load_face_font (f
, face
);
7439 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
, face
);
7442 /* Load colors, and set remaining attributes. */
7444 load_face_colors (f
, face
, attrs
);
7447 box
= attrs
[LFACE_BOX_INDEX
];
7450 /* A simple box of line width 1 drawn in color given by
7452 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7454 face
->box
= FACE_SIMPLE_BOX
;
7455 face
->box_line_width
= 1;
7457 else if (INTEGERP (box
))
7459 /* Simple box of specified line width in foreground color of the
7461 xassert (XINT (box
) != 0);
7462 face
->box
= FACE_SIMPLE_BOX
;
7463 face
->box_line_width
= XINT (box
);
7464 face
->box_color
= face
->foreground
;
7465 face
->box_color_defaulted_p
= 1;
7467 else if (CONSP (box
))
7469 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7470 being one of `raised' or `sunken'. */
7471 face
->box
= FACE_SIMPLE_BOX
;
7472 face
->box_color
= face
->foreground
;
7473 face
->box_color_defaulted_p
= 1;
7474 face
->box_line_width
= 1;
7478 Lisp_Object keyword
, value
;
7480 keyword
= XCAR (box
);
7488 if (EQ (keyword
, QCline_width
))
7490 if (INTEGERP (value
) && XINT (value
) != 0)
7491 face
->box_line_width
= XINT (value
);
7493 else if (EQ (keyword
, QCcolor
))
7495 if (STRINGP (value
))
7497 face
->box_color
= load_color (f
, face
, value
,
7499 face
->use_box_color_for_shadows_p
= 1;
7502 else if (EQ (keyword
, QCstyle
))
7504 if (EQ (value
, Qreleased_button
))
7505 face
->box
= FACE_RAISED_BOX
;
7506 else if (EQ (value
, Qpressed_button
))
7507 face
->box
= FACE_SUNKEN_BOX
;
7512 /* Text underline, overline, strike-through. */
7514 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7516 /* Use default color (same as foreground color). */
7517 face
->underline_p
= 1;
7518 face
->underline_defaulted_p
= 1;
7519 face
->underline_color
= 0;
7521 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7523 /* Use specified color. */
7524 face
->underline_p
= 1;
7525 face
->underline_defaulted_p
= 0;
7526 face
->underline_color
7527 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7528 LFACE_UNDERLINE_INDEX
);
7530 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7532 face
->underline_p
= 0;
7533 face
->underline_defaulted_p
= 0;
7534 face
->underline_color
= 0;
7537 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7538 if (STRINGP (overline
))
7540 face
->overline_color
7541 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7542 LFACE_OVERLINE_INDEX
);
7543 face
->overline_p
= 1;
7545 else if (EQ (overline
, Qt
))
7547 face
->overline_color
= face
->foreground
;
7548 face
->overline_color_defaulted_p
= 1;
7549 face
->overline_p
= 1;
7552 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7553 if (STRINGP (strike_through
))
7555 face
->strike_through_color
7556 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7557 LFACE_STRIKE_THROUGH_INDEX
);
7558 face
->strike_through_p
= 1;
7560 else if (EQ (strike_through
, Qt
))
7562 face
->strike_through_color
= face
->foreground
;
7563 face
->strike_through_color_defaulted_p
= 1;
7564 face
->strike_through_p
= 1;
7567 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7568 if (!NILP (stipple
))
7569 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7570 #endif /* HAVE_WINDOW_SYSTEM */
7576 /* Map a specified color of face FACE on frame F to a tty color index.
7577 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7578 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7579 default foreground/background colors. */
7582 map_tty_color (f
, face
, idx
, defaulted
)
7585 enum lface_attribute_index idx
;
7588 Lisp_Object frame
, color
, def
;
7589 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7590 unsigned long default_pixel
, default_other_pixel
, pixel
;
7592 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7596 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7597 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7601 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7602 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7605 XSETFRAME (frame
, f
);
7606 color
= face
->lface
[idx
];
7610 && CONSP (Vtty_defined_color_alist
)
7611 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7614 /* Associations in tty-defined-color-alist are of the form
7615 (NAME INDEX R G B). We need the INDEX part. */
7616 pixel
= XINT (XCAR (XCDR (def
)));
7619 if (pixel
== default_pixel
&& STRINGP (color
))
7621 pixel
= load_color (f
, face
, color
, idx
);
7623 #if defined (MSDOS) || defined (WINDOWSNT)
7624 /* If the foreground of the default face is the default color,
7625 use the foreground color defined by the frame. */
7627 if (FRAME_MSDOS_P (f
))
7630 if (pixel
== default_pixel
7631 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7634 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7636 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7637 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7640 else if (pixel
== default_other_pixel
)
7643 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7645 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7646 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7652 #endif /* MSDOS or WINDOWSNT */
7656 face
->foreground
= pixel
;
7658 face
->background
= pixel
;
7662 /* Realize the fully-specified face with attributes ATTRS in face
7663 cache CACHE for ASCII characters. Do it for TTY frame CACHE->f.
7664 Value is a pointer to the newly created realized face. */
7666 static struct face
*
7667 realize_tty_face (cache
, attrs
)
7668 struct face_cache
*cache
;
7673 int face_colors_defaulted
= 0;
7674 struct frame
*f
= cache
->f
;
7676 /* Frame must be a termcap frame. */
7677 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7679 /* Allocate a new realized face. */
7680 face
= make_realized_face (attrs
);
7681 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7683 /* Map face attributes to TTY appearances. We map slant to
7684 dimmed text because we want italic text to appear differently
7685 and because dimmed text is probably used infrequently. */
7686 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7687 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7689 if (weight
> XLFD_WEIGHT_MEDIUM
)
7690 face
->tty_bold_p
= 1;
7691 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7692 face
->tty_dim_p
= 1;
7693 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7694 face
->tty_underline_p
= 1;
7695 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7696 face
->tty_reverse_p
= 1;
7698 /* Map color names to color indices. */
7699 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7700 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7702 /* Swap colors if face is inverse-video. If the colors are taken
7703 from the frame colors, they are already inverted, since the
7704 frame-creation function calls x-handle-reverse-video. */
7705 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7707 unsigned long tem
= face
->foreground
;
7708 face
->foreground
= face
->background
;
7709 face
->background
= tem
;
7712 if (tty_suppress_bold_inverse_default_colors_p
7714 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7715 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7716 face
->tty_bold_p
= 0;
7722 DEFUN ("tty-suppress-bold-inverse-default-colors",
7723 Ftty_suppress_bold_inverse_default_colors
,
7724 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7725 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7726 SUPPRESS non-nil means suppress it.
7727 This affects bold faces on TTYs whose foreground is the default background
7728 color of the display and whose background is the default foreground color.
7729 For such faces, the bold face attribute is ignored if this variable
7732 Lisp_Object suppress
;
7734 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7735 ++face_change_count
;
7741 /***********************************************************************
7743 ***********************************************************************/
7745 /* Return the ID of the face to use to display character CH with face
7746 property PROP on frame F in current_buffer. */
7749 compute_char_face (f
, ch
, prop
)
7756 if (NILP (current_buffer
->enable_multibyte_characters
))
7761 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7762 face_id
= FACE_FOR_CHAR (f
, face
, ch
, -1, Qnil
);
7766 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7767 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7768 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7769 merge_face_ref (f
, prop
, attrs
, 1, 0);
7770 face_id
= lookup_face (f
, attrs
);
7776 /* Return the face ID associated with buffer position POS for
7777 displaying ASCII characters. Return in *ENDPTR the position at
7778 which a different face is needed, as far as text properties and
7779 overlays are concerned. W is a window displaying current_buffer.
7781 REGION_BEG, REGION_END delimit the region, so it can be
7784 LIMIT is a position not to scan beyond. That is to limit the time
7785 this function can take.
7787 If MOUSE is non-zero, use the character's mouse-face, not its face.
7789 The face returned is suitable for displaying ASCII characters. */
7792 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7793 endptr
, limit
, mouse
)
7796 int region_beg
, region_end
;
7801 struct frame
*f
= XFRAME (w
->frame
);
7802 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7803 Lisp_Object prop
, position
;
7805 Lisp_Object
*overlay_vec
;
7808 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7809 Lisp_Object limit1
, end
;
7810 struct face
*default_face
;
7812 /* W must display the current buffer. We could write this function
7813 to use the frame and buffer of W, but right now it doesn't. */
7814 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7816 XSETFRAME (frame
, f
);
7817 XSETFASTINT (position
, pos
);
7820 if (pos
< region_beg
&& region_beg
< endpos
)
7821 endpos
= region_beg
;
7823 /* Get the `face' or `mouse_face' text property at POS, and
7824 determine the next position at which the property changes. */
7825 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7826 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7827 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7829 endpos
= XINT (end
);
7831 /* Look at properties from overlays. */
7835 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7836 if (next_overlay
< endpos
)
7837 endpos
= next_overlay
;
7842 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7844 /* Optimize common cases where we can use the default face. */
7847 && !(pos
>= region_beg
&& pos
< region_end
))
7848 return DEFAULT_FACE_ID
;
7850 /* Begin with attributes from the default face. */
7851 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7853 /* Merge in attributes specified via text properties. */
7855 merge_face_ref (f
, prop
, attrs
, 1, 0);
7857 /* Now merge the overlay data. */
7858 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7859 for (i
= 0; i
< noverlays
; i
++)
7864 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7866 merge_face_ref (f
, prop
, attrs
, 1, 0);
7868 oend
= OVERLAY_END (overlay_vec
[i
]);
7869 oendpos
= OVERLAY_POSITION (oend
);
7870 if (oendpos
< endpos
)
7874 /* If in the region, merge in the region face. */
7875 if (pos
>= region_beg
&& pos
< region_end
)
7877 merge_named_face (f
, Qregion
, attrs
, 0);
7879 if (region_end
< endpos
)
7880 endpos
= region_end
;
7885 /* Look up a realized face with the given face attributes,
7886 or realize a new one for ASCII characters. */
7887 return lookup_face (f
, attrs
);
7891 /* Compute the face at character position POS in Lisp string STRING on
7892 window W, for ASCII characters.
7894 If STRING is an overlay string, it comes from position BUFPOS in
7895 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7896 not an overlay string. W must display the current buffer.
7897 REGION_BEG and REGION_END give the start and end positions of the
7898 region; both are -1 if no region is visible.
7900 BASE_FACE_ID is the id of a face to merge with. For strings coming
7901 from overlays or the `display' property it is the face at BUFPOS.
7903 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7905 Set *ENDPTR to the next position where to check for faces in
7906 STRING; -1 if the face is constant from POS to the end of the
7909 Value is the id of the face to use. The face returned is suitable
7910 for displaying ASCII characters. */
7913 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7914 region_end
, endptr
, base_face_id
, mouse_p
)
7918 int region_beg
, region_end
;
7920 enum face_id base_face_id
;
7923 Lisp_Object prop
, position
, end
, limit
;
7924 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7925 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7926 struct face
*base_face
;
7927 int multibyte_p
= STRING_MULTIBYTE (string
);
7928 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7930 /* Get the value of the face property at the current position within
7931 STRING. Value is nil if there is no face property. */
7932 XSETFASTINT (position
, pos
);
7933 prop
= Fget_text_property (position
, prop_name
, string
);
7935 /* Get the next position at which to check for faces. Value of end
7936 is nil if face is constant all the way to the end of the string.
7937 Otherwise it is a string position where to check faces next.
7938 Limit is the maximum position up to which to check for property
7939 changes in Fnext_single_property_change. Strings are usually
7940 short, so set the limit to the end of the string. */
7941 XSETFASTINT (limit
, SCHARS (string
));
7942 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7944 *endptr
= XFASTINT (end
);
7948 base_face
= FACE_FROM_ID (f
, base_face_id
);
7949 xassert (base_face
);
7951 /* Optimize the default case that there is no face property and we
7952 are not in the region. */
7954 && (base_face_id
!= DEFAULT_FACE_ID
7955 /* BUFPOS <= 0 means STRING is not an overlay string, so
7956 that the region doesn't have to be taken into account. */
7958 || bufpos
< region_beg
7959 || bufpos
>= region_end
)
7961 /* We can't realize faces for different charsets differently
7962 if we don't have fonts, so we can stop here if not working
7963 on a window-system frame. */
7964 || !FRAME_WINDOW_P (f
)
7965 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7966 return base_face
->id
;
7968 /* Begin with attributes from the base face. */
7969 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7971 /* Merge in attributes specified via text properties. */
7973 merge_face_ref (f
, prop
, attrs
, 1, 0);
7975 /* If in the region, merge in the region face. */
7977 && bufpos
>= region_beg
7978 && bufpos
< region_end
)
7979 merge_named_face (f
, Qregion
, attrs
, 0);
7981 /* Look up a realized face with the given face attributes,
7982 or realize a new one for ASCII characters. */
7983 return lookup_face (f
, attrs
);
7987 /* Merge a face into a realized face.
7989 F is frame where faces are (to be) realized.
7991 FACE_NAME is named face to merge.
7993 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
7995 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
7997 BASE_FACE_ID is realized face to merge into.
8003 merge_faces (f
, face_name
, face_id
, base_face_id
)
8005 Lisp_Object face_name
;
8006 int face_id
, base_face_id
;
8008 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8009 struct face
*base_face
;
8011 base_face
= FACE_FROM_ID (f
, base_face_id
);
8013 return base_face_id
;
8015 if (EQ (face_name
, Qt
))
8017 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
8018 return base_face_id
;
8019 face_name
= lface_id_to_name
[face_id
];
8020 face_id
= lookup_derived_face (f
, face_name
, base_face_id
, 1);
8023 return base_face_id
;
8026 /* Begin with attributes from the base face. */
8027 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
8029 if (!NILP (face_name
))
8031 if (!merge_named_face (f
, face_name
, attrs
, 0))
8032 return base_face_id
;
8038 return base_face_id
;
8039 face
= FACE_FROM_ID (f
, face_id
);
8041 return base_face_id
;
8042 merge_face_vectors (f
, face
->lface
, attrs
, 0);
8045 /* Look up a realized face with the given face attributes,
8046 or realize a new one for ASCII characters. */
8047 return lookup_face (f
, attrs
);
8051 /***********************************************************************
8053 ***********************************************************************/
8057 /* Print the contents of the realized face FACE to stderr. */
8060 dump_realized_face (face
)
8063 fprintf (stderr
, "ID: %d\n", face
->id
);
8064 #ifdef HAVE_X_WINDOWS
8065 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
8067 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
8069 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
8070 fprintf (stderr
, "background: 0x%lx (%s)\n",
8072 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
8073 fprintf (stderr
, "font_name: %s (%s)\n",
8075 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
8076 #ifdef HAVE_X_WINDOWS
8077 fprintf (stderr
, "font = %p\n", face
->font
);
8079 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
8080 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
8081 fprintf (stderr
, "underline: %d (%s)\n",
8083 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
8084 fprintf (stderr
, "hash: %d\n", face
->hash
);
8088 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
8096 fprintf (stderr
, "font selection order: ");
8097 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
8098 fprintf (stderr
, "%d ", font_sort_order
[i
]);
8099 fprintf (stderr
, "\n");
8101 fprintf (stderr
, "alternative fonts: ");
8102 debug_print (Vface_alternative_font_family_alist
);
8103 fprintf (stderr
, "\n");
8105 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
8106 Fdump_face (make_number (i
));
8112 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
8114 error ("Not a valid face");
8115 dump_realized_face (face
);
8122 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
8123 0, 0, 0, doc
: /* */)
8126 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
8127 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
8128 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
8132 #endif /* GLYPH_DEBUG != 0 */
8136 /***********************************************************************
8138 ***********************************************************************/
8143 Qface
= intern ("face");
8145 Qface_no_inherit
= intern ("face-no-inherit");
8146 staticpro (&Qface_no_inherit
);
8147 Qbitmap_spec_p
= intern ("bitmap-spec-p");
8148 staticpro (&Qbitmap_spec_p
);
8149 Qframe_set_background_mode
= intern ("frame-set-background-mode");
8150 staticpro (&Qframe_set_background_mode
);
8152 /* Lisp face attribute keywords. */
8153 QCfamily
= intern (":family");
8154 staticpro (&QCfamily
);
8155 QCheight
= intern (":height");
8156 staticpro (&QCheight
);
8157 QCweight
= intern (":weight");
8158 staticpro (&QCweight
);
8159 QCslant
= intern (":slant");
8160 staticpro (&QCslant
);
8161 QCunderline
= intern (":underline");
8162 staticpro (&QCunderline
);
8163 QCinverse_video
= intern (":inverse-video");
8164 staticpro (&QCinverse_video
);
8165 QCreverse_video
= intern (":reverse-video");
8166 staticpro (&QCreverse_video
);
8167 QCforeground
= intern (":foreground");
8168 staticpro (&QCforeground
);
8169 QCbackground
= intern (":background");
8170 staticpro (&QCbackground
);
8171 QCstipple
= intern (":stipple");;
8172 staticpro (&QCstipple
);
8173 QCwidth
= intern (":width");
8174 staticpro (&QCwidth
);
8175 QCfont
= intern (":font");
8176 staticpro (&QCfont
);
8177 QCfontset
= intern (":fontset");
8178 staticpro (&QCfontset
);
8179 QCbold
= intern (":bold");
8180 staticpro (&QCbold
);
8181 QCitalic
= intern (":italic");
8182 staticpro (&QCitalic
);
8183 QCoverline
= intern (":overline");
8184 staticpro (&QCoverline
);
8185 QCstrike_through
= intern (":strike-through");
8186 staticpro (&QCstrike_through
);
8187 QCbox
= intern (":box");
8189 QCinherit
= intern (":inherit");
8190 staticpro (&QCinherit
);
8192 /* Symbols used for Lisp face attribute values. */
8193 QCcolor
= intern (":color");
8194 staticpro (&QCcolor
);
8195 QCline_width
= intern (":line-width");
8196 staticpro (&QCline_width
);
8197 QCstyle
= intern (":style");
8198 staticpro (&QCstyle
);
8199 Qreleased_button
= intern ("released-button");
8200 staticpro (&Qreleased_button
);
8201 Qpressed_button
= intern ("pressed-button");
8202 staticpro (&Qpressed_button
);
8203 Qnormal
= intern ("normal");
8204 staticpro (&Qnormal
);
8205 Qultra_light
= intern ("ultra-light");
8206 staticpro (&Qultra_light
);
8207 Qextra_light
= intern ("extra-light");
8208 staticpro (&Qextra_light
);
8209 Qlight
= intern ("light");
8210 staticpro (&Qlight
);
8211 Qsemi_light
= intern ("semi-light");
8212 staticpro (&Qsemi_light
);
8213 Qsemi_bold
= intern ("semi-bold");
8214 staticpro (&Qsemi_bold
);
8215 Qbold
= intern ("bold");
8217 Qextra_bold
= intern ("extra-bold");
8218 staticpro (&Qextra_bold
);
8219 Qultra_bold
= intern ("ultra-bold");
8220 staticpro (&Qultra_bold
);
8221 Qoblique
= intern ("oblique");
8222 staticpro (&Qoblique
);
8223 Qitalic
= intern ("italic");
8224 staticpro (&Qitalic
);
8225 Qreverse_oblique
= intern ("reverse-oblique");
8226 staticpro (&Qreverse_oblique
);
8227 Qreverse_italic
= intern ("reverse-italic");
8228 staticpro (&Qreverse_italic
);
8229 Qultra_condensed
= intern ("ultra-condensed");
8230 staticpro (&Qultra_condensed
);
8231 Qextra_condensed
= intern ("extra-condensed");
8232 staticpro (&Qextra_condensed
);
8233 Qcondensed
= intern ("condensed");
8234 staticpro (&Qcondensed
);
8235 Qsemi_condensed
= intern ("semi-condensed");
8236 staticpro (&Qsemi_condensed
);
8237 Qsemi_expanded
= intern ("semi-expanded");
8238 staticpro (&Qsemi_expanded
);
8239 Qexpanded
= intern ("expanded");
8240 staticpro (&Qexpanded
);
8241 Qextra_expanded
= intern ("extra-expanded");
8242 staticpro (&Qextra_expanded
);
8243 Qultra_expanded
= intern ("ultra-expanded");
8244 staticpro (&Qultra_expanded
);
8245 Qbackground_color
= intern ("background-color");
8246 staticpro (&Qbackground_color
);
8247 Qforeground_color
= intern ("foreground-color");
8248 staticpro (&Qforeground_color
);
8249 Qunspecified
= intern ("unspecified");
8250 staticpro (&Qunspecified
);
8251 Qignore_defface
= intern (":ignore-defface");
8252 staticpro (&Qignore_defface
);
8254 Qface_alias
= intern ("face-alias");
8255 staticpro (&Qface_alias
);
8256 Qdefault
= intern ("default");
8257 staticpro (&Qdefault
);
8258 Qtool_bar
= intern ("tool-bar");
8259 staticpro (&Qtool_bar
);
8260 Qregion
= intern ("region");
8261 staticpro (&Qregion
);
8262 Qfringe
= intern ("fringe");
8263 staticpro (&Qfringe
);
8264 Qheader_line
= intern ("header-line");
8265 staticpro (&Qheader_line
);
8266 Qscroll_bar
= intern ("scroll-bar");
8267 staticpro (&Qscroll_bar
);
8268 Qmenu
= intern ("menu");
8270 Qcursor
= intern ("cursor");
8271 staticpro (&Qcursor
);
8272 Qborder
= intern ("border");
8273 staticpro (&Qborder
);
8274 Qmouse
= intern ("mouse");
8275 staticpro (&Qmouse
);
8276 Qmode_line_inactive
= intern ("mode-line-inactive");
8277 staticpro (&Qmode_line_inactive
);
8278 Qvertical_border
= intern ("vertical-border");
8279 staticpro (&Qvertical_border
);
8280 Qtty_color_desc
= intern ("tty-color-desc");
8281 staticpro (&Qtty_color_desc
);
8282 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8283 staticpro (&Qtty_color_standard_values
);
8284 Qtty_color_by_index
= intern ("tty-color-by-index");
8285 staticpro (&Qtty_color_by_index
);
8286 Qtty_color_alist
= intern ("tty-color-alist");
8287 staticpro (&Qtty_color_alist
);
8288 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8289 staticpro (&Qscalable_fonts_allowed
);
8291 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8292 staticpro (&Vparam_value_alist
);
8293 Vface_alternative_font_family_alist
= Qnil
;
8294 staticpro (&Vface_alternative_font_family_alist
);
8295 Vface_alternative_font_registry_alist
= Qnil
;
8296 staticpro (&Vface_alternative_font_registry_alist
);
8298 defsubr (&Sinternal_make_lisp_face
);
8299 defsubr (&Sinternal_lisp_face_p
);
8300 defsubr (&Sinternal_set_lisp_face_attribute
);
8301 #ifdef HAVE_WINDOW_SYSTEM
8302 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8304 defsubr (&Scolor_gray_p
);
8305 defsubr (&Scolor_supported_p
);
8306 defsubr (&Sface_attribute_relative_p
);
8307 defsubr (&Smerge_face_attribute
);
8308 defsubr (&Sinternal_get_lisp_face_attribute
);
8309 defsubr (&Sinternal_lisp_face_attribute_values
);
8310 defsubr (&Sinternal_lisp_face_equal_p
);
8311 defsubr (&Sinternal_lisp_face_empty_p
);
8312 defsubr (&Sinternal_copy_lisp_face
);
8313 defsubr (&Sinternal_merge_in_global_face
);
8314 defsubr (&Sface_font
);
8315 defsubr (&Sframe_face_alist
);
8316 defsubr (&Sdisplay_supports_face_attributes_p
);
8317 defsubr (&Scolor_distance
);
8318 defsubr (&Sinternal_set_font_selection_order
);
8319 defsubr (&Sinternal_set_alternative_font_family_alist
);
8320 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8321 defsubr (&Sface_attributes_as_vector
);
8323 defsubr (&Sdump_face
);
8324 defsubr (&Sshow_face_resources
);
8325 #endif /* GLYPH_DEBUG */
8326 defsubr (&Sclear_face_cache
);
8327 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8329 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8330 defsubr (&Sdump_colors
);
8333 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8334 doc
: /* *Limit for font matching.
8335 If an integer > 0, font matching functions won't load more than
8336 that number of fonts when searching for a matching font. */);
8337 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8339 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8340 doc
: /* List of global face definitions (for internal use only.) */);
8341 Vface_new_frame_defaults
= Qnil
;
8343 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8344 doc
: /* *Default stipple pattern used on monochrome displays.
8345 This stipple pattern is used on monochrome displays
8346 instead of shades of gray for a face background color.
8347 See `set-face-stipple' for possible values for this variable. */);
8348 Vface_default_stipple
= build_string ("gray3");
8350 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8351 doc
: /* An alist of defined terminal colors and their RGB values. */);
8352 Vtty_defined_color_alist
= Qnil
;
8354 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8355 doc
: /* Allowed scalable fonts.
8356 A value of nil means don't allow any scalable fonts.
8357 A value of t means allow any scalable font.
8358 Otherwise, value must be a list of regular expressions. A font may be
8359 scaled if its name matches a regular expression in the list.
8360 Note that if value is nil, a scalable font might still be used, if no
8361 other font of the appropriate family and registry is available. */);
8362 Vscalable_fonts_allowed
= Qnil
;
8364 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8365 doc
: /* List of ignored fonts.
8366 Each element is a regular expression that matches names of fonts to
8368 Vface_ignored_fonts
= Qnil
;
8370 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8371 doc
: /* Alist of fonts vs the rescaling factors.
8372 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8373 FONT-NAME-PATTERN is a regular expression matching a font name, and
8374 RESCALE-RATIO is a floating point number to specify how much larger
8375 \(or smaller) font we should use. For instance, if a face requests
8376 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8377 Vface_font_rescale_alist
= Qnil
;
8379 #ifdef HAVE_WINDOW_SYSTEM
8380 defsubr (&Sbitmap_spec_p
);
8381 defsubr (&Sx_list_fonts
);
8382 defsubr (&Sinternal_face_x_get_resource
);
8383 defsubr (&Sx_family_fonts
);
8384 defsubr (&Sx_font_family_list
);
8385 #endif /* HAVE_WINDOW_SYSTEM */
8388 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8389 (do not change this comment) */