1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005, 2006 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 or fontset pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
75 Faces are frame-local by nature because Emacs allows to define the
76 same named face (face names are symbols) differently for different
77 frames. Each frame has an alist of face definitions for all named
78 faces. The value of a named face in such an alist is a Lisp vector
79 with the symbol `face' in slot 0, and a slot for each of the face
80 attributes mentioned above.
82 There is also a global face alist `Vface_new_frame_defaults'. Face
83 definitions from this list are used to initialize faces of newly
86 A face doesn't have to specify all attributes. Those not specified
87 have a value of `unspecified'. Faces specifying all attributes but
88 the 14th are called `fully-specified'.
93 The display style of a given character in the text is determined by
94 combining several faces. This process is called `face merging'.
95 Any aspect of the display style that isn't specified by overlays or
96 text properties is taken from the `default' face. Since it is made
97 sure that the default face is always fully-specified, face merging
98 always results in a fully-specified face.
103 After all face attributes for a character have been determined by
104 merging faces of that character, that face is `realized'. The
105 realization process maps face attributes to what is physically
106 available on the system where Emacs runs. The result is a
107 `realized face' in form of a struct face which is stored in the
108 face cache of the frame on which it was realized.
110 Face realization is done in the context of the character to display
111 because different fonts may be used for different characters. In
112 other words, for characters that have different font
113 specifications, different realized faces are needed to display
116 Font specification is done by fontsets. See the comment in
117 fontset.c for the details. In the current implementation, all ASCII
118 characters share the same font in a fontset.
120 Faces are at first realized for ASCII characters, and, at that
121 time, assigned a specific realized fontset. Hereafter, we call
122 such a face as `ASCII face'. When a face for a multibyte character
123 is realized, it inherits (thus shares) a fontset of an ASCII face
124 that has the same attributes other than font-related ones.
126 Thus, all realized face have a realized fontset.
131 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
132 font as ASCII characters. That is because it is expected that
133 unibyte text users specify a font that is suitable both for ASCII
134 and raw 8-bit characters.
139 Font selection tries to find the best available matching font for a
140 given (character, face) combination.
142 If the face specifies a fontset name, that fontset determines a
143 pattern for fonts of the given character. If the face specifies a
144 font name or the other font-related attributes, a fontset is
145 realized from the default fontset. In that case, that
146 specification determines a pattern for ASCII characters and the
147 default fontset determines a pattern for multibyte characters.
149 Available fonts on the system on which Emacs runs are then matched
150 against the font pattern. The result of font selection is the best
151 match for the given face attributes in this font list.
153 Font selection can be influenced by the user.
155 1. The user can specify the relative importance he gives the face
156 attributes width, height, weight, and slant by setting
157 face-font-selection-order (faces.el) to a list of face attribute
158 names. The default is '(:width :height :weight :slant), and means
159 that font selection first tries to find a good match for the font
160 width specified by a face, then---within fonts with that
161 width---tries to find a best match for the specified font height,
164 2. Setting face-font-family-alternatives allows the user to
165 specify alternative font families to try if a family specified by a
168 3. Setting face-font-registry-alternatives allows the user to
169 specify all alternative font registries to try for a face
170 specifying a registry.
172 4. Setting face-ignored-fonts allows the user to ignore specific
176 Character composition.
178 Usually, the realization process is already finished when Emacs
179 actually reflects the desired glyph matrix on the screen. However,
180 on displaying a composition (sequence of characters to be composed
181 on the screen), a suitable font for the components of the
182 composition is selected and realized while drawing them on the
183 screen, i.e. the realization process is delayed but in principle
187 Initialization of basic faces.
189 The faces `default', `modeline' are considered `basic faces'.
190 When redisplay happens the first time for a newly created frame,
191 basic faces are realized for CHARSET_ASCII. Frame parameters are
192 used to fill in unspecified attributes of the default face. */
196 #include <sys/types.h>
197 #include <sys/stat.h>
201 #include "keyboard.h"
204 #ifdef HAVE_WINDOW_SYSTEM
206 #endif /* HAVE_WINDOW_SYSTEM */
208 #ifdef HAVE_X_WINDOWS
212 #include <Xm/XmStrDefs.h>
213 #endif /* USE_MOTIF */
214 #endif /* HAVE_X_WINDOWS */
223 /* Redefine X specifics to W32 equivalents to avoid cluttering the
224 code with #ifdef blocks. */
225 #undef FRAME_X_DISPLAY_INFO
226 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
227 #define x_display_info w32_display_info
228 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
229 #define check_x check_w32
230 #define x_list_fonts w32_list_fonts
231 #define GCGraphicsExposures 0
232 #endif /* WINDOWSNT */
236 #define x_display_info mac_display_info
237 #define check_x check_mac
241 #include "dispextern.h"
242 #include "blockinput.h"
244 #include "intervals.h"
246 #ifdef HAVE_X_WINDOWS
248 /* Compensate for a bug in Xos.h on some systems, on which it requires
249 time.h. On some such systems, Xos.h tries to redefine struct
250 timeval and struct timezone if USG is #defined while it is
253 #ifdef XOS_NEEDS_TIME_H
259 #else /* not XOS_NEEDS_TIME_H */
261 #endif /* not XOS_NEEDS_TIME_H */
263 #endif /* HAVE_X_WINDOWS */
267 #define abs(X) ((X) < 0 ? -(X) : (X))
269 /* Number of pt per inch (from the TeXbook). */
271 #define PT_PER_INCH 72.27
273 /* Non-zero if face attribute ATTR is unspecified. */
275 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
277 /* Non-zero if face attribute ATTR is `ignore-defface'. */
279 #define IGNORE_DEFFACE_P(ATTR) EQ ((ATTR), Qignore_defface)
281 /* Value is the number of elements of VECTOR. */
283 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
285 /* Make a copy of string S on the stack using alloca. Value is a pointer
288 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
290 /* Make a copy of the contents of Lisp string S on the stack using
291 alloca. Value is a pointer to the copy. */
293 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
295 /* Size of hash table of realized faces in face caches (should be a
298 #define FACE_CACHE_BUCKETS_SIZE 1001
300 /* Keyword symbols used for face attribute names. */
302 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
303 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
304 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
305 Lisp_Object QCreverse_video
;
306 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
308 /* Symbols used for attribute values. */
310 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
311 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
312 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
313 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
314 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
315 Lisp_Object Qultra_expanded
;
316 Lisp_Object Qreleased_button
, Qpressed_button
;
317 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
318 Lisp_Object Qunspecified
;
319 Lisp_Object Qignore_defface
;
321 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
323 /* The name of the function to call when the background of the frame
324 has changed, frame_set_background_mode. */
326 Lisp_Object Qframe_set_background_mode
;
328 /* Names of basic faces. */
330 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
331 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
332 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
333 extern Lisp_Object Qmode_line
;
335 /* The symbol `face-alias'. A symbols having that property is an
336 alias for another face. Value of the property is the name of
339 Lisp_Object Qface_alias
;
341 extern Lisp_Object Qcircular_list
;
343 /* Default stipple pattern used on monochrome displays. This stipple
344 pattern is used on monochrome displays instead of shades of gray
345 for a face background color. See `set-face-stipple' for possible
346 values for this variable. */
348 Lisp_Object Vface_default_stipple
;
350 /* Alist of alternative font families. Each element is of the form
351 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
352 try FAMILY1, then FAMILY2, ... */
354 Lisp_Object Vface_alternative_font_family_alist
;
356 /* Alist of alternative font registries. Each element is of the form
357 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
358 loaded, try REGISTRY1, then REGISTRY2, ... */
360 Lisp_Object Vface_alternative_font_registry_alist
;
362 /* Allowed scalable fonts. A value of nil means don't allow any
363 scalable fonts. A value of t means allow the use of any scalable
364 font. Otherwise, value must be a list of regular expressions. A
365 font may be scaled if its name matches a regular expression in the
368 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
370 /* List of regular expressions that matches names of fonts to ignore. */
372 Lisp_Object Vface_ignored_fonts
;
374 /* Alist of font name patterns vs the rescaling factor. */
376 Lisp_Object Vface_font_rescale_alist
;
378 /* Maximum number of fonts to consider in font_list. If not an
379 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
381 Lisp_Object Vfont_list_limit
;
382 #define DEFAULT_FONT_LIST_LIMIT 100
384 /* The symbols `foreground-color' and `background-color' which can be
385 used as part of a `face' property. This is for compatibility with
388 Lisp_Object Qforeground_color
, Qbackground_color
;
390 /* The symbols `face' and `mouse-face' used as text properties. */
393 extern Lisp_Object Qmouse_face
;
395 /* Property for basic faces which other faces cannot inherit. */
397 Lisp_Object Qface_no_inherit
;
399 /* Error symbol for wrong_type_argument in load_pixmap. */
401 Lisp_Object Qbitmap_spec_p
;
403 /* Alist of global face definitions. Each element is of the form
404 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
405 is a Lisp vector of face attributes. These faces are used
406 to initialize faces for new frames. */
408 Lisp_Object Vface_new_frame_defaults
;
410 /* The next ID to assign to Lisp faces. */
412 static int next_lface_id
;
414 /* A vector mapping Lisp face Id's to face names. */
416 static Lisp_Object
*lface_id_to_name
;
417 static int lface_id_to_name_size
;
419 /* TTY color-related functions (defined in tty-colors.el). */
421 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
423 /* The name of the function used to compute colors on TTYs. */
425 Lisp_Object Qtty_color_alist
;
427 /* An alist of defined terminal colors and their RGB values. */
429 Lisp_Object Vtty_defined_color_alist
;
431 /* Counter for calls to clear_face_cache. If this counter reaches
432 CLEAR_FONT_TABLE_COUNT, and a frame has more than
433 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
435 static int clear_font_table_count
;
436 #define CLEAR_FONT_TABLE_COUNT 100
437 #define CLEAR_FONT_TABLE_NFONTS 10
439 /* Non-zero means face attributes have been changed since the last
440 redisplay. Used in redisplay_internal. */
442 int face_change_count
;
444 /* Non-zero means don't display bold text if a face's foreground
445 and background colors are the inverse of the default colors of the
446 display. This is a kluge to suppress `bold black' foreground text
447 which is hard to read on an LCD monitor. */
449 int tty_suppress_bold_inverse_default_colors_p
;
451 /* A list of the form `((x . y))' used to avoid consing in
452 Finternal_set_lisp_face_attribute. */
454 static Lisp_Object Vparam_value_alist
;
456 /* The total number of colors currently allocated. */
459 static int ncolors_allocated
;
460 static int npixmaps_allocated
;
464 /* Non-zero means the definition of the `menu' face for new frames has
467 int menu_face_changed_default
;
470 /* Function prototypes. */
474 struct named_merge_point
;
476 static void map_tty_color
P_ ((struct frame
*, struct face
*,
477 enum lface_attribute_index
, int *));
478 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
479 static int may_use_scalable_font_p
P_ ((const char *));
480 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
481 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
483 static int x_face_list_fonts
P_ ((struct frame
*, char *,
484 struct font_name
**, int, int));
485 static int font_scalable_p
P_ ((struct font_name
*));
486 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
487 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
488 static unsigned char *xstrlwr
P_ ((unsigned char *));
489 static void signal_error
P_ ((char *, Lisp_Object
));
490 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
491 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
492 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
493 static void free_face_colors
P_ ((struct frame
*, struct face
*));
494 static int face_color_gray_p
P_ ((struct frame
*, char *));
495 static char *build_font_name
P_ ((struct font_name
*));
496 static void free_font_names
P_ ((struct font_name
*, int));
497 static int sorted_font_list
P_ ((struct frame
*, char *,
498 int (*cmpfn
) P_ ((const void *, const void *)),
499 struct font_name
**));
500 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
501 Lisp_Object
, struct font_name
**));
502 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
503 Lisp_Object
, struct font_name
**));
504 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
505 Lisp_Object
, Lisp_Object
, struct font_name
**,
507 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
508 Lisp_Object
, struct font_name
**));
509 static int cmp_font_names
P_ ((const void *, const void *));
510 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
511 struct face
*, int));
512 static struct face
*realize_x_face
P_ ((struct face_cache
*,
513 Lisp_Object
*, int, struct face
*));
514 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
515 Lisp_Object
*, int));
516 static int realize_basic_faces
P_ ((struct frame
*));
517 static int realize_default_face
P_ ((struct frame
*));
518 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
519 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
520 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
521 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
522 static unsigned lface_hash
P_ ((Lisp_Object
*));
523 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
524 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
525 static void free_realized_face
P_ ((struct frame
*, struct face
*));
526 static void clear_face_gcs
P_ ((struct face_cache
*));
527 static void free_face_cache
P_ ((struct face_cache
*));
528 static int face_numeric_weight
P_ ((Lisp_Object
));
529 static int face_numeric_slant
P_ ((Lisp_Object
));
530 static int face_numeric_swidth
P_ ((Lisp_Object
));
531 static int face_fontset
P_ ((Lisp_Object
*));
532 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
533 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
534 struct named_merge_point
*));
535 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
536 int, struct named_merge_point
*));
537 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
538 Lisp_Object
, int, int));
539 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
540 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
541 static void free_realized_faces
P_ ((struct face_cache
*));
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
;
1178 CHECK_TYPE (!NILP (Fbitmap_spec_p (name
)), Qbitmap_spec_p
, name
);
1183 /* Decode a bitmap spec into a bitmap. */
1188 w
= XINT (Fcar (name
));
1189 h
= XINT (Fcar (Fcdr (name
)));
1190 bits
= Fcar (Fcdr (Fcdr (name
)));
1192 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1197 /* It must be a string -- a file name. */
1198 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1204 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1215 ++npixmaps_allocated
;
1218 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1221 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1227 #endif /* HAVE_WINDOW_SYSTEM */
1231 /***********************************************************************
1233 ***********************************************************************/
1235 #ifdef HAVE_WINDOW_SYSTEM
1237 /* Load font of face FACE which is used on frame F to display
1238 character C. The name of the font to load is determined by lface
1239 and fontset of FACE. */
1242 load_face_font (f
, face
, c
)
1247 struct font_info
*font_info
= NULL
;
1249 int needs_overstrike
;
1251 face
->font_info_id
= -1;
1254 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1260 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1265 face
->font_info_id
= font_info
->font_idx
;
1266 face
->font
= font_info
->font
;
1267 face
->font_name
= font_info
->full_name
;
1268 face
->overstrike
= needs_overstrike
;
1271 x_free_gc (f
, face
->gc
);
1276 add_to_log ("Unable to load font %s",
1277 build_string (font_name
), Qnil
);
1281 #endif /* HAVE_WINDOW_SYSTEM */
1285 /***********************************************************************
1287 ***********************************************************************/
1289 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1290 RGB_LIST should contain (at least) 3 lisp integers.
1291 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1294 parse_rgb_list (rgb_list
, color
)
1295 Lisp_Object rgb_list
;
1298 #define PARSE_RGB_LIST_FIELD(field) \
1299 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1301 color->field = XINT (XCAR (rgb_list)); \
1302 rgb_list = XCDR (rgb_list); \
1307 PARSE_RGB_LIST_FIELD (red
);
1308 PARSE_RGB_LIST_FIELD (green
);
1309 PARSE_RGB_LIST_FIELD (blue
);
1315 /* Lookup on frame F the color described by the lisp string COLOR.
1316 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1317 non-zero, then the `standard' definition of the same color is
1321 tty_lookup_color (f
, color
, tty_color
, std_color
)
1324 XColor
*tty_color
, *std_color
;
1326 Lisp_Object frame
, color_desc
;
1328 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1331 XSETFRAME (frame
, f
);
1333 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1334 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1338 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1341 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1343 rgb
= XCDR (XCDR (color_desc
));
1344 if (! parse_rgb_list (rgb
, tty_color
))
1347 /* Should we fill in STD_COLOR too? */
1350 /* Default STD_COLOR to the same as TTY_COLOR. */
1351 *std_color
= *tty_color
;
1353 /* Do a quick check to see if the returned descriptor is
1354 actually _exactly_ equal to COLOR, otherwise we have to
1355 lookup STD_COLOR separately. If it's impossible to lookup
1356 a standard color, we just give up and use TTY_COLOR. */
1357 if ((!STRINGP (XCAR (color_desc
))
1358 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1359 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1361 /* Look up STD_COLOR separately. */
1362 rgb
= call1 (Qtty_color_standard_values
, color
);
1363 if (! parse_rgb_list (rgb
, std_color
))
1370 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1371 /* We were called early during startup, and the colors are not
1372 yet set up in tty-defined-color-alist. Don't return a failure
1373 indication, since this produces the annoying "Unable to
1374 load color" messages in the *Messages* buffer. */
1377 /* tty-color-desc seems to have returned a bad value. */
1381 /* A version of defined_color for non-X frames. */
1384 tty_defined_color (f
, color_name
, color_def
, alloc
)
1393 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1395 color_def
->blue
= 0;
1396 color_def
->green
= 0;
1399 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1401 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1403 if (strcmp (color_name
, "unspecified-fg") == 0)
1404 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1405 else if (strcmp (color_name
, "unspecified-bg") == 0)
1406 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1409 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1416 /* Decide if color named COLOR_NAME is valid for the display
1417 associated with the frame F; if so, return the rgb values in
1418 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1420 This does the right thing for any type of frame. */
1423 defined_color (f
, color_name
, color_def
, alloc
)
1429 if (!FRAME_WINDOW_P (f
))
1430 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1431 #ifdef HAVE_X_WINDOWS
1432 else if (FRAME_X_P (f
))
1433 return x_defined_color (f
, color_name
, color_def
, alloc
);
1436 else if (FRAME_W32_P (f
))
1437 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1440 else if (FRAME_MAC_P (f
))
1441 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1448 /* Given the index IDX of a tty color on frame F, return its name, a
1452 tty_color_name (f
, idx
)
1456 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1459 Lisp_Object coldesc
;
1461 XSETFRAME (frame
, f
);
1462 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1464 if (!NILP (coldesc
))
1465 return XCAR (coldesc
);
1468 /* We can have an MSDOG frame under -nw for a short window of
1469 opportunity before internal_terminal_init is called. DTRT. */
1470 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1471 return msdos_stdcolor_name (idx
);
1474 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1475 return build_string (unspecified_fg
);
1476 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1477 return build_string (unspecified_bg
);
1480 return vga_stdcolor_name (idx
);
1483 return Qunspecified
;
1487 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1490 The criterion implemented here is not a terribly sophisticated one. */
1493 face_color_gray_p (f
, color_name
)
1500 if (defined_color (f
, color_name
, &color
, 0))
1501 gray_p
= (/* Any color sufficiently close to black counts as grey. */
1502 (color
.red
< 5000 && color
.green
< 5000 && color
.blue
< 5000)
1504 ((abs (color
.red
- color
.green
)
1505 < max (color
.red
, color
.green
) / 20)
1506 && (abs (color
.green
- color
.blue
)
1507 < max (color
.green
, color
.blue
) / 20)
1508 && (abs (color
.blue
- color
.red
)
1509 < max (color
.blue
, color
.red
) / 20)));
1517 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1518 BACKGROUND_P non-zero means the color will be used as background
1522 face_color_supported_p (f
, color_name
, background_p
)
1530 XSETFRAME (frame
, f
);
1532 #ifdef HAVE_WINDOW_SYSTEM
1534 ? (!NILP (Fxw_display_color_p (frame
))
1535 || xstricmp (color_name
, "black") == 0
1536 || xstricmp (color_name
, "white") == 0
1538 && face_color_gray_p (f
, color_name
))
1539 || (!NILP (Fx_display_grayscale_p (frame
))
1540 && face_color_gray_p (f
, color_name
)))
1543 tty_defined_color (f
, color_name
, ¬_used
, 0);
1547 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1548 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1549 FRAME specifies the frame and thus the display for interpreting COLOR.
1550 If FRAME is nil or omitted, use the selected frame. */)
1552 Lisp_Object color
, frame
;
1556 CHECK_STRING (color
);
1558 frame
= selected_frame
;
1560 CHECK_FRAME (frame
);
1562 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1566 DEFUN ("color-supported-p", Fcolor_supported_p
,
1567 Scolor_supported_p
, 1, 3, 0,
1568 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1569 BACKGROUND-P non-nil means COLOR is used as a background.
1570 Otherwise, this function tells whether it can be used as a foreground.
1571 If FRAME is nil or omitted, use the selected frame.
1572 COLOR must be a valid color name. */)
1573 (color
, frame
, background_p
)
1574 Lisp_Object frame
, color
, background_p
;
1578 CHECK_STRING (color
);
1580 frame
= selected_frame
;
1582 CHECK_FRAME (frame
);
1584 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1590 /* Load color with name NAME for use by face FACE on frame F.
1591 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1592 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1593 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1594 pixel color. If color cannot be loaded, display a message, and
1595 return the foreground, background or underline color of F, but
1596 record that fact in flags of the face so that we don't try to free
1600 load_color (f
, face
, name
, target_index
)
1604 enum lface_attribute_index target_index
;
1608 xassert (STRINGP (name
));
1609 xassert (target_index
== LFACE_FOREGROUND_INDEX
1610 || target_index
== LFACE_BACKGROUND_INDEX
1611 || target_index
== LFACE_UNDERLINE_INDEX
1612 || target_index
== LFACE_OVERLINE_INDEX
1613 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1614 || target_index
== LFACE_BOX_INDEX
);
1616 /* if the color map is full, defined_color will return a best match
1617 to the values in an existing cell. */
1618 if (!defined_color (f
, SDATA (name
), &color
, 1))
1620 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1622 switch (target_index
)
1624 case LFACE_FOREGROUND_INDEX
:
1625 face
->foreground_defaulted_p
= 1;
1626 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1629 case LFACE_BACKGROUND_INDEX
:
1630 face
->background_defaulted_p
= 1;
1631 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1634 case LFACE_UNDERLINE_INDEX
:
1635 face
->underline_defaulted_p
= 1;
1636 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1639 case LFACE_OVERLINE_INDEX
:
1640 face
->overline_color_defaulted_p
= 1;
1641 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1644 case LFACE_STRIKE_THROUGH_INDEX
:
1645 face
->strike_through_color_defaulted_p
= 1;
1646 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1649 case LFACE_BOX_INDEX
:
1650 face
->box_color_defaulted_p
= 1;
1651 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1660 ++ncolors_allocated
;
1667 #ifdef HAVE_WINDOW_SYSTEM
1669 /* Load colors for face FACE which is used on frame F. Colors are
1670 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1671 of ATTRS. If the background color specified is not supported on F,
1672 try to emulate gray colors with a stipple from Vface_default_stipple. */
1675 load_face_colors (f
, face
, attrs
)
1682 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1683 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1685 /* Swap colors if face is inverse-video. */
1686 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1694 /* Check for support for foreground, not for background because
1695 face_color_supported_p is smart enough to know that grays are
1696 "supported" as background because we are supposed to use stipple
1698 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1699 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1701 x_destroy_bitmap (f
, face
->stipple
);
1702 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1703 &face
->pixmap_w
, &face
->pixmap_h
);
1706 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1707 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1711 /* Free color PIXEL on frame F. */
1714 unload_color (f
, pixel
)
1716 unsigned long pixel
;
1718 #ifdef HAVE_X_WINDOWS
1722 x_free_colors (f
, &pixel
, 1);
1729 /* Free colors allocated for FACE. */
1732 free_face_colors (f
, face
)
1736 #ifdef HAVE_X_WINDOWS
1737 if (face
->colors_copied_bitwise_p
)
1742 if (!face
->foreground_defaulted_p
)
1744 x_free_colors (f
, &face
->foreground
, 1);
1745 IF_DEBUG (--ncolors_allocated
);
1748 if (!face
->background_defaulted_p
)
1750 x_free_colors (f
, &face
->background
, 1);
1751 IF_DEBUG (--ncolors_allocated
);
1754 if (face
->underline_p
1755 && !face
->underline_defaulted_p
)
1757 x_free_colors (f
, &face
->underline_color
, 1);
1758 IF_DEBUG (--ncolors_allocated
);
1761 if (face
->overline_p
1762 && !face
->overline_color_defaulted_p
)
1764 x_free_colors (f
, &face
->overline_color
, 1);
1765 IF_DEBUG (--ncolors_allocated
);
1768 if (face
->strike_through_p
1769 && !face
->strike_through_color_defaulted_p
)
1771 x_free_colors (f
, &face
->strike_through_color
, 1);
1772 IF_DEBUG (--ncolors_allocated
);
1775 if (face
->box
!= FACE_NO_BOX
1776 && !face
->box_color_defaulted_p
)
1778 x_free_colors (f
, &face
->box_color
, 1);
1779 IF_DEBUG (--ncolors_allocated
);
1783 #endif /* HAVE_X_WINDOWS */
1786 #endif /* HAVE_WINDOW_SYSTEM */
1790 /***********************************************************************
1792 ***********************************************************************/
1794 /* An enumerator for each field of an XLFD font name. */
1815 /* An enumerator for each possible slant value of a font. Taken from
1816 the XLFD specification. */
1824 XLFD_SLANT_REVERSE_ITALIC
,
1825 XLFD_SLANT_REVERSE_OBLIQUE
,
1829 /* Relative font weight according to XLFD documentation. */
1833 XLFD_WEIGHT_UNKNOWN
,
1834 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1835 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1836 XLFD_WEIGHT_LIGHT
, /* 30 */
1837 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1838 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1839 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1840 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1841 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1842 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1845 /* Relative proportionate width. */
1849 XLFD_SWIDTH_UNKNOWN
,
1850 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1851 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1852 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1853 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1854 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1855 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1856 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1857 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1858 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1861 /* Structure used for tables mapping XLFD weight, slant, and width
1862 names to numeric and symbolic values. */
1868 Lisp_Object
*symbol
;
1871 /* Table of XLFD slant names and their numeric and symbolic
1872 representations. This table must be sorted by slant names in
1875 static struct table_entry slant_table
[] =
1877 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1878 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1879 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1880 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1881 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1882 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1885 /* Table of XLFD weight names. This table must be sorted by weight
1886 names in ascending order. */
1888 static struct table_entry weight_table
[] =
1890 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1891 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1892 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1893 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1894 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1895 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1896 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1897 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1898 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1899 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1900 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1901 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1902 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1903 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1904 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1905 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1908 /* Table of XLFD width names. This table must be sorted by width
1909 names in ascending order. */
1911 static struct table_entry swidth_table
[] =
1913 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1914 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1915 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1916 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1917 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1918 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1919 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1920 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1921 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1922 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1923 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1924 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1925 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1926 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1927 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1930 /* Structure used to hold the result of splitting font names in XLFD
1931 format into their fields. */
1935 /* The original name which is modified destructively by
1936 split_font_name. The pointer is kept here to be able to free it
1937 if it was allocated from the heap. */
1940 /* Font name fields. Each vector element points into `name' above.
1941 Fields are NUL-terminated. */
1942 char *fields
[XLFD_LAST
];
1944 /* Numeric values for those fields that interest us. See
1945 split_font_name for which these are. */
1946 int numeric
[XLFD_LAST
];
1948 /* If the original name matches one of Vface_font_rescale_alist,
1949 the value is the corresponding rescale ratio. Otherwise, the
1951 double rescale_ratio
;
1953 /* Lower value mean higher priority. */
1954 int registry_priority
;
1957 /* The frame in effect when sorting font names. Set temporarily in
1958 sort_fonts so that it is available in font comparison functions. */
1960 static struct frame
*font_frame
;
1962 /* Order by which font selection chooses fonts. The default values
1963 mean `first, find a best match for the font width, then for the
1964 font height, then for weight, then for slant.' This variable can be
1965 set via set-face-font-sort-order. */
1968 static int font_sort_order
[4] = {
1969 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1972 static int font_sort_order
[4];
1975 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1976 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1977 is a pointer to the matching table entry or null if no table entry
1980 static struct table_entry
*
1981 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1982 struct table_entry
*table
;
1984 struct font_name
*font
;
1987 /* Function split_font_name converts fields to lower-case, so there
1988 is no need to use xstrlwr or xstricmp here. */
1989 char *s
= font
->fields
[field_index
];
1990 int low
, mid
, high
, cmp
;
1997 mid
= (low
+ high
) / 2;
1998 cmp
= strcmp (table
[mid
].name
, s
);
2012 /* Return a numeric representation for font name field
2013 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2014 has DIM entries. Value is the numeric value found or DFLT if no
2015 table entry matches. This function is used to translate weight,
2016 slant, and swidth names of XLFD font names to numeric values. */
2019 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2020 struct table_entry
*table
;
2022 struct font_name
*font
;
2026 struct table_entry
*p
;
2027 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2028 return p
? p
->numeric
: dflt
;
2032 /* Return a symbolic representation for font name field
2033 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2034 has DIM entries. Value is the symbolic value found or DFLT if no
2035 table entry matches. This function is used to translate weight,
2036 slant, and swidth names of XLFD font names to symbols. */
2038 static INLINE Lisp_Object
2039 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2040 struct table_entry
*table
;
2042 struct font_name
*font
;
2046 struct table_entry
*p
;
2047 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2048 return p
? *p
->symbol
: dflt
;
2052 /* Return a numeric value for the slant of the font given by FONT. */
2055 xlfd_numeric_slant (font
)
2056 struct font_name
*font
;
2058 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2059 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2063 /* Return a symbol representing the weight of the font given by FONT. */
2065 static INLINE Lisp_Object
2066 xlfd_symbolic_slant (font
)
2067 struct font_name
*font
;
2069 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2070 font
, XLFD_SLANT
, Qnormal
);
2074 /* Return a numeric value for the weight of the font given by FONT. */
2077 xlfd_numeric_weight (font
)
2078 struct font_name
*font
;
2080 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2081 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2085 /* Return a symbol representing the slant of the font given by FONT. */
2087 static INLINE Lisp_Object
2088 xlfd_symbolic_weight (font
)
2089 struct font_name
*font
;
2091 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2092 font
, XLFD_WEIGHT
, Qnormal
);
2096 /* Return a numeric value for the swidth of the font whose XLFD font
2097 name fields are found in FONT. */
2100 xlfd_numeric_swidth (font
)
2101 struct font_name
*font
;
2103 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2104 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2108 /* Return a symbolic value for the swidth of FONT. */
2110 static INLINE Lisp_Object
2111 xlfd_symbolic_swidth (font
)
2112 struct font_name
*font
;
2114 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2115 font
, XLFD_SWIDTH
, Qnormal
);
2119 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2120 entries. Value is a pointer to the matching table entry or null if
2121 no element of TABLE contains SYMBOL. */
2123 static struct table_entry
*
2124 face_value (table
, dim
, symbol
)
2125 struct table_entry
*table
;
2131 xassert (SYMBOLP (symbol
));
2133 for (i
= 0; i
< dim
; ++i
)
2134 if (EQ (*table
[i
].symbol
, symbol
))
2137 return i
< dim
? table
+ i
: NULL
;
2141 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2142 entries. Value is -1 if SYMBOL is not found in TABLE. */
2145 face_numeric_value (table
, dim
, symbol
)
2146 struct table_entry
*table
;
2150 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2151 return p
? p
->numeric
: -1;
2155 /* Return a numeric value representing the weight specified by Lisp
2156 symbol WEIGHT. Value is one of the enumerators of enum
2160 face_numeric_weight (weight
)
2163 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2167 /* Return a numeric value representing the slant specified by Lisp
2168 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2171 face_numeric_slant (slant
)
2174 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2178 /* Return a numeric value representing the swidth specified by Lisp
2179 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2182 face_numeric_swidth (width
)
2185 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2189 #ifdef HAVE_WINDOW_SYSTEM
2191 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2195 struct font_name
*font
;
2197 /* Function split_font_name converts fields to lower-case, so there
2198 is no need to use tolower here. */
2199 return *font
->fields
[XLFD_SPACING
] != 'p';
2203 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2205 The actual height of the font when displayed on F depends on the
2206 resolution of both the font and frame. For example, a 10pt font
2207 designed for a 100dpi display will display larger than 10pt on a
2208 75dpi display. (It's not unusual to use fonts not designed for the
2209 display one is using. For example, some intlfonts are available in
2210 72dpi versions, only.)
2212 Value is the real point size of FONT on frame F, or 0 if it cannot
2216 xlfd_point_size (f
, font
)
2218 struct font_name
*font
;
2220 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2221 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2225 if (*pixel_field
== '[')
2227 /* The pixel size field is `[A B C D]' which specifies
2228 a transformation matrix.
2234 by which all glyphs of the font are transformed. The spec
2235 says that s scalar value N for the pixel size is equivalent
2236 to A = N * resx/resy, B = C = 0, D = N. */
2237 char *start
= pixel_field
+ 1, *end
;
2241 for (i
= 0; i
< 4; ++i
)
2243 matrix
[i
] = strtod (start
, &end
);
2250 pixel
= atoi (pixel_field
);
2255 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2261 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2262 of frame F. This function is used to guess a point size of font
2263 when only the pixel height of the font is available. */
2266 pixel_point_size (f
, pixel
)
2270 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2274 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2275 point size of one dot. */
2276 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2277 int_pt
= real_pt
+ 0.5;
2283 /* Return a rescaling ratio of a font of NAME. */
2286 font_rescale_ratio (name
)
2289 Lisp_Object tail
, elt
;
2291 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2294 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2295 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2296 return XFLOAT_DATA (XCDR (elt
));
2302 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2303 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2304 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2305 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2306 zero if the font name doesn't have the format we expect. The
2307 expected format is a font name that starts with a `-' and has
2308 XLFD_LAST fields separated by `-'. */
2311 split_font_name (f
, font
, numeric_p
)
2313 struct font_name
*font
;
2318 double rescale_ratio
;
2321 /* This must be done before splitting the font name. */
2322 rescale_ratio
= font_rescale_ratio (font
->name
);
2324 if (*font
->name
== '-')
2326 char *p
= xstrlwr (font
->name
) + 1;
2328 while (i
< XLFD_LAST
)
2330 font
->fields
[i
] = p
;
2333 /* Pixel and point size may be of the form `[....]'. For
2334 BNF, see XLFD spec, chapter 4. Negative values are
2335 indicated by tilde characters which we replace with
2336 `-' characters, here. */
2338 && (i
- 1 == XLFD_PIXEL_SIZE
2339 || i
- 1 == XLFD_POINT_SIZE
))
2344 for (++p
; *p
&& *p
!= ']'; ++p
)
2348 /* Check that the matrix contains 4 floating point
2350 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2353 if (strtod (start
, &end
) == 0 && start
== end
)
2360 while (*p
&& *p
!= '-')
2370 success_p
= i
== XLFD_LAST
;
2372 /* If requested, and font name was in the expected format,
2373 compute numeric values for some fields. */
2374 if (numeric_p
&& success_p
)
2376 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2377 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2378 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2379 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2380 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2381 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2382 font
->rescale_ratio
= rescale_ratio
;
2385 /* Initialize it to zero. It will be overridden by font_list while
2386 trying alternate registries. */
2387 font
->registry_priority
= 0;
2393 /* Build an XLFD font name from font name fields in FONT. Value is a
2394 pointer to the font name, which is allocated via xmalloc. */
2397 build_font_name (font
)
2398 struct font_name
*font
;
2402 char *font_name
= (char *) xmalloc (size
);
2403 int total_length
= 0;
2405 for (i
= 0; i
< XLFD_LAST
; ++i
)
2407 /* Add 1 because of the leading `-'. */
2408 int len
= strlen (font
->fields
[i
]) + 1;
2410 /* Reallocate font_name if necessary. Add 1 for the final
2412 if (total_length
+ len
+ 1 >= size
)
2414 int new_size
= max (2 * size
, size
+ len
+ 1);
2415 int sz
= new_size
* sizeof *font_name
;
2416 font_name
= (char *) xrealloc (font_name
, sz
);
2420 font_name
[total_length
] = '-';
2421 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2422 total_length
+= len
;
2425 font_name
[total_length
] = 0;
2430 /* Free an array FONTS of N font_name structures. This frees FONTS
2431 itself and all `name' fields in its elements. */
2434 free_font_names (fonts
, n
)
2435 struct font_name
*fonts
;
2439 xfree (fonts
[--n
].name
);
2444 /* Sort vector FONTS of font_name structures which contains NFONTS
2445 elements using qsort and comparison function CMPFN. F is the frame
2446 on which the fonts will be used. The global variable font_frame
2447 is temporarily set to F to make it available in CMPFN. */
2450 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2452 struct font_name
*fonts
;
2454 int (*cmpfn
) P_ ((const void *, const void *));
2457 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2462 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2463 display in x_display_list. FONTS is a pointer to a vector of
2464 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2465 alternative patterns from Valternate_fontname_alist if no fonts are
2466 found matching PATTERN.
2468 For all fonts found, set FONTS[i].name to the name of the font,
2469 allocated via xmalloc, and split font names into fields. Ignore
2470 fonts that we can't parse. Value is the number of fonts found. */
2473 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2476 struct font_name
**pfonts
;
2477 int nfonts
, try_alternatives_p
;
2481 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2482 better to do it the other way around. */
2484 Lisp_Object lpattern
, tem
;
2485 struct font_name
*fonts
= 0;
2486 int num_fonts
= nfonts
;
2489 lpattern
= build_string (pattern
);
2491 /* Get the list of fonts matching PATTERN. */
2494 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2497 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2500 if (nfonts
< 0 && CONSP (lfonts
))
2501 num_fonts
= XFASTINT (Flength (lfonts
));
2503 /* Make a copy of the font names we got from X, and
2504 split them into fields. */
2506 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2508 Lisp_Object elt
, tail
;
2509 const char *name
= SDATA (XCAR (tem
));
2511 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2512 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2516 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2527 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2531 /* Make a copy of the font name. */
2532 fonts
[n
].name
= xstrdup (name
);
2534 if (split_font_name (f
, fonts
+ n
, 1))
2536 if (font_scalable_p (fonts
+ n
)
2537 && !may_use_scalable_font_p (name
))
2540 xfree (fonts
[n
].name
);
2546 xfree (fonts
[n
].name
);
2549 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2550 if (n
== 0 && try_alternatives_p
)
2552 Lisp_Object list
= Valternate_fontname_alist
;
2560 while (CONSP (list
))
2562 Lisp_Object entry
= XCAR (list
);
2564 && STRINGP (XCAR (entry
))
2565 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2572 Lisp_Object patterns
= XCAR (list
);
2575 while (CONSP (patterns
)
2576 /* If list is screwed up, give up. */
2577 && (name
= XCAR (patterns
),
2579 /* Ignore patterns equal to PATTERN because we tried that
2580 already with no success. */
2581 && (strcmp (SDATA (name
), pattern
) == 0
2582 || (n
= x_face_list_fonts (f
, SDATA (name
),
2585 patterns
= XCDR (patterns
);
2593 /* Check if a font matching pattern_offset_t on frame F is available
2594 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2595 a font name pattern is generated from FAMILY and REGISTRY. */
2598 face_font_available_p (f
, pattern
)
2600 Lisp_Object pattern
;
2604 if (! STRINGP (pattern
))
2606 Lisp_Object family
, registry
;
2607 char *family_str
, *registry_str
, *pattern_str
;
2609 CHECK_CONS (pattern
);
2610 family
= XCAR (pattern
);
2615 CHECK_STRING (family
);
2616 family_str
= (char *) SDATA (family
);
2618 registry
= XCDR (pattern
);
2619 if (NILP (registry
))
2623 CHECK_STRING (registry
);
2624 registry_str
= (char *) SDATA (registry
);
2627 pattern_str
= (char *) alloca (strlen (family_str
)
2628 + strlen (registry_str
)
2630 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2631 strcat (pattern_str
, family_str
);
2632 strcat (pattern_str
, "-*-");
2633 strcat (pattern_str
, registry_str
);
2634 if (!index (registry_str
, '-'))
2636 if (registry_str
[strlen (registry_str
) - 1] == '*')
2637 strcat (pattern_str
, "-*");
2639 strcat (pattern_str
, "*-*");
2641 pattern
= build_string (pattern_str
);
2644 /* Get the list of fonts matching PATTERN. */
2647 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2650 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2652 return XINT (Flength (fonts
));
2656 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2657 using comparison function CMPFN. Value is the number of fonts
2658 found. If value is non-zero, *FONTS is set to a vector of
2659 font_name structures allocated from the heap containing matching
2660 fonts. Each element of *FONTS contains a name member that is also
2661 allocated from the heap. Font names in these structures are split
2662 into fields. Use free_font_names to free such an array. */
2665 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2668 int (*cmpfn
) P_ ((const void *, const void *));
2669 struct font_name
**fonts
;
2673 /* Get the list of fonts matching pattern. 100 should suffice. */
2674 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2675 if (INTEGERP (Vfont_list_limit
))
2676 nfonts
= XINT (Vfont_list_limit
);
2679 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2681 /* Sort the resulting array and return it in *FONTS. If no
2682 fonts were found, make sure to set *FONTS to null. */
2684 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2695 /* Compare two font_name structures *A and *B. Value is analogous to
2696 strcmp. Sort order is given by the global variable
2697 font_sort_order. Font names are sorted so that, everything else
2698 being equal, fonts with a resolution closer to that of the frame on
2699 which they are used are listed first. The global variable
2700 font_frame is the frame on which we operate. */
2703 cmp_font_names (a
, b
)
2706 struct font_name
*x
= (struct font_name
*) a
;
2707 struct font_name
*y
= (struct font_name
*) b
;
2710 /* All strings have been converted to lower-case by split_font_name,
2711 so we can use strcmp here. */
2712 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2717 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2719 int j
= font_sort_order
[i
];
2720 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2725 /* Everything else being equal, we prefer fonts with an
2726 y-resolution closer to that of the frame. */
2727 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2728 int x_resy
= x
->numeric
[XLFD_RESY
];
2729 int y_resy
= y
->numeric
[XLFD_RESY
];
2730 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2738 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2739 is non-nil list fonts matching that pattern. Otherwise, if
2740 REGISTRY is non-nil return only fonts with that registry, otherwise
2741 return fonts of any registry. Set *FONTS to a vector of font_name
2742 structures allocated from the heap containing the fonts found.
2743 Value is the number of fonts found. */
2746 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2748 Lisp_Object pattern
, family
, registry
;
2749 struct font_name
**fonts
;
2751 char *pattern_str
, *family_str
, *registry_str
;
2755 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2756 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2758 pattern_str
= (char *) alloca (strlen (family_str
)
2759 + strlen (registry_str
)
2761 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2762 strcat (pattern_str
, family_str
);
2763 strcat (pattern_str
, "-*-");
2764 strcat (pattern_str
, registry_str
);
2765 if (!index (registry_str
, '-'))
2767 if (registry_str
[strlen (registry_str
) - 1] == '*')
2768 strcat (pattern_str
, "-*");
2770 strcat (pattern_str
, "*-*");
2774 pattern_str
= (char *) SDATA (pattern
);
2776 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2780 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2781 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2782 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2785 static struct font_name
*
2786 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2787 struct font_name
*fonts1
, *fonts2
;
2788 int nfonts1
, nfonts2
;
2790 int new_nfonts
= nfonts1
+ nfonts2
;
2791 struct font_name
*new_fonts
;
2793 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2794 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2795 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2802 /* Get a sorted list of fonts of family FAMILY on frame F.
2804 If PATTERN is non-nil list fonts matching that pattern.
2806 If REGISTRY is non-nil, return fonts with that registry and the
2807 alternative registries from Vface_alternative_font_registry_alist.
2809 If REGISTRY is nil return fonts of any registry.
2811 Set *FONTS to a vector of font_name structures allocated from the
2812 heap containing the fonts found. Value is the number of fonts
2816 font_list (f
, pattern
, family
, registry
, fonts
)
2818 Lisp_Object pattern
, family
, registry
;
2819 struct font_name
**fonts
;
2821 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2823 if (!NILP (registry
)
2824 && CONSP (Vface_alternative_font_registry_alist
))
2828 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2833 for (alter
= XCDR (alter
), reg_prio
= 1;
2835 alter
= XCDR (alter
), reg_prio
++)
2836 if (STRINGP (XCAR (alter
)))
2839 struct font_name
*fonts2
;
2841 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2843 for (i
= 0; i
< nfonts2
; i
++)
2844 fonts2
[i
].registry_priority
= reg_prio
;
2845 *fonts
= (nfonts
> 0
2846 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2857 /* Remove elements from LIST whose cars are `equal'. Called from
2858 x-family-fonts and x-font-family-list to remove duplicate font
2862 remove_duplicates (list
)
2865 Lisp_Object tail
= list
;
2867 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2869 Lisp_Object next
= XCDR (tail
);
2870 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2871 XSETCDR (tail
, XCDR (next
));
2878 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2879 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2880 If FAMILY is omitted or nil, list all families.
2881 Otherwise, FAMILY must be a string, possibly containing wildcards
2883 If FRAME is omitted or nil, use the selected frame.
2884 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2885 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2886 FAMILY is the font family name. POINT-SIZE is the size of the
2887 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2888 width, weight and slant of the font. These symbols are the same as for
2889 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2890 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2891 giving the registry and encoding of the font.
2892 The result list is sorted according to the current setting of
2893 the face font sort order. */)
2895 Lisp_Object family
, frame
;
2897 struct frame
*f
= check_x_frame (frame
);
2898 struct font_name
*fonts
;
2901 struct gcpro gcpro1
;
2904 CHECK_STRING (family
);
2908 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2909 for (i
= nfonts
- 1; i
>= 0; --i
)
2911 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2914 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2915 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2916 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2917 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2918 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2919 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2920 tem
= build_font_name (fonts
+ i
);
2921 ASET (v
, 6, build_string (tem
));
2922 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2923 fonts
[i
].fields
[XLFD_ENCODING
]);
2924 ASET (v
, 7, build_string (tem
));
2927 result
= Fcons (v
, result
);
2930 remove_duplicates (result
);
2931 free_font_names (fonts
, nfonts
);
2937 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2939 doc
: /* Return a list of available font families on FRAME.
2940 If FRAME is omitted or nil, use the selected frame.
2941 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2942 is a font family, and FIXED-P is non-nil if fonts of that family
2943 are fixed-pitch. */)
2947 struct frame
*f
= check_x_frame (frame
);
2949 struct font_name
*fonts
;
2951 struct gcpro gcpro1
;
2952 int count
= SPECPDL_INDEX ();
2954 /* Let's consider all fonts. */
2955 specbind (intern ("font-list-limit"), make_number (-1));
2956 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2960 for (i
= nfonts
- 1; i
>= 0; --i
)
2961 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2962 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2965 remove_duplicates (result
);
2966 free_font_names (fonts
, nfonts
);
2968 return unbind_to (count
, result
);
2972 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2973 doc
: /* Return a list of the names of available fonts matching PATTERN.
2974 If optional arguments FACE and FRAME are specified, return only fonts
2975 the same size as FACE on FRAME.
2976 PATTERN is a string, perhaps with wildcard characters;
2977 the * character matches any substring, and
2978 the ? character matches any single character.
2979 PATTERN is case-insensitive.
2980 FACE is a face name--a symbol.
2982 The return value is a list of strings, suitable as arguments to
2985 Fonts Emacs can't use may or may not be excluded
2986 even if they match PATTERN and FACE.
2987 The optional fourth argument MAXIMUM sets a limit on how many
2988 fonts to match. The first MAXIMUM fonts are reported.
2989 The optional fifth argument WIDTH, if specified, is a number of columns
2990 occupied by a character of a font. In that case, return only fonts
2991 the WIDTH times as wide as FACE on FRAME. */)
2992 (pattern
, face
, frame
, maximum
, width
)
2993 Lisp_Object pattern
, face
, frame
, maximum
, width
;
3000 CHECK_STRING (pattern
);
3006 CHECK_NATNUM (maximum
);
3007 maxnames
= XINT (maximum
);
3011 CHECK_NUMBER (width
);
3013 /* We can't simply call check_x_frame because this function may be
3014 called before any frame is created. */
3015 f
= frame_or_selected_frame (frame
, 2);
3016 if (!FRAME_WINDOW_P (f
))
3018 /* Perhaps we have not yet created any frame. */
3023 /* Determine the width standard for comparison with the fonts we find. */
3029 /* This is of limited utility since it works with character
3030 widths. Keep it for compatibility. --gerd. */
3031 int face_id
= lookup_named_face (f
, face
, 0, 0);
3032 struct face
*face
= (face_id
< 0
3034 : FACE_FROM_ID (f
, face_id
));
3037 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3038 not maximum as on X. Redefine here. */
3040 #define FONT_WIDTH FONT_MAX_WIDTH
3043 if (face
&& face
->font
)
3044 size
= FONT_WIDTH (face
->font
);
3046 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3049 size
*= XINT (width
);
3053 Lisp_Object args
[2];
3055 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3057 /* We don't have to check fontsets. */
3059 args
[1] = list_fontsets (f
, pattern
, size
);
3060 return Fnconc (2, args
);
3064 #endif /* HAVE_WINDOW_SYSTEM */
3068 /***********************************************************************
3070 ***********************************************************************/
3072 /* Access face attributes of face LFACE, a Lisp vector. */
3074 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3075 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3076 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3077 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3078 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3079 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3080 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3081 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3082 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3083 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3084 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3085 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3086 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3087 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3088 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3089 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3091 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3092 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3094 #define LFACEP(LFACE) \
3096 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3097 && EQ (AREF (LFACE, 0), Qface))
3102 /* Check consistency of Lisp face attribute vector ATTRS. */
3105 check_lface_attrs (attrs
)
3108 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3109 || IGNORE_DEFFACE_P (attrs
[LFACE_FAMILY_INDEX
])
3110 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3111 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3112 || IGNORE_DEFFACE_P (attrs
[LFACE_SWIDTH_INDEX
])
3113 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3114 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3115 || IGNORE_DEFFACE_P (attrs
[LFACE_AVGWIDTH_INDEX
])
3116 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3117 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3118 || IGNORE_DEFFACE_P (attrs
[LFACE_HEIGHT_INDEX
])
3119 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3120 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3121 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3122 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3123 || IGNORE_DEFFACE_P (attrs
[LFACE_WEIGHT_INDEX
])
3124 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3125 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3126 || IGNORE_DEFFACE_P (attrs
[LFACE_SLANT_INDEX
])
3127 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3128 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3129 || IGNORE_DEFFACE_P (attrs
[LFACE_UNDERLINE_INDEX
])
3130 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3131 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3132 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3133 || IGNORE_DEFFACE_P (attrs
[LFACE_OVERLINE_INDEX
])
3134 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3135 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3136 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3137 || IGNORE_DEFFACE_P (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3138 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3139 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3140 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3141 || IGNORE_DEFFACE_P (attrs
[LFACE_BOX_INDEX
])
3142 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3143 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3144 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3145 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3146 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3147 || IGNORE_DEFFACE_P (attrs
[LFACE_INVERSE_INDEX
])
3148 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3149 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3150 || IGNORE_DEFFACE_P (attrs
[LFACE_FOREGROUND_INDEX
])
3151 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3152 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3153 || IGNORE_DEFFACE_P (attrs
[LFACE_BACKGROUND_INDEX
])
3154 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3155 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3156 || IGNORE_DEFFACE_P (attrs
[LFACE_INHERIT_INDEX
])
3157 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3158 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3159 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3160 #ifdef HAVE_WINDOW_SYSTEM
3161 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3162 || IGNORE_DEFFACE_P (attrs
[LFACE_STIPPLE_INDEX
])
3163 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3164 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3165 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3166 || IGNORE_DEFFACE_P (attrs
[LFACE_FONT_INDEX
])
3167 || NILP (attrs
[LFACE_FONT_INDEX
])
3168 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3173 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3181 xassert (LFACEP (lface
));
3182 check_lface_attrs (XVECTOR (lface
)->contents
);
3186 #else /* GLYPH_DEBUG == 0 */
3188 #define check_lface_attrs(attrs) (void) 0
3189 #define check_lface(lface) (void) 0
3191 #endif /* GLYPH_DEBUG == 0 */
3195 /* Face-merge cycle checking. */
3197 /* A `named merge point' is simply a point during face-merging where we
3198 look up a face by name. We keep a stack of which named lookups we're
3199 currently processing so that we can easily detect cycles, using a
3200 linked- list of struct named_merge_point structures, typically
3201 allocated on the stack frame of the named lookup functions which are
3202 active (so no consing is required). */
3203 struct named_merge_point
3205 Lisp_Object face_name
;
3206 struct named_merge_point
*prev
;
3210 /* If a face merging cycle is detected for FACE_NAME, return 0,
3211 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3212 FACE_NAME, as the head of the linked list pointed to by
3213 NAMED_MERGE_POINTS, and return 1. */
3216 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3217 Lisp_Object face_name
,
3218 struct named_merge_point
**named_merge_points
)
3220 struct named_merge_point
*prev
;
3222 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3223 if (EQ (face_name
, prev
->face_name
))
3226 new_named_merge_point
->face_name
= face_name
;
3227 new_named_merge_point
->prev
= *named_merge_points
;
3229 *named_merge_points
= new_named_merge_point
;
3237 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3238 to make it a symbol. If FACE_NAME is an alias for another face,
3239 return that face's name.
3241 Return default face in case of errors. */
3244 resolve_face_name (face_name
, signal_p
)
3245 Lisp_Object face_name
;
3248 Lisp_Object orig_face
;
3249 Lisp_Object tortoise
, hare
;
3251 if (STRINGP (face_name
))
3252 face_name
= intern (SDATA (face_name
));
3254 if (NILP (face_name
) || !SYMBOLP (face_name
))
3257 orig_face
= face_name
;
3258 tortoise
= hare
= face_name
;
3263 hare
= Fget (hare
, Qface_alias
);
3264 if (NILP (hare
) || !SYMBOLP (hare
))
3268 hare
= Fget (hare
, Qface_alias
);
3269 if (NILP (hare
) || !SYMBOLP (hare
))
3272 tortoise
= Fget (tortoise
, Qface_alias
);
3273 if (EQ (hare
, tortoise
))
3276 Fsignal (Qcircular_list
, Fcons (orig_face
, Qnil
));
3285 /* Return the face definition of FACE_NAME on frame F. F null means
3286 return the definition for new frames. FACE_NAME may be a string or
3287 a symbol (apparently Emacs 20.2 allowed strings as face names in
3288 face text properties; Ediff uses that). If FACE_NAME is an alias
3289 for another face, return that face's definition. If SIGNAL_P is
3290 non-zero, signal an error if FACE_NAME is not a valid face name.
3291 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3294 static INLINE Lisp_Object
3295 lface_from_face_name (f
, face_name
, signal_p
)
3297 Lisp_Object face_name
;
3302 face_name
= resolve_face_name (face_name
, signal_p
);
3305 lface
= assq_no_quit (face_name
, f
->face_alist
);
3307 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3310 lface
= XCDR (lface
);
3312 signal_error ("Invalid face", face_name
);
3314 check_lface (lface
);
3319 /* Get face attributes of face FACE_NAME from frame-local faces on
3320 frame F. Store the resulting attributes in ATTRS which must point
3321 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3322 is non-zero, signal an error if FACE_NAME does not name a face.
3323 Otherwise, value is zero if FACE_NAME is not a face. */
3326 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3328 Lisp_Object face_name
;
3335 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3338 bcopy (XVECTOR (lface
)->contents
, attrs
,
3339 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3349 /* Non-zero if all attributes in face attribute vector ATTRS are
3350 specified, i.e. are non-nil. */
3353 lface_fully_specified_p (attrs
)
3358 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3359 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3360 && i
!= LFACE_AVGWIDTH_INDEX
)
3361 if ((UNSPECIFIEDP (attrs
[i
]) || IGNORE_DEFFACE_P (attrs
[i
]))
3363 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3364 always unspecified. */
3365 && i
!= LFACE_STIPPLE_INDEX
3370 return i
== LFACE_VECTOR_SIZE
;
3373 #ifdef HAVE_WINDOW_SYSTEM
3375 /* Set font-related attributes of Lisp face LFACE from the fullname of
3376 the font opened by FONTNAME. If FORCE_P is zero, set only
3377 unspecified attributes of LFACE. The exception is `font'
3378 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3380 If FONTNAME is not available on frame F,
3381 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3382 If the fullname is not in a valid XLFD format,
3383 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3384 in LFACE and return 1.
3385 Otherwise, return 1. */
3388 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3391 Lisp_Object fontname
;
3392 int force_p
, may_fail_p
;
3394 struct font_name font
;
3399 char *font_name
= SDATA (fontname
);
3400 struct font_info
*font_info
;
3402 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3403 fontset
= fs_query_fontset (fontname
, 0);
3405 font_name
= SDATA (fontset_ascii (fontset
));
3407 /* Check if FONT_NAME is surely available on the system. Usually
3408 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3409 returns quickly. But, even if FONT_NAME is not yet cached,
3410 caching it now is not futail because we anyway load the font
3413 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3423 font
.name
= STRDUPA (font_info
->full_name
);
3424 have_xlfd_p
= split_font_name (f
, &font
, 1);
3426 /* Set attributes only if unspecified, otherwise face defaults for
3427 new frames would never take effect. If we couldn't get a font
3428 name conforming to XLFD, set normal values. */
3430 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3435 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3436 + strlen (font
.fields
[XLFD_FOUNDRY
])
3438 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3439 font
.fields
[XLFD_FAMILY
]);
3440 val
= build_string (buffer
);
3443 val
= build_string ("*");
3444 LFACE_FAMILY (lface
) = val
;
3447 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3450 pt
= xlfd_point_size (f
, &font
);
3452 pt
= pixel_point_size (f
, font_info
->height
* 10);
3454 LFACE_HEIGHT (lface
) = make_number (pt
);
3457 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3458 LFACE_SWIDTH (lface
)
3459 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3461 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3462 LFACE_AVGWIDTH (lface
)
3464 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3467 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3468 LFACE_WEIGHT (lface
)
3469 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3471 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3473 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3475 LFACE_FONT (lface
) = fontname
;
3480 #endif /* HAVE_WINDOW_SYSTEM */
3483 /* Merges the face height FROM with the face height TO, and returns the
3484 merged height. If FROM is an invalid height, then INVALID is
3485 returned instead. FROM and TO may be either absolute face heights or
3486 `relative' heights; the returned value is always an absolute height
3487 unless both FROM and TO are relative. GCPRO is a lisp value that
3488 will be protected from garbage-collection if this function makes a
3492 merge_face_heights (from
, to
, invalid
)
3493 Lisp_Object from
, to
, invalid
;
3495 Lisp_Object result
= invalid
;
3497 if (INTEGERP (from
))
3498 /* FROM is absolute, just use it as is. */
3500 else if (FLOATP (from
))
3501 /* FROM is a scale, use it to adjust TO. */
3504 /* relative X absolute => absolute */
3505 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3506 else if (FLOATP (to
))
3507 /* relative X relative => relative */
3508 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3509 else if (UNSPECIFIEDP (to
))
3512 else if (FUNCTIONP (from
))
3513 /* FROM is a function, which use to adjust TO. */
3515 /* Call function with current height as argument.
3516 From is the new height. */
3517 Lisp_Object args
[2];
3521 result
= safe_call (2, args
);
3523 /* Ensure that if TO was absolute, so is the result. */
3524 if (INTEGERP (to
) && !INTEGERP (result
))
3532 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3533 store the resulting attributes in TO, which must be already be
3534 completely specified and contain only absolute attributes. Every
3535 specified attribute of FROM overrides the corresponding attribute of
3536 TO; relative attributes in FROM are merged with the absolute value in
3537 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3538 loops in face inheritance; it should be 0 when called from other
3542 merge_face_vectors (f
, from
, to
, named_merge_points
)
3544 Lisp_Object
*from
, *to
;
3545 struct named_merge_point
*named_merge_points
;
3549 /* If FROM inherits from some other faces, merge their attributes into
3550 TO before merging FROM's direct attributes. Note that an :inherit
3551 attribute of `unspecified' is the same as one of nil; we never
3552 merge :inherit attributes, so nil is more correct, but lots of
3553 other code uses `unspecified' as a generic value for face attributes. */
3554 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3555 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3556 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3558 /* If TO specifies a :font attribute, and FROM specifies some
3559 font-related attribute, we need to clear TO's :font attribute
3560 (because it will be inconsistent with whatever FROM specifies, and
3561 FROM takes precedence). */
3562 if (!NILP (to
[LFACE_FONT_INDEX
])
3563 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3564 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3565 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3566 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3567 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3568 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3569 to
[LFACE_FONT_INDEX
] = Qnil
;
3571 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3572 if (!UNSPECIFIEDP (from
[i
]))
3574 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3575 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3580 /* TO is always an absolute face, which should inherit from nothing.
3581 We blindly copy the :inherit attribute above and fix it up here. */
3582 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3585 /* Merge the named face FACE_NAME on frame F, into the vector of face
3586 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3587 inheritance. Returns true if FACE_NAME is a valid face name and
3588 merging succeeded. */
3591 merge_named_face (f
, face_name
, to
, named_merge_points
)
3593 Lisp_Object face_name
;
3595 struct named_merge_point
*named_merge_points
;
3597 struct named_merge_point named_merge_point
;
3599 if (push_named_merge_point (&named_merge_point
,
3600 face_name
, &named_merge_points
))
3602 struct gcpro gcpro1
;
3603 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3604 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3608 GCPRO1 (named_merge_point
.face_name
);
3609 merge_face_vectors (f
, from
, to
, named_merge_points
);
3620 /* Merge face attributes from the lisp `face reference' FACE_REF on
3621 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3622 problems with FACE_REF cause an error message to be shown. Return
3623 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3624 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3625 list structure; it may be 0 for most callers.
3627 FACE_REF may be a single face specification or a list of such
3628 specifications. Each face specification can be:
3630 1. A symbol or string naming a Lisp face.
3632 2. A property list of the form (KEYWORD VALUE ...) where each
3633 KEYWORD is a face attribute name, and value is an appropriate value
3636 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3637 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3638 for compatibility with 20.2.
3640 Face specifications earlier in lists take precedence over later
3644 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3646 Lisp_Object face_ref
;
3649 struct named_merge_point
*named_merge_points
;
3651 int ok
= 1; /* Succeed without an error? */
3653 if (CONSP (face_ref
))
3655 Lisp_Object first
= XCAR (face_ref
);
3657 if (EQ (first
, Qforeground_color
)
3658 || EQ (first
, Qbackground_color
))
3660 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3661 . COLOR). COLOR must be a string. */
3662 Lisp_Object color_name
= XCDR (face_ref
);
3663 Lisp_Object color
= first
;
3665 if (STRINGP (color_name
))
3667 if (EQ (color
, Qforeground_color
))
3668 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3670 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3675 add_to_log ("Invalid face color", color_name
, Qnil
);
3679 else if (SYMBOLP (first
)
3680 && *SDATA (SYMBOL_NAME (first
)) == ':')
3682 /* Assume this is the property list form. */
3683 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3685 Lisp_Object keyword
= XCAR (face_ref
);
3686 Lisp_Object value
= XCAR (XCDR (face_ref
));
3689 /* Specifying `unspecified' is a no-op. */
3690 if (EQ (value
, Qunspecified
))
3692 else if (EQ (keyword
, QCfamily
))
3694 if (STRINGP (value
))
3695 to
[LFACE_FAMILY_INDEX
] = value
;
3699 else if (EQ (keyword
, QCheight
))
3701 Lisp_Object new_height
=
3702 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3704 if (! NILP (new_height
))
3705 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3709 else if (EQ (keyword
, QCweight
))
3712 && face_numeric_weight (value
) >= 0)
3713 to
[LFACE_WEIGHT_INDEX
] = value
;
3717 else if (EQ (keyword
, QCslant
))
3720 && face_numeric_slant (value
) >= 0)
3721 to
[LFACE_SLANT_INDEX
] = value
;
3725 else if (EQ (keyword
, QCunderline
))
3730 to
[LFACE_UNDERLINE_INDEX
] = value
;
3734 else if (EQ (keyword
, QCoverline
))
3739 to
[LFACE_OVERLINE_INDEX
] = value
;
3743 else if (EQ (keyword
, QCstrike_through
))
3748 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3752 else if (EQ (keyword
, QCbox
))
3755 value
= make_number (1);
3756 if (INTEGERP (value
)
3760 to
[LFACE_BOX_INDEX
] = value
;
3764 else if (EQ (keyword
, QCinverse_video
)
3765 || EQ (keyword
, QCreverse_video
))
3767 if (EQ (value
, Qt
) || NILP (value
))
3768 to
[LFACE_INVERSE_INDEX
] = value
;
3772 else if (EQ (keyword
, QCforeground
))
3774 if (STRINGP (value
))
3775 to
[LFACE_FOREGROUND_INDEX
] = value
;
3779 else if (EQ (keyword
, QCbackground
))
3781 if (STRINGP (value
))
3782 to
[LFACE_BACKGROUND_INDEX
] = value
;
3786 else if (EQ (keyword
, QCstipple
))
3788 #ifdef HAVE_X_WINDOWS
3789 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3790 if (!NILP (pixmap_p
))
3791 to
[LFACE_STIPPLE_INDEX
] = value
;
3796 else if (EQ (keyword
, QCwidth
))
3799 && face_numeric_swidth (value
) >= 0)
3800 to
[LFACE_SWIDTH_INDEX
] = value
;
3804 else if (EQ (keyword
, QCinherit
))
3806 /* This is not really very useful; it's just like a
3807 normal face reference. */
3808 if (! merge_face_ref (f
, value
, to
,
3809 err_msgs
, named_merge_points
))
3817 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3821 face_ref
= XCDR (XCDR (face_ref
));
3826 /* This is a list of face refs. Those at the beginning of the
3827 list take precedence over what follows, so we have to merge
3828 from the end backwards. */
3829 Lisp_Object next
= XCDR (face_ref
);
3832 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3834 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3840 /* FACE_REF ought to be a face name. */
3841 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3842 if (!ok
&& err_msgs
)
3843 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3850 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3851 Sinternal_make_lisp_face
, 1, 2, 0,
3852 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3853 If FACE was not known as a face before, create a new one.
3854 If optional argument FRAME is specified, make a frame-local face
3855 for that frame. Otherwise operate on the global face definition.
3856 Value is a vector of face attributes. */)
3858 Lisp_Object face
, frame
;
3860 Lisp_Object global_lface
, lface
;
3864 CHECK_SYMBOL (face
);
3865 global_lface
= lface_from_face_name (NULL
, face
, 0);
3869 CHECK_LIVE_FRAME (frame
);
3871 lface
= lface_from_face_name (f
, face
, 0);
3874 f
= NULL
, lface
= Qnil
;
3876 /* Add a global definition if there is none. */
3877 if (NILP (global_lface
))
3879 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3881 AREF (global_lface
, 0) = Qface
;
3882 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3883 Vface_new_frame_defaults
);
3885 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3886 face id to Lisp face is given by the vector lface_id_to_name.
3887 The mapping from Lisp face to Lisp face id is given by the
3888 property `face' of the Lisp face name. */
3889 if (next_lface_id
== lface_id_to_name_size
)
3891 int new_size
= max (50, 2 * lface_id_to_name_size
);
3892 int sz
= new_size
* sizeof *lface_id_to_name
;
3893 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3894 lface_id_to_name_size
= new_size
;
3897 lface_id_to_name
[next_lface_id
] = face
;
3898 Fput (face
, Qface
, make_number (next_lface_id
));
3902 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3903 AREF (global_lface
, i
) = Qunspecified
;
3905 /* Add a frame-local definition. */
3910 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3912 AREF (lface
, 0) = Qface
;
3913 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3916 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3917 AREF (lface
, i
) = Qunspecified
;
3920 lface
= global_lface
;
3922 /* Changing a named face means that all realized faces depending on
3923 that face are invalid. Since we cannot tell which realized faces
3924 depend on the face, make sure they are all removed. This is done
3925 by incrementing face_change_count. The next call to
3926 init_iterator will then free realized faces. */
3927 if (NILP (Fget (face
, Qface_no_inherit
)))
3929 ++face_change_count
;
3930 ++windows_or_buffers_changed
;
3933 xassert (LFACEP (lface
));
3934 check_lface (lface
);
3939 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3940 Sinternal_lisp_face_p
, 1, 2, 0,
3941 doc
: /* Return non-nil if FACE names a face.
3942 If optional second argument FRAME is non-nil, check for the
3943 existence of a frame-local face with name FACE on that frame.
3944 Otherwise check for the existence of a global face. */)
3946 Lisp_Object face
, frame
;
3952 CHECK_LIVE_FRAME (frame
);
3953 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3956 lface
= lface_from_face_name (NULL
, face
, 0);
3962 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3963 Sinternal_copy_lisp_face
, 4, 4, 0,
3964 doc
: /* Copy face FROM to TO.
3965 If FRAME is t, copy the global face definition of FROM.
3966 Otherwise, copy the frame-local definition of FROM on FRAME.
3967 If NEW-FRAME is a frame, copy that data into the frame-local
3968 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
3969 FRAME controls where the data is copied to.
3971 The value is TO. */)
3972 (from
, to
, frame
, new_frame
)
3973 Lisp_Object from
, to
, frame
, new_frame
;
3975 Lisp_Object lface
, copy
;
3977 CHECK_SYMBOL (from
);
3982 /* Copy global definition of FROM. We don't make copies of
3983 strings etc. because 20.2 didn't do it either. */
3984 lface
= lface_from_face_name (NULL
, from
, 1);
3985 copy
= Finternal_make_lisp_face (to
, Qnil
);
3989 /* Copy frame-local definition of FROM. */
3990 if (NILP (new_frame
))
3992 CHECK_LIVE_FRAME (frame
);
3993 CHECK_LIVE_FRAME (new_frame
);
3994 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3995 copy
= Finternal_make_lisp_face (to
, new_frame
);
3998 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3999 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
4001 /* Changing a named face means that all realized faces depending on
4002 that face are invalid. Since we cannot tell which realized faces
4003 depend on the face, make sure they are all removed. This is done
4004 by incrementing face_change_count. The next call to
4005 init_iterator will then free realized faces. */
4006 if (NILP (Fget (to
, Qface_no_inherit
)))
4008 ++face_change_count
;
4009 ++windows_or_buffers_changed
;
4016 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4017 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4018 doc
: /* Set attribute ATTR of FACE to VALUE.
4019 FRAME being a frame means change the face on that frame.
4020 FRAME nil means change the face of the selected frame.
4021 FRAME t means change the default for new frames.
4022 FRAME 0 means change the face on all frames, and change the default
4024 (face
, attr
, value
, frame
)
4025 Lisp_Object face
, attr
, value
, frame
;
4028 Lisp_Object old_value
= Qnil
;
4029 /* Set 1 if ATTR is QCfont. */
4030 int font_attr_p
= 0;
4031 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4032 int font_related_attr_p
= 0;
4034 CHECK_SYMBOL (face
);
4035 CHECK_SYMBOL (attr
);
4037 face
= resolve_face_name (face
, 1);
4039 /* If FRAME is 0, change face on all frames, and change the
4040 default for new frames. */
4041 if (INTEGERP (frame
) && XINT (frame
) == 0)
4044 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4045 FOR_EACH_FRAME (tail
, frame
)
4046 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4050 /* Set lface to the Lisp attribute vector of FACE. */
4053 lface
= lface_from_face_name (NULL
, face
, 1);
4055 /* When updating face-new-frame-defaults, we put :ignore-defface
4056 where the caller wants `unspecified'. This forces the frame
4057 defaults to ignore the defface value. Otherwise, the defface
4058 will take effect, which is generally not what is intended.
4059 The value of that attribute will be inherited from some other
4060 face during face merging. See internal_merge_in_global_face. */
4061 if (UNSPECIFIEDP (value
))
4062 value
= Qignore_defface
;
4067 frame
= selected_frame
;
4069 CHECK_LIVE_FRAME (frame
);
4070 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4072 /* If a frame-local face doesn't exist yet, create one. */
4074 lface
= Finternal_make_lisp_face (face
, frame
);
4077 if (EQ (attr
, QCfamily
))
4079 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4081 CHECK_STRING (value
);
4082 if (SCHARS (value
) == 0)
4083 signal_error ("Invalid face family", value
);
4085 old_value
= LFACE_FAMILY (lface
);
4086 LFACE_FAMILY (lface
) = value
;
4087 font_related_attr_p
= 1;
4089 else if (EQ (attr
, QCheight
))
4091 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4095 test
= (EQ (face
, Qdefault
)
4097 /* The default face must have an absolute size,
4098 otherwise, we do a test merge with a random
4099 height to see if VALUE's ok. */
4100 : merge_face_heights (value
, make_number (10), Qnil
));
4102 if (!INTEGERP (test
) || XINT (test
) <= 0)
4103 signal_error ("Invalid face height", value
);
4106 old_value
= LFACE_HEIGHT (lface
);
4107 LFACE_HEIGHT (lface
) = value
;
4108 font_related_attr_p
= 1;
4110 else if (EQ (attr
, QCweight
))
4112 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4114 CHECK_SYMBOL (value
);
4115 if (face_numeric_weight (value
) < 0)
4116 signal_error ("Invalid face weight", value
);
4118 old_value
= LFACE_WEIGHT (lface
);
4119 LFACE_WEIGHT (lface
) = value
;
4120 font_related_attr_p
= 1;
4122 else if (EQ (attr
, QCslant
))
4124 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4126 CHECK_SYMBOL (value
);
4127 if (face_numeric_slant (value
) < 0)
4128 signal_error ("Invalid face slant", value
);
4130 old_value
= LFACE_SLANT (lface
);
4131 LFACE_SLANT (lface
) = value
;
4132 font_related_attr_p
= 1;
4134 else if (EQ (attr
, QCunderline
))
4136 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4137 if ((SYMBOLP (value
)
4139 && !EQ (value
, Qnil
))
4140 /* Underline color. */
4142 && SCHARS (value
) == 0))
4143 signal_error ("Invalid face underline", value
);
4145 old_value
= LFACE_UNDERLINE (lface
);
4146 LFACE_UNDERLINE (lface
) = value
;
4148 else if (EQ (attr
, QCoverline
))
4150 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4151 if ((SYMBOLP (value
)
4153 && !EQ (value
, Qnil
))
4154 /* Overline color. */
4156 && SCHARS (value
) == 0))
4157 signal_error ("Invalid face overline", value
);
4159 old_value
= LFACE_OVERLINE (lface
);
4160 LFACE_OVERLINE (lface
) = value
;
4162 else if (EQ (attr
, QCstrike_through
))
4164 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4165 if ((SYMBOLP (value
)
4167 && !EQ (value
, Qnil
))
4168 /* Strike-through color. */
4170 && SCHARS (value
) == 0))
4171 signal_error ("Invalid face strike-through", value
);
4173 old_value
= LFACE_STRIKE_THROUGH (lface
);
4174 LFACE_STRIKE_THROUGH (lface
) = value
;
4176 else if (EQ (attr
, QCbox
))
4180 /* Allow t meaning a simple box of width 1 in foreground color
4183 value
= make_number (1);
4185 if (UNSPECIFIEDP (value
) || IGNORE_DEFFACE_P (value
))
4187 else if (NILP (value
))
4189 else if (INTEGERP (value
))
4190 valid_p
= XINT (value
) != 0;
4191 else if (STRINGP (value
))
4192 valid_p
= SCHARS (value
) > 0;
4193 else if (CONSP (value
))
4209 if (EQ (k
, QCline_width
))
4211 if (!INTEGERP (v
) || XINT (v
) == 0)
4214 else if (EQ (k
, QCcolor
))
4216 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4219 else if (EQ (k
, QCstyle
))
4221 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4228 valid_p
= NILP (tem
);
4234 signal_error ("Invalid face box", value
);
4236 old_value
= LFACE_BOX (lface
);
4237 LFACE_BOX (lface
) = value
;
4239 else if (EQ (attr
, QCinverse_video
)
4240 || EQ (attr
, QCreverse_video
))
4242 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4244 CHECK_SYMBOL (value
);
4245 if (!EQ (value
, Qt
) && !NILP (value
))
4246 signal_error ("Invalid inverse-video face attribute value", value
);
4248 old_value
= LFACE_INVERSE (lface
);
4249 LFACE_INVERSE (lface
) = value
;
4251 else if (EQ (attr
, QCforeground
))
4253 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4255 /* Don't check for valid color names here because it depends
4256 on the frame (display) whether the color will be valid
4257 when the face is realized. */
4258 CHECK_STRING (value
);
4259 if (SCHARS (value
) == 0)
4260 signal_error ("Empty foreground color value", value
);
4262 old_value
= LFACE_FOREGROUND (lface
);
4263 LFACE_FOREGROUND (lface
) = value
;
4265 else if (EQ (attr
, QCbackground
))
4267 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4269 /* Don't check for valid color names here because it depends
4270 on the frame (display) whether the color will be valid
4271 when the face is realized. */
4272 CHECK_STRING (value
);
4273 if (SCHARS (value
) == 0)
4274 signal_error ("Empty background color value", value
);
4276 old_value
= LFACE_BACKGROUND (lface
);
4277 LFACE_BACKGROUND (lface
) = value
;
4279 else if (EQ (attr
, QCstipple
))
4281 #ifdef HAVE_X_WINDOWS
4282 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4284 && NILP (Fbitmap_spec_p (value
)))
4285 signal_error ("Invalid stipple attribute", value
);
4286 old_value
= LFACE_STIPPLE (lface
);
4287 LFACE_STIPPLE (lface
) = value
;
4288 #endif /* HAVE_X_WINDOWS */
4290 else if (EQ (attr
, QCwidth
))
4292 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4294 CHECK_SYMBOL (value
);
4295 if (face_numeric_swidth (value
) < 0)
4296 signal_error ("Invalid face width", value
);
4298 old_value
= LFACE_SWIDTH (lface
);
4299 LFACE_SWIDTH (lface
) = value
;
4300 font_related_attr_p
= 1;
4302 else if (EQ (attr
, QCfont
))
4304 #ifdef HAVE_WINDOW_SYSTEM
4305 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4307 /* Set font-related attributes of the Lisp face from an XLFD
4313 f
= SELECTED_FRAME ();
4315 f
= check_x_frame (frame
);
4317 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4319 CHECK_STRING (value
);
4321 /* VALUE may be a fontset name or an alias of fontset. In
4322 such a case, use the base fontset name. */
4323 tmp
= Fquery_fontset (value
, Qnil
);
4327 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4328 signal_error ("Invalid font or fontset name", value
);
4333 #endif /* HAVE_WINDOW_SYSTEM */
4335 else if (EQ (attr
, QCinherit
))
4338 if (SYMBOLP (value
))
4341 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4342 if (!SYMBOLP (XCAR (tail
)))
4345 LFACE_INHERIT (lface
) = value
;
4347 signal_error ("Invalid face inheritance", value
);
4349 else if (EQ (attr
, QCbold
))
4351 old_value
= LFACE_WEIGHT (lface
);
4352 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4353 font_related_attr_p
= 1;
4355 else if (EQ (attr
, QCitalic
))
4357 old_value
= LFACE_SLANT (lface
);
4358 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4359 font_related_attr_p
= 1;
4362 signal_error ("Invalid face attribute name", attr
);
4364 if (font_related_attr_p
4365 && !UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4366 /* If a font-related attribute other than QCfont is specified, the
4367 original `font' attribute nor that of default face is useless
4368 to determine a new font. Thus, we set it to nil so that font
4369 selection mechanism doesn't use it. */
4370 LFACE_FONT (lface
) = Qnil
;
4372 /* Changing a named face means that all realized faces depending on
4373 that face are invalid. Since we cannot tell which realized faces
4374 depend on the face, make sure they are all removed. This is done
4375 by incrementing face_change_count. The next call to
4376 init_iterator will then free realized faces. */
4378 && NILP (Fget (face
, Qface_no_inherit
))
4379 && (EQ (attr
, QCfont
)
4380 || NILP (Fequal (old_value
, value
))))
4382 ++face_change_count
;
4383 ++windows_or_buffers_changed
;
4386 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4387 && NILP (Fequal (old_value
, value
)))
4393 if (EQ (face
, Qdefault
))
4395 #ifdef HAVE_WINDOW_SYSTEM
4396 /* Changed font-related attributes of the `default' face are
4397 reflected in changed `font' frame parameters. */
4399 && (font_related_attr_p
|| font_attr_p
)
4400 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4401 set_font_frame_param (frame
, lface
);
4403 #endif /* HAVE_WINDOW_SYSTEM */
4405 if (EQ (attr
, QCforeground
))
4406 param
= Qforeground_color
;
4407 else if (EQ (attr
, QCbackground
))
4408 param
= Qbackground_color
;
4410 #ifdef HAVE_WINDOW_SYSTEM
4412 else if (EQ (face
, Qscroll_bar
))
4414 /* Changing the colors of `scroll-bar' sets frame parameters
4415 `scroll-bar-foreground' and `scroll-bar-background'. */
4416 if (EQ (attr
, QCforeground
))
4417 param
= Qscroll_bar_foreground
;
4418 else if (EQ (attr
, QCbackground
))
4419 param
= Qscroll_bar_background
;
4421 #endif /* not WINDOWSNT */
4422 else if (EQ (face
, Qborder
))
4424 /* Changing background color of `border' sets frame parameter
4426 if (EQ (attr
, QCbackground
))
4427 param
= Qborder_color
;
4429 else if (EQ (face
, Qcursor
))
4431 /* Changing background color of `cursor' sets frame parameter
4433 if (EQ (attr
, QCbackground
))
4434 param
= Qcursor_color
;
4436 else if (EQ (face
, Qmouse
))
4438 /* Changing background color of `mouse' sets frame parameter
4440 if (EQ (attr
, QCbackground
))
4441 param
= Qmouse_color
;
4443 #endif /* HAVE_WINDOW_SYSTEM */
4444 else if (EQ (face
, Qmenu
))
4446 /* Indicate that we have to update the menu bar when
4447 realizing faces on FRAME. FRAME t change the
4448 default for new frames. We do this by setting
4449 setting the flag in new face caches */
4452 struct frame
*f
= XFRAME (frame
);
4453 if (FRAME_FACE_CACHE (f
) == NULL
)
4454 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4455 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4458 menu_face_changed_default
= 1;
4464 /* Update `default-frame-alist', which is used for new frames. */
4466 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4469 /* Update the current frame's parameters. */
4472 cons
= XCAR (Vparam_value_alist
);
4473 XSETCAR (cons
, param
);
4474 XSETCDR (cons
, value
);
4475 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4484 #ifdef HAVE_WINDOW_SYSTEM
4486 /* Set the `font' frame parameter of FRAME determined from `default'
4487 face attributes LFACE. If a face or fontset name is explicitely
4488 specfied in LFACE, use it as is. Otherwise, determine a font name
4489 from the other font-related atrributes of LFACE. In that case, if
4490 there's no matching font, signals an error. */
4493 set_font_frame_param (frame
, lface
)
4494 Lisp_Object frame
, lface
;
4496 struct frame
*f
= XFRAME (frame
);
4498 if (FRAME_WINDOW_P (f
))
4500 Lisp_Object font_name
;
4503 if (STRINGP (LFACE_FONT (lface
)))
4504 font_name
= LFACE_FONT (lface
);
4507 /* Choose a font name that reflects LFACE's attributes and has
4508 the registry and encoding pattern specified in the default
4509 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4510 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4512 error ("No font matches the specified attribute");
4513 font_name
= build_string (font
);
4517 f
->default_face_done_p
= 0;
4518 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4523 /* Update the corresponding face when frame parameter PARAM on frame F
4524 has been assigned the value NEW_VALUE. */
4527 update_face_from_frame_parameter (f
, param
, new_value
)
4529 Lisp_Object param
, new_value
;
4531 Lisp_Object face
= Qnil
;
4534 /* If there are no faces yet, give up. This is the case when called
4535 from Fx_create_frame, and we do the necessary things later in
4536 face-set-after-frame-defaults. */
4537 if (NILP (f
->face_alist
))
4540 if (EQ (param
, Qforeground_color
))
4543 lface
= lface_from_face_name (f
, face
, 1);
4544 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4545 ? new_value
: Qunspecified
);
4546 realize_basic_faces (f
);
4548 else if (EQ (param
, Qbackground_color
))
4552 /* Changing the background color might change the background
4553 mode, so that we have to load new defface specs.
4554 Call frame-set-background-mode to do that. */
4555 XSETFRAME (frame
, f
);
4556 call1 (Qframe_set_background_mode
, frame
);
4559 lface
= lface_from_face_name (f
, face
, 1);
4560 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4561 ? new_value
: Qunspecified
);
4562 realize_basic_faces (f
);
4564 else if (EQ (param
, Qborder_color
))
4567 lface
= lface_from_face_name (f
, face
, 1);
4568 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4569 ? new_value
: Qunspecified
);
4571 else if (EQ (param
, Qcursor_color
))
4574 lface
= lface_from_face_name (f
, face
, 1);
4575 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4576 ? new_value
: Qunspecified
);
4578 else if (EQ (param
, Qmouse_color
))
4581 lface
= lface_from_face_name (f
, face
, 1);
4582 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4583 ? new_value
: Qunspecified
);
4586 /* Changing a named face means that all realized faces depending on
4587 that face are invalid. Since we cannot tell which realized faces
4588 depend on the face, make sure they are all removed. This is done
4589 by incrementing face_change_count. The next call to
4590 init_iterator will then free realized faces. */
4592 && NILP (Fget (face
, Qface_no_inherit
)))
4594 ++face_change_count
;
4595 ++windows_or_buffers_changed
;
4600 /* Get the value of X resource RESOURCE, class CLASS for the display
4601 of frame FRAME. This is here because ordinary `x-get-resource'
4602 doesn't take a frame argument. */
4604 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4605 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4606 (resource
, class, frame
)
4607 Lisp_Object resource
, class, frame
;
4609 Lisp_Object value
= Qnil
;
4610 CHECK_STRING (resource
);
4611 CHECK_STRING (class);
4612 CHECK_LIVE_FRAME (frame
);
4614 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4615 resource
, class, Qnil
, Qnil
);
4621 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4622 If VALUE is "on" or "true", return t. If VALUE is "off" or
4623 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4624 error; if SIGNAL_P is zero, return 0. */
4627 face_boolean_x_resource_value (value
, signal_p
)
4631 Lisp_Object result
= make_number (0);
4633 xassert (STRINGP (value
));
4635 if (xstricmp (SDATA (value
), "on") == 0
4636 || xstricmp (SDATA (value
), "true") == 0)
4638 else if (xstricmp (SDATA (value
), "off") == 0
4639 || xstricmp (SDATA (value
), "false") == 0)
4641 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4642 result
= Qunspecified
;
4644 signal_error ("Invalid face attribute value from X resource", value
);
4650 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4651 Finternal_set_lisp_face_attribute_from_resource
,
4652 Sinternal_set_lisp_face_attribute_from_resource
,
4653 3, 4, 0, doc
: /* */)
4654 (face
, attr
, value
, frame
)
4655 Lisp_Object face
, attr
, value
, frame
;
4657 CHECK_SYMBOL (face
);
4658 CHECK_SYMBOL (attr
);
4659 CHECK_STRING (value
);
4661 if (xstricmp (SDATA (value
), "unspecified") == 0)
4662 value
= Qunspecified
;
4663 else if (EQ (attr
, QCheight
))
4665 value
= Fstring_to_number (value
, make_number (10));
4666 if (XINT (value
) <= 0)
4667 signal_error ("Invalid face height from X resource", value
);
4669 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4670 value
= face_boolean_x_resource_value (value
, 1);
4671 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4672 value
= intern (SDATA (value
));
4673 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4674 value
= face_boolean_x_resource_value (value
, 1);
4675 else if (EQ (attr
, QCunderline
)
4676 || EQ (attr
, QCoverline
)
4677 || EQ (attr
, QCstrike_through
))
4679 Lisp_Object boolean_value
;
4681 /* If the result of face_boolean_x_resource_value is t or nil,
4682 VALUE does NOT specify a color. */
4683 boolean_value
= face_boolean_x_resource_value (value
, 0);
4684 if (SYMBOLP (boolean_value
))
4685 value
= boolean_value
;
4687 else if (EQ (attr
, QCbox
) || EQ (attr
, QCinherit
))
4688 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4690 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4693 #endif /* HAVE_WINDOW_SYSTEM */
4696 /***********************************************************************
4698 ***********************************************************************/
4700 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4702 /* Make menus on frame F appear as specified by the `menu' face. */
4705 x_update_menu_appearance (f
)
4708 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4712 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4716 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4717 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4718 const char *myname
= SDATA (Vx_resource_name
);
4721 const char *popup_path
= "popup_menu";
4723 const char *popup_path
= "menu.popup";
4726 if (STRINGP (LFACE_FOREGROUND (lface
)))
4728 sprintf (line
, "%s.%s*foreground: %s",
4730 SDATA (LFACE_FOREGROUND (lface
)));
4731 XrmPutLineResource (&rdb
, line
);
4732 sprintf (line
, "%s.pane.menubar*foreground: %s",
4733 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4734 XrmPutLineResource (&rdb
, line
);
4738 if (STRINGP (LFACE_BACKGROUND (lface
)))
4740 sprintf (line
, "%s.%s*background: %s",
4742 SDATA (LFACE_BACKGROUND (lface
)));
4743 XrmPutLineResource (&rdb
, line
);
4744 sprintf (line
, "%s.pane.menubar*background: %s",
4745 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4746 XrmPutLineResource (&rdb
, line
);
4751 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4752 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4753 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4754 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4755 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4756 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4759 const char *suffix
= "List";
4762 #if defined HAVE_X_I18N
4764 const char *suffix
= "Set";
4766 const char *suffix
= "";
4770 #if defined HAVE_X_I18N
4771 extern char *xic_create_fontsetname
4772 P_ ((char *base_fontname
, Bool motif
));
4773 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
4775 char *fontsetname
= face
->font_name
;
4777 sprintf (line
, "%s.pane.menubar*font%s: %s",
4778 myname
, suffix
, fontsetname
);
4779 XrmPutLineResource (&rdb
, line
);
4780 sprintf (line
, "%s.%s*font%s: %s",
4781 myname
, popup_path
, suffix
, fontsetname
);
4782 XrmPutLineResource (&rdb
, line
);
4784 if (fontsetname
!= face
->font_name
)
4785 xfree (fontsetname
);
4788 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4789 free_frame_menubar (f
);
4793 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4796 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4797 Sface_attribute_relative_p
,
4799 doc
: /* Check whether a face attribute value is relative.
4800 Specifically, this function returns t if the attribute ATTRIBUTE
4801 with the value VALUE is relative.
4803 A relative value is one that doesn't entirely override whatever is
4804 inherited from another face. For most possible attributes,
4805 the only relative value that users see is `unspecified'.
4806 However, for :height, floating point values are also relative. */)
4808 Lisp_Object attribute
, value
;
4810 if (EQ (value
, Qunspecified
) || (EQ (value
, Qignore_defface
)))
4812 else if (EQ (attribute
, QCheight
))
4813 return INTEGERP (value
) ? Qnil
: Qt
;
4818 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4820 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4821 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4822 the result will be absolute, otherwise it will be relative. */)
4823 (attribute
, value1
, value2
)
4824 Lisp_Object attribute
, value1
, value2
;
4826 if (EQ (value1
, Qunspecified
) || EQ (value1
, Qignore_defface
))
4828 else if (EQ (attribute
, QCheight
))
4829 return merge_face_heights (value1
, value2
, value1
);
4835 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4836 Sinternal_get_lisp_face_attribute
,
4838 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4839 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4840 face attribute name, signal an error.
4841 If the optional argument FRAME is given, report on face SYMBOL in that
4842 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4843 frames). If FRAME is omitted or nil, use the selected frame. */)
4844 (symbol
, keyword
, frame
)
4845 Lisp_Object symbol
, keyword
, frame
;
4847 Lisp_Object lface
, value
= Qnil
;
4849 CHECK_SYMBOL (symbol
);
4850 CHECK_SYMBOL (keyword
);
4853 lface
= lface_from_face_name (NULL
, symbol
, 1);
4857 frame
= selected_frame
;
4858 CHECK_LIVE_FRAME (frame
);
4859 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4862 if (EQ (keyword
, QCfamily
))
4863 value
= LFACE_FAMILY (lface
);
4864 else if (EQ (keyword
, QCheight
))
4865 value
= LFACE_HEIGHT (lface
);
4866 else if (EQ (keyword
, QCweight
))
4867 value
= LFACE_WEIGHT (lface
);
4868 else if (EQ (keyword
, QCslant
))
4869 value
= LFACE_SLANT (lface
);
4870 else if (EQ (keyword
, QCunderline
))
4871 value
= LFACE_UNDERLINE (lface
);
4872 else if (EQ (keyword
, QCoverline
))
4873 value
= LFACE_OVERLINE (lface
);
4874 else if (EQ (keyword
, QCstrike_through
))
4875 value
= LFACE_STRIKE_THROUGH (lface
);
4876 else if (EQ (keyword
, QCbox
))
4877 value
= LFACE_BOX (lface
);
4878 else if (EQ (keyword
, QCinverse_video
)
4879 || EQ (keyword
, QCreverse_video
))
4880 value
= LFACE_INVERSE (lface
);
4881 else if (EQ (keyword
, QCforeground
))
4882 value
= LFACE_FOREGROUND (lface
);
4883 else if (EQ (keyword
, QCbackground
))
4884 value
= LFACE_BACKGROUND (lface
);
4885 else if (EQ (keyword
, QCstipple
))
4886 value
= LFACE_STIPPLE (lface
);
4887 else if (EQ (keyword
, QCwidth
))
4888 value
= LFACE_SWIDTH (lface
);
4889 else if (EQ (keyword
, QCinherit
))
4890 value
= LFACE_INHERIT (lface
);
4891 else if (EQ (keyword
, QCfont
))
4892 value
= LFACE_FONT (lface
);
4894 signal_error ("Invalid face attribute name", keyword
);
4896 if (IGNORE_DEFFACE_P (value
))
4897 return Qunspecified
;
4903 DEFUN ("internal-lisp-face-attribute-values",
4904 Finternal_lisp_face_attribute_values
,
4905 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4906 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4907 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4911 Lisp_Object result
= Qnil
;
4913 CHECK_SYMBOL (attr
);
4915 if (EQ (attr
, QCweight
)
4916 || EQ (attr
, QCslant
)
4917 || EQ (attr
, QCwidth
))
4919 /* Extract permissible symbols from tables. */
4920 struct table_entry
*table
;
4923 if (EQ (attr
, QCweight
))
4924 table
= weight_table
, dim
= DIM (weight_table
);
4925 else if (EQ (attr
, QCslant
))
4926 table
= slant_table
, dim
= DIM (slant_table
);
4928 table
= swidth_table
, dim
= DIM (swidth_table
);
4930 for (i
= 0; i
< dim
; ++i
)
4932 Lisp_Object symbol
= *table
[i
].symbol
;
4933 Lisp_Object tail
= result
;
4936 && !EQ (XCAR (tail
), symbol
))
4940 result
= Fcons (symbol
, result
);
4943 else if (EQ (attr
, QCunderline
))
4944 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4945 else if (EQ (attr
, QCoverline
))
4946 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4947 else if (EQ (attr
, QCstrike_through
))
4948 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4949 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4950 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4956 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4957 Sinternal_merge_in_global_face
, 2, 2, 0,
4958 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4959 Default face attributes override any local face attributes. */)
4961 Lisp_Object face
, frame
;
4964 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4966 CHECK_LIVE_FRAME (frame
);
4967 global_lface
= lface_from_face_name (NULL
, face
, 1);
4968 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4969 if (NILP (local_lface
))
4970 local_lface
= Finternal_make_lisp_face (face
, frame
);
4972 /* Make every specified global attribute override the local one.
4973 BEWARE!! This is only used from `face-set-after-frame-default' where
4974 the local frame is defined from default specs in `face-defface-spec'
4975 and those should be overridden by global settings. Hence the strange
4976 "global before local" priority. */
4977 lvec
= XVECTOR (local_lface
)->contents
;
4978 gvec
= XVECTOR (global_lface
)->contents
;
4979 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4980 if (! UNSPECIFIEDP (gvec
[i
]))
4982 if (IGNORE_DEFFACE_P (gvec
[i
]))
4983 lvec
[i
] = Qunspecified
;
4992 /* The following function is implemented for compatibility with 20.2.
4993 The function is used in x-resolve-fonts when it is asked to
4994 return fonts with the same size as the font of a face. This is
4995 done in fontset.el. */
4997 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4998 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4999 If the optional argument FRAME is given, report on face FACE in that frame.
5000 If FRAME is t, report on the defaults for face FACE (for new frames).
5001 The font default for a face is either nil, or a list
5002 of the form (bold), (italic) or (bold italic).
5003 If FRAME is omitted or nil, use the selected frame. */)
5005 Lisp_Object face
, frame
;
5009 Lisp_Object result
= Qnil
;
5010 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
5012 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
5013 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
5014 result
= Fcons (Qbold
, result
);
5016 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
5017 && !EQ (LFACE_SLANT (lface
), Qnormal
))
5018 result
= Fcons (Qitalic
, result
);
5024 struct frame
*f
= frame_or_selected_frame (frame
, 1);
5025 int face_id
= lookup_named_face (f
, face
, 0, 1);
5026 struct face
*face
= FACE_FROM_ID (f
, face_id
);
5027 return face
? build_string (face
->font_name
) : Qnil
;
5032 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
5033 all attributes are `equal'. Tries to be fast because this function
5034 is called quite often. */
5037 face_attr_equal_p (v1
, v2
)
5040 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5041 and the other is specified. */
5042 if (XTYPE (v1
) != XTYPE (v2
))
5051 if (SBYTES (v1
) != SBYTES (v2
))
5054 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5061 return !NILP (Fequal (v1
, v2
));
5066 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5067 all attributes are `equal'. Tries to be fast because this function
5068 is called quite often. */
5071 lface_equal_p (v1
, v2
)
5072 Lisp_Object
*v1
, *v2
;
5076 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5077 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5083 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5084 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5085 doc
: /* True if FACE1 and FACE2 are equal.
5086 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
5087 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
5088 If FRAME is omitted or nil, use the selected frame. */)
5089 (face1
, face2
, frame
)
5090 Lisp_Object face1
, face2
, frame
;
5094 Lisp_Object lface1
, lface2
;
5099 /* Don't use check_x_frame here because this function is called
5100 before X frames exist. At that time, if FRAME is nil,
5101 selected_frame will be used which is the frame dumped with
5102 Emacs. That frame is not an X frame. */
5103 f
= frame_or_selected_frame (frame
, 2);
5105 lface1
= lface_from_face_name (f
, face1
, 1);
5106 lface2
= lface_from_face_name (f
, face2
, 1);
5107 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5108 XVECTOR (lface2
)->contents
);
5109 return equal_p
? Qt
: Qnil
;
5113 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5114 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5115 doc
: /* True if FACE has no attribute specified.
5116 If the optional argument FRAME is given, report on face FACE in that frame.
5117 If FRAME is t, report on the defaults for face FACE (for new frames).
5118 If FRAME is omitted or nil, use the selected frame. */)
5120 Lisp_Object face
, frame
;
5127 frame
= selected_frame
;
5128 CHECK_LIVE_FRAME (frame
);
5132 lface
= lface_from_face_name (NULL
, face
, 1);
5134 lface
= lface_from_face_name (f
, face
, 1);
5136 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5137 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5140 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5144 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5146 doc
: /* Return an alist of frame-local faces defined on FRAME.
5147 For internal use only. */)
5151 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5152 return f
->face_alist
;
5156 /* Return a hash code for Lisp string STRING with case ignored. Used
5157 below in computing a hash value for a Lisp face. */
5159 static INLINE
unsigned
5160 hash_string_case_insensitive (string
)
5163 const unsigned char *s
;
5165 xassert (STRINGP (string
));
5166 for (s
= SDATA (string
); *s
; ++s
)
5167 hash
= (hash
<< 1) ^ tolower (*s
);
5172 /* Return a hash code for face attribute vector V. */
5174 static INLINE
unsigned
5178 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5179 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5180 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5181 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5182 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5183 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5184 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5188 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5189 considering charsets/registries). They do if they specify the same
5190 family, point size, weight, width, slant, and fontset. Both LFACE1
5191 and LFACE2 must be fully-specified. */
5194 lface_same_font_attributes_p (lface1
, lface2
)
5195 Lisp_Object
*lface1
, *lface2
;
5197 xassert (lface_fully_specified_p (lface1
)
5198 && lface_fully_specified_p (lface2
));
5199 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5200 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5201 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5202 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5203 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5204 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5205 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5206 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5207 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5208 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5209 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5210 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5215 /***********************************************************************
5217 ***********************************************************************/
5219 /* Allocate and return a new realized face for Lisp face attribute
5222 static struct face
*
5223 make_realized_face (attr
)
5226 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5227 bzero (face
, sizeof *face
);
5228 face
->ascii_face
= face
;
5229 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5234 /* Free realized face FACE, including its X resources. FACE may
5238 free_realized_face (f
, face
)
5244 #ifdef HAVE_WINDOW_SYSTEM
5245 if (FRAME_WINDOW_P (f
))
5247 /* Free fontset of FACE if it is ASCII face. */
5248 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5249 free_face_fontset (f
, face
);
5252 x_free_gc (f
, face
->gc
);
5256 free_face_colors (f
, face
);
5257 x_destroy_bitmap (f
, face
->stipple
);
5259 #endif /* HAVE_WINDOW_SYSTEM */
5266 /* Prepare face FACE for subsequent display on frame F. This
5267 allocated GCs if they haven't been allocated yet or have been freed
5268 by clearing the face cache. */
5271 prepare_face_for_display (f
, face
)
5275 #ifdef HAVE_WINDOW_SYSTEM
5276 xassert (FRAME_WINDOW_P (f
));
5281 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5283 xgcv
.foreground
= face
->foreground
;
5284 xgcv
.background
= face
->background
;
5285 #ifdef HAVE_X_WINDOWS
5286 xgcv
.graphics_exposures
= False
;
5288 /* The font of FACE may be null if we couldn't load it. */
5291 #ifdef HAVE_X_WINDOWS
5292 xgcv
.font
= face
->font
->fid
;
5295 xgcv
.font
= face
->font
;
5298 xgcv
.font
= face
->font
;
5304 #ifdef HAVE_X_WINDOWS
5307 xgcv
.fill_style
= FillOpaqueStippled
;
5308 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5309 mask
|= GCFillStyle
| GCStipple
;
5312 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5315 #endif /* HAVE_WINDOW_SYSTEM */
5319 /* Returns the `distance' between the colors X and Y. */
5322 color_distance (x
, y
)
5325 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5326 Quoting from that paper:
5328 This formula has results that are very close to L*u*v* (with the
5329 modified lightness curve) and, more importantly, it is a more even
5330 algorithm: it does not have a range of colours where it suddenly
5331 gives far from optimal results.
5333 See <http://www.compuphase.com/cmetric.htm> for more info. */
5335 long r
= (x
->red
- y
->red
) >> 8;
5336 long g
= (x
->green
- y
->green
) >> 8;
5337 long b
= (x
->blue
- y
->blue
) >> 8;
5338 long r_mean
= (x
->red
+ y
->red
) >> 9;
5341 (((512 + r_mean
) * r
* r
) >> 8)
5343 + (((767 - r_mean
) * b
* b
) >> 8);
5347 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5348 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5349 COLOR1 and COLOR2 may be either strings containing the color name,
5350 or lists of the form (RED GREEN BLUE).
5351 If FRAME is unspecified or nil, the current frame is used. */)
5352 (color1
, color2
, frame
)
5353 Lisp_Object color1
, color2
, frame
;
5356 XColor cdef1
, cdef2
;
5359 frame
= selected_frame
;
5360 CHECK_LIVE_FRAME (frame
);
5363 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5364 || !STRINGP (color1
)
5365 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5366 signal_error ("Invalid color", color1
);
5367 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5368 || !STRINGP (color2
)
5369 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5370 signal_error ("Invalid color", color2
);
5372 return make_number (color_distance (&cdef1
, &cdef2
));
5376 /***********************************************************************
5378 ***********************************************************************/
5380 /* Return a new face cache for frame F. */
5382 static struct face_cache
*
5386 struct face_cache
*c
;
5389 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5390 bzero (c
, sizeof *c
);
5391 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5392 c
->buckets
= (struct face
**) xmalloc (size
);
5393 bzero (c
->buckets
, size
);
5395 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5397 c
->menu_face_changed_p
= menu_face_changed_default
;
5402 /* Clear out all graphics contexts for all realized faces, except for
5403 the basic faces. This should be done from time to time just to avoid
5404 keeping too many graphics contexts that are no longer needed. */
5408 struct face_cache
*c
;
5410 if (c
&& FRAME_WINDOW_P (c
->f
))
5412 #ifdef HAVE_WINDOW_SYSTEM
5414 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5416 struct face
*face
= c
->faces_by_id
[i
];
5417 if (face
&& face
->gc
)
5419 x_free_gc (c
->f
, face
->gc
);
5423 #endif /* HAVE_WINDOW_SYSTEM */
5428 /* Free all realized faces in face cache C, including basic faces.
5429 C may be null. If faces are freed, make sure the frame's current
5430 matrix is marked invalid, so that a display caused by an expose
5431 event doesn't try to use faces we destroyed. */
5434 free_realized_faces (c
)
5435 struct face_cache
*c
;
5440 struct frame
*f
= c
->f
;
5442 /* We must block input here because we can't process X events
5443 safely while only some faces are freed, or when the frame's
5444 current matrix still references freed faces. */
5447 for (i
= 0; i
< c
->used
; ++i
)
5449 free_realized_face (f
, c
->faces_by_id
[i
]);
5450 c
->faces_by_id
[i
] = NULL
;
5454 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5455 bzero (c
->buckets
, size
);
5457 /* Must do a thorough redisplay the next time. Mark current
5458 matrices as invalid because they will reference faces freed
5459 above. This function is also called when a frame is
5460 destroyed. In this case, the root window of F is nil. */
5461 if (WINDOWP (f
->root_window
))
5463 clear_current_matrices (f
);
5464 ++windows_or_buffers_changed
;
5472 /* Free all faces realized for multibyte characters on frame F that
5476 free_realized_multibyte_face (f
, fontset
)
5480 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5484 /* We must block input here because we can't process X events safely
5485 while only some faces are freed, or when the frame's current
5486 matrix still references freed faces. */
5489 for (i
= 0; i
< cache
->used
; i
++)
5491 face
= cache
->faces_by_id
[i
];
5493 && face
!= face
->ascii_face
5494 && face
->fontset
== fontset
)
5496 uncache_face (cache
, face
);
5497 free_realized_face (f
, face
);
5501 /* Must do a thorough redisplay the next time. Mark current
5502 matrices as invalid because they will reference faces freed
5503 above. This function is also called when a frame is destroyed.
5504 In this case, the root window of F is nil. */
5505 if (WINDOWP (f
->root_window
))
5507 clear_current_matrices (f
);
5508 ++windows_or_buffers_changed
;
5515 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5516 This is done after attributes of a named face have been changed,
5517 because we can't tell which realized faces depend on that face. */
5520 free_all_realized_faces (frame
)
5526 FOR_EACH_FRAME (rest
, frame
)
5527 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5530 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5534 /* Free face cache C and faces in it, including their X resources. */
5538 struct face_cache
*c
;
5542 free_realized_faces (c
);
5544 xfree (c
->faces_by_id
);
5550 /* Cache realized face FACE in face cache C. HASH is the hash value
5551 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5552 collision list of the face hash table of C. This is done because
5553 otherwise lookup_face would find FACE for every character, even if
5554 faces with the same attributes but for specific characters exist. */
5557 cache_face (c
, face
, hash
)
5558 struct face_cache
*c
;
5562 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5566 if (face
->fontset
>= 0)
5568 struct face
*last
= c
->buckets
[i
];
5579 c
->buckets
[i
] = face
;
5580 face
->prev
= face
->next
= NULL
;
5586 face
->next
= c
->buckets
[i
];
5588 face
->next
->prev
= face
;
5589 c
->buckets
[i
] = face
;
5592 /* Find a free slot in C->faces_by_id and use the index of the free
5593 slot as FACE->id. */
5594 for (i
= 0; i
< c
->used
; ++i
)
5595 if (c
->faces_by_id
[i
] == NULL
)
5599 /* Maybe enlarge C->faces_by_id. */
5602 if (c
->used
== c
->size
)
5605 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5606 if (new_size
== c
->size
)
5607 abort (); /* Alternatives? ++kfs */
5608 sz
= new_size
* sizeof *c
->faces_by_id
;
5609 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5616 /* Check that FACE got a unique id. */
5621 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5622 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5628 #endif /* GLYPH_DEBUG */
5630 c
->faces_by_id
[i
] = face
;
5634 /* Remove face FACE from cache C. */
5637 uncache_face (c
, face
)
5638 struct face_cache
*c
;
5641 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5644 face
->prev
->next
= face
->next
;
5646 c
->buckets
[i
] = face
->next
;
5649 face
->next
->prev
= face
->prev
;
5651 c
->faces_by_id
[face
->id
] = NULL
;
5652 if (face
->id
== c
->used
)
5657 /* Look up a realized face with face attributes ATTR in the face cache
5658 of frame F. The face will be used to display character C. Value
5659 is the ID of the face found. If no suitable face is found, realize
5660 a new one. In that case, if C is a multibyte character, BASE_FACE
5661 is a face that has the same attributes. */
5664 lookup_face (f
, attr
, c
, base_face
)
5668 struct face
*base_face
;
5670 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5675 xassert (cache
!= NULL
);
5676 check_lface_attrs (attr
);
5678 /* Look up ATTR in the face cache. */
5679 hash
= lface_hash (attr
);
5680 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5682 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5683 if (face
->hash
== hash
5684 && (!FRAME_WINDOW_P (f
)
5685 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5686 && lface_equal_p (face
->lface
, attr
))
5689 /* If not found, realize a new face. */
5691 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5694 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5696 /* When this function is called from face_for_char (in this case, C is
5697 a multibyte character), a fontset of a face returned by
5698 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5699 C) is not sutisfied. The fontset is set for this face by
5700 face_for_char later. */
5702 if (FRAME_WINDOW_P (f
))
5703 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5705 #endif /* GLYPH_DEBUG */
5711 /* Return the face id of the realized face for named face SYMBOL on
5712 frame F suitable for displaying character C. Value is -1 if the
5713 face couldn't be determined, which might happen if the default face
5714 isn't realized and cannot be realized. */
5717 lookup_named_face (f
, symbol
, c
, signal_p
)
5723 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5724 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5725 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5727 if (default_face
== NULL
)
5729 if (!realize_basic_faces (f
))
5731 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5734 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
5737 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5738 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5740 return lookup_face (f
, attrs
, c
, NULL
);
5744 /* Return the ID of the realized ASCII face of Lisp face with ID
5745 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5748 ascii_face_of_lisp_face (f
, lface_id
)
5754 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5756 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5757 face_id
= lookup_named_face (f
, face_name
, 0, 1);
5766 /* Return a face for charset ASCII that is like the face with id
5767 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5768 STEPS < 0 means larger. Value is the id of the face. */
5771 smaller_face (f
, face_id
, steps
)
5775 #ifdef HAVE_WINDOW_SYSTEM
5777 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5778 int pt
, last_pt
, last_height
;
5781 struct face
*new_face
;
5783 /* If not called for an X frame, just return the original face. */
5784 if (FRAME_TERMCAP_P (f
))
5787 /* Try in increments of 1/2 pt. */
5788 delta
= steps
< 0 ? 5 : -5;
5789 steps
= abs (steps
);
5791 face
= FACE_FROM_ID (f
, face_id
);
5792 bcopy (face
->lface
, attrs
, sizeof attrs
);
5793 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5794 new_face_id
= face_id
;
5795 last_height
= FONT_HEIGHT (face
->font
);
5799 /* Give up if we cannot find a font within 10pt. */
5800 && abs (last_pt
- pt
) < 100)
5802 /* Look up a face for a slightly smaller/larger font. */
5804 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5805 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5806 new_face
= FACE_FROM_ID (f
, new_face_id
);
5808 /* If height changes, count that as one step. */
5809 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5810 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5813 last_height
= FONT_HEIGHT (new_face
->font
);
5820 #else /* not HAVE_WINDOW_SYSTEM */
5824 #endif /* not HAVE_WINDOW_SYSTEM */
5828 /* Return a face for charset ASCII that is like the face with id
5829 FACE_ID on frame F, but has height HEIGHT. */
5832 face_with_height (f
, face_id
, height
)
5837 #ifdef HAVE_WINDOW_SYSTEM
5839 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5841 if (FRAME_TERMCAP_P (f
)
5845 face
= FACE_FROM_ID (f
, face_id
);
5846 bcopy (face
->lface
, attrs
, sizeof attrs
);
5847 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5848 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5849 #endif /* HAVE_WINDOW_SYSTEM */
5855 /* Return the face id of the realized face for named face SYMBOL on
5856 frame F suitable for displaying character C, and use attributes of
5857 the face FACE_ID for attributes that aren't completely specified by
5858 SYMBOL. This is like lookup_named_face, except that the default
5859 attributes come from FACE_ID, not from the default face. FACE_ID
5860 is assumed to be already realized. */
5863 lookup_derived_face (f
, symbol
, c
, face_id
, signal_p
)
5870 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5871 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5872 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5877 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);
5880 return lookup_face (f
, attrs
, c
, default_face
);
5883 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5884 Sface_attributes_as_vector
, 1, 1, 0,
5885 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5890 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5892 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5899 /***********************************************************************
5900 Face capability testing
5901 ***********************************************************************/
5904 /* If the distance (as returned by color_distance) between two colors is
5905 less than this, then they are considered the same, for determining
5906 whether a color is supported or not. The range of values is 0-65535. */
5908 #define TTY_SAME_COLOR_THRESHOLD 10000
5910 #ifdef HAVE_WINDOW_SYSTEM
5912 /* Return non-zero if all the face attributes in ATTRS are supported
5913 on the window-system frame F.
5915 The definition of `supported' is somewhat heuristic, but basically means
5916 that a face containing all the attributes in ATTRS, when merged with the
5917 default face for display, can be represented in a way that's
5919 \(1) different in appearance than the default face, and
5920 \(2) `close in spirit' to what the attributes specify, if not exact. */
5923 x_supports_face_attributes_p (f
, attrs
, def_face
)
5926 struct face
*def_face
;
5928 Lisp_Object
*def_attrs
= def_face
->lface
;
5930 /* Check that other specified attributes are different that the default
5932 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5933 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5934 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5935 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5936 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5937 def_attrs
[LFACE_INVERSE_INDEX
]))
5938 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5939 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5940 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5941 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5942 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5943 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5944 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5945 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5946 def_attrs
[LFACE_STIPPLE_INDEX
]))
5947 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5948 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5949 def_attrs
[LFACE_OVERLINE_INDEX
]))
5950 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5951 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5952 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5953 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5954 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5955 def_attrs
[LFACE_BOX_INDEX
])))
5958 /* Check font-related attributes, as those are the most commonly
5959 "unsupported" on a window-system (because of missing fonts). */
5960 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5961 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5962 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5963 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5964 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5965 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5968 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5970 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5972 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5974 face
= FACE_FROM_ID (f
, lookup_face (f
, merged_attrs
, 0, 0));
5977 error ("Cannot make face");
5979 /* If the font is the same, then not supported. */
5980 if (face
->font
== def_face
->font
)
5984 /* Everything checks out, this face is supported. */
5988 #endif /* HAVE_WINDOW_SYSTEM */
5990 /* Return non-zero if all the face attributes in ATTRS are supported
5993 The definition of `supported' is somewhat heuristic, but basically means
5994 that a face containing all the attributes in ATTRS, when merged
5995 with the default face for display, can be represented in a way that's
5997 \(1) different in appearance than the default face, and
5998 \(2) `close in spirit' to what the attributes specify, if not exact.
6000 Point (2) implies that a `:weight black' attribute will be satisfied
6001 by any terminal that can display bold, and a `:foreground "yellow"' as
6002 long as the terminal can display a yellowish color, but `:slant italic'
6003 will _not_ be satisfied by the tty display code's automatic
6004 substitution of a `dim' face for italic. */
6007 tty_supports_face_attributes_p (f
, attrs
, def_face
)
6010 struct face
*def_face
;
6013 Lisp_Object val
, fg
, bg
;
6014 XColor fg_tty_color
, fg_std_color
;
6015 XColor bg_tty_color
, bg_std_color
;
6016 unsigned test_caps
= 0;
6017 Lisp_Object
*def_attrs
= def_face
->lface
;
6020 /* First check some easy-to-check stuff; ttys support none of the
6021 following attributes, so we can just return false if any are requested
6022 (even if `nominal' values are specified, we should still return false,
6023 as that will be the same value that the default face uses). We
6024 consider :slant unsupportable on ttys, even though the face code
6025 actually `fakes' them using a dim attribute if possible. This is
6026 because the faked result is too different from what the face
6028 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6029 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6030 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6031 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6032 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6033 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6034 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6035 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
6039 /* Test for terminal `capabilities' (non-color character attributes). */
6041 /* font weight (bold/dim) */
6042 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6045 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6047 if (weight
> XLFD_WEIGHT_MEDIUM
)
6049 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6050 return 0; /* same as default */
6051 test_caps
= TTY_CAP_BOLD
;
6053 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6055 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6056 return 0; /* same as default */
6057 test_caps
= TTY_CAP_DIM
;
6059 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6060 return 0; /* same as default */
6064 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6065 if (!UNSPECIFIEDP (val
))
6068 return 0; /* ttys can't use colored underlines */
6069 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6070 return 0; /* same as default */
6072 test_caps
|= TTY_CAP_UNDERLINE
;
6076 val
= attrs
[LFACE_INVERSE_INDEX
];
6077 if (!UNSPECIFIEDP (val
))
6079 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6080 return 0; /* same as default */
6082 test_caps
|= TTY_CAP_INVERSE
;
6086 /* Color testing. */
6088 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6089 we use them when calling `tty_capable_p' below, even if the face
6090 specifies no colors. */
6091 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6092 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6094 /* Check if foreground color is close enough. */
6095 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6098 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6100 if (face_attr_equal_p (fg
, def_fg
))
6101 return 0; /* same as default */
6102 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6103 return 0; /* not a valid color */
6104 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6105 > TTY_SAME_COLOR_THRESHOLD
)
6106 return 0; /* displayed color is too different */
6108 /* Make sure the color is really different than the default. */
6110 XColor def_fg_color
;
6111 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6112 && (color_distance (&fg_tty_color
, &def_fg_color
)
6113 <= TTY_SAME_COLOR_THRESHOLD
))
6118 /* Check if background color is close enough. */
6119 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6122 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6124 if (face_attr_equal_p (bg
, def_bg
))
6125 return 0; /* same as default */
6126 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6127 return 0; /* not a valid color */
6128 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6129 > TTY_SAME_COLOR_THRESHOLD
)
6130 return 0; /* displayed color is too different */
6132 /* Make sure the color is really different than the default. */
6134 XColor def_bg_color
;
6135 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6136 && (color_distance (&bg_tty_color
, &def_bg_color
)
6137 <= TTY_SAME_COLOR_THRESHOLD
))
6142 /* If both foreground and background are requested, see if the
6143 distance between them is OK. We just check to see if the distance
6144 between the tty's foreground and background is close enough to the
6145 distance between the standard foreground and background. */
6146 if (STRINGP (fg
) && STRINGP (bg
))
6149 = (color_distance (&fg_std_color
, &bg_std_color
)
6150 - color_distance (&fg_tty_color
, &bg_tty_color
));
6151 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6152 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6157 /* See if the capabilities we selected above are supported, with the
6159 if (test_caps
!= 0 &&
6160 ! tty_capable_p (f
, test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6164 /* Hmmm, everything checks out, this terminal must support this face. */
6169 DEFUN ("display-supports-face-attributes-p",
6170 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6172 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6173 The optional argument DISPLAY can be a display name, a frame, or
6174 nil (meaning the selected frame's display).
6176 The definition of `supported' is somewhat heuristic, but basically means
6177 that a face containing all the attributes in ATTRIBUTES, when merged
6178 with the default face for display, can be represented in a way that's
6180 \(1) different in appearance than the default face, and
6181 \(2) `close in spirit' to what the attributes specify, if not exact.
6183 Point (2) implies that a `:weight black' attribute will be satisfied by
6184 any display that can display bold, and a `:foreground \"yellow\"' as long
6185 as it can display a yellowish color, but `:slant italic' will _not_ be
6186 satisfied by the tty display code's automatic substitution of a `dim'
6187 face for italic. */)
6188 (attributes
, display
)
6189 Lisp_Object attributes
, display
;
6194 struct face
*def_face
;
6195 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6197 if (noninteractive
|| !initialized
)
6198 /* We may not be able to access low-level face information in batch
6199 mode, or before being dumped, and this function is not going to
6200 be very useful in those cases anyway, so just give up. */
6204 frame
= selected_frame
;
6205 else if (FRAMEP (display
))
6209 /* Find any frame on DISPLAY. */
6210 Lisp_Object fl_tail
;
6213 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6215 frame
= XCAR (fl_tail
);
6216 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6217 XFRAME (frame
)->param_alist
)),
6223 CHECK_LIVE_FRAME (frame
);
6226 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6227 attrs
[i
] = Qunspecified
;
6228 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6230 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6231 if (def_face
== NULL
)
6233 if (! realize_basic_faces (f
))
6234 error ("Cannot realize default face");
6235 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6238 /* Dispatch to the appropriate handler. */
6239 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6240 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6241 #ifdef HAVE_WINDOW_SYSTEM
6243 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6246 return supports
? Qt
: Qnil
;
6250 /***********************************************************************
6252 ***********************************************************************/
6254 DEFUN ("internal-set-font-selection-order",
6255 Finternal_set_font_selection_order
,
6256 Sinternal_set_font_selection_order
, 1, 1, 0,
6257 doc
: /* Set font selection order for face font selection to ORDER.
6258 ORDER must be a list of length 4 containing the symbols `:width',
6259 `:height', `:weight', and `:slant'. Face attributes appearing
6260 first in ORDER are matched first, e.g. if `:height' appears before
6261 `:weight' in ORDER, font selection first tries to find a font with
6262 a suitable height, and then tries to match the font weight.
6269 int indices
[DIM (font_sort_order
)];
6272 bzero (indices
, sizeof indices
);
6276 CONSP (list
) && i
< DIM (indices
);
6277 list
= XCDR (list
), ++i
)
6279 Lisp_Object attr
= XCAR (list
);
6282 if (EQ (attr
, QCwidth
))
6284 else if (EQ (attr
, QCheight
))
6285 xlfd
= XLFD_POINT_SIZE
;
6286 else if (EQ (attr
, QCweight
))
6288 else if (EQ (attr
, QCslant
))
6293 if (indices
[i
] != 0)
6298 if (!NILP (list
) || i
!= DIM (indices
))
6299 signal_error ("Invalid font sort order", order
);
6300 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6301 if (indices
[i
] == 0)
6302 signal_error ("Invalid font sort order", order
);
6304 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6306 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6307 free_all_realized_faces (Qnil
);
6314 DEFUN ("internal-set-alternative-font-family-alist",
6315 Finternal_set_alternative_font_family_alist
,
6316 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6317 doc
: /* Define alternative font families to try in face font selection.
6318 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6319 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6320 be found. Value is ALIST. */)
6325 Vface_alternative_font_family_alist
= alist
;
6326 free_all_realized_faces (Qnil
);
6331 DEFUN ("internal-set-alternative-font-registry-alist",
6332 Finternal_set_alternative_font_registry_alist
,
6333 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6334 doc
: /* Define alternative font registries to try in face font selection.
6335 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6336 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6337 be found. Value is ALIST. */)
6342 Vface_alternative_font_registry_alist
= alist
;
6343 free_all_realized_faces (Qnil
);
6348 #ifdef HAVE_WINDOW_SYSTEM
6350 /* Value is non-zero if FONT is the name of a scalable font. The
6351 X11R6 XLFD spec says that point size, pixel size, and average width
6352 are zero for scalable fonts. Intlfonts contain at least one
6353 scalable font ("*-muleindian-1") for which this isn't true, so we
6354 just test average width. */
6357 font_scalable_p (font
)
6358 struct font_name
*font
;
6360 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6361 return (*s
== '0' && *(s
+ 1) == '\0')
6363 /* Windows implementation of XLFD is slightly broken for backward
6364 compatibility with previous broken versions, so test for
6365 wildcards as well as 0. */
6372 /* Ignore the difference of font point size less than this value. */
6374 #define FONT_POINT_SIZE_QUANTUM 5
6376 /* Value is non-zero if FONT1 is a better match for font attributes
6377 VALUES than FONT2. VALUES is an array of face attribute values in
6378 font sort order. COMPARE_PT_P zero means don't compare point
6379 sizes. AVGWIDTH, if not zero, is a specified font average width
6383 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6385 struct font_name
*font1
, *font2
;
6386 int compare_pt_p
, avgwidth
;
6390 /* Any font is better than no font. */
6396 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6398 int xlfd_idx
= font_sort_order
[i
];
6400 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6404 if (xlfd_idx
== XLFD_POINT_SIZE
)
6406 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6407 / font1
->rescale_ratio
));
6408 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6409 / font2
->rescale_ratio
));
6410 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6415 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6416 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6419 if (delta1
> delta2
)
6421 else if (delta1
< delta2
)
6425 /* The difference may be equal because, e.g., the face
6426 specifies `italic' but we have only `regular' and
6427 `oblique'. Prefer `oblique' in this case. */
6428 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6429 && font1
->numeric
[xlfd_idx
] > values
[i
]
6430 && font2
->numeric
[xlfd_idx
] < values
[i
])
6438 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6439 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6440 if (delta1
> delta2
)
6442 else if (delta1
< delta2
)
6448 /* We prefer a real scalable font; i.e. not what autoscaled. */
6449 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6450 && font1
->numeric
[XLFD_RESY
] > 0);
6451 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6452 && font2
->numeric
[XLFD_RESY
] > 0);
6454 if (auto_scaled_1
!= auto_scaled_2
)
6455 return auto_scaled_2
;
6458 return font1
->registry_priority
< font2
->registry_priority
;
6462 /* Value is non-zero if FONT is an exact match for face attributes in
6463 SPECIFIED. SPECIFIED is an array of face attribute values in font
6464 sort order. AVGWIDTH, if non-zero, is an average width to compare
6468 exact_face_match_p (specified
, font
, avgwidth
)
6470 struct font_name
*font
;
6475 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6476 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6479 return (i
== DIM (font_sort_order
)
6481 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6485 /* Value is the name of a scaled font, generated from scalable font
6486 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6487 Value is allocated from heap. */
6490 build_scalable_font_name (f
, font
, specified_pt
)
6492 struct font_name
*font
;
6495 char pixel_size
[20];
6497 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6500 /* If scalable font is for a specific resolution, compute
6501 the point size we must specify from the resolution of
6502 the display and the specified resolution of the font. */
6503 if (font
->numeric
[XLFD_RESY
] != 0)
6505 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6506 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6511 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6513 /* We may need a font of the different size. */
6514 pixel_value
*= font
->rescale_ratio
;
6516 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6517 font of the specified PIXEL_SIZE. */
6519 { /* Set point size of the font. */
6520 char point_size
[20];
6521 sprintf (point_size
, "%d", (int) pt
);
6522 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6523 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6527 /* Set pixel size. */
6528 sprintf (pixel_size
, "%d", pixel_value
);
6529 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6530 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6532 /* If font doesn't specify its resolution, use the
6533 resolution of the display. */
6534 if (font
->numeric
[XLFD_RESY
] == 0)
6537 sprintf (buffer
, "%d", (int) resy
);
6538 font
->fields
[XLFD_RESY
] = buffer
;
6539 font
->numeric
[XLFD_RESY
] = resy
;
6542 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6545 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6546 sprintf (buffer
, "%d", resx
);
6547 font
->fields
[XLFD_RESX
] = buffer
;
6548 font
->numeric
[XLFD_RESX
] = resx
;
6551 return build_font_name (font
);
6555 /* Value is non-zero if we are allowed to use scalable font FONT. We
6556 can't run a Lisp function here since this function may be called
6557 with input blocked. */
6560 may_use_scalable_font_p (font
)
6563 if (EQ (Vscalable_fonts_allowed
, Qt
))
6565 else if (CONSP (Vscalable_fonts_allowed
))
6567 Lisp_Object tail
, regexp
;
6569 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6571 regexp
= XCAR (tail
);
6572 if (STRINGP (regexp
)
6573 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6583 /* Return the name of the best matching font for face attributes ATTRS
6584 in the array of font_name structures FONTS which contains NFONTS
6585 elements. WIDTH_RATIO is a factor with which to multiply average
6586 widths if ATTRS specifies such a width.
6588 Value is a font name which is allocated from the heap. FONTS is
6589 freed by this function.
6591 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6592 indicate whether the resulting font should be drawn using overstrike
6593 to simulate bold-face. */
6596 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6599 struct font_name
*fonts
;
6602 int *needs_overstrike
;
6605 struct font_name
*best
;
6608 int exact_p
, avgwidth
;
6613 /* Make specified font attributes available in `specified',
6614 indexed by sort order. */
6615 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6617 int xlfd_idx
= font_sort_order
[i
];
6619 if (xlfd_idx
== XLFD_SWIDTH
)
6620 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6621 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6622 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6623 else if (xlfd_idx
== XLFD_WEIGHT
)
6624 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6625 else if (xlfd_idx
== XLFD_SLANT
)
6626 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6631 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6633 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6637 if (needs_overstrike
)
6638 *needs_overstrike
= 0;
6642 /* Find the best match among the non-scalable fonts. */
6643 for (i
= 0; i
< nfonts
; ++i
)
6644 if (!font_scalable_p (fonts
+ i
)
6645 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6649 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6654 /* Unless we found an exact match among non-scalable fonts, see if
6655 we can find a better match among scalable fonts. */
6658 /* A scalable font is better if
6660 1. its weight, slant, swidth attributes are better, or.
6662 2. the best non-scalable font doesn't have the required
6663 point size, and the scalable fonts weight, slant, swidth
6666 int non_scalable_has_exact_height_p
;
6668 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6669 non_scalable_has_exact_height_p
= 1;
6671 non_scalable_has_exact_height_p
= 0;
6673 for (i
= 0; i
< nfonts
; ++i
)
6674 if (font_scalable_p (fonts
+ i
))
6676 if (better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6677 || (!non_scalable_has_exact_height_p
6678 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6680 non_scalable_has_exact_height_p
= 1;
6686 /* We should have found SOME font. */
6690 if (! exact_p
&& needs_overstrike
)
6692 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6693 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6695 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6697 /* We want a bold font, but didn't get one; try to use
6698 overstriking instead to simulate bold-face. However,
6699 don't overstrike an already-bold fontn unless the
6700 desired weight grossly exceeds the available weight. */
6701 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6702 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6704 *needs_overstrike
= 1;
6708 if (font_scalable_p (best
))
6709 font_name
= build_scalable_font_name (f
, best
, pt
);
6711 font_name
= build_font_name (best
);
6713 /* Free font_name structures. */
6714 free_font_names (fonts
, nfonts
);
6720 /* Get a list of matching fonts on frame F, considering FAMILY
6721 and alternative font families from Vface_alternative_font_registry_alist.
6723 FAMILY is the font family whose alternatives are considered.
6725 REGISTRY, if a string, specifies a font registry and encoding to
6726 match. A value of nil means include fonts of any registry and
6729 Return in *FONTS a pointer to a vector of font_name structures for
6730 the fonts matched. Value is the number of fonts found. */
6733 try_alternative_families (f
, family
, registry
, fonts
)
6735 Lisp_Object family
, registry
;
6736 struct font_name
**fonts
;
6741 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6744 /* Try alternative font families. */
6745 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6748 for (alter
= XCDR (alter
);
6749 CONSP (alter
) && nfonts
== 0;
6750 alter
= XCDR (alter
))
6752 if (STRINGP (XCAR (alter
)))
6753 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6757 /* Try all scalable fonts before giving up. */
6758 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6760 int count
= SPECPDL_INDEX ();
6761 specbind (Qscalable_fonts_allowed
, Qt
);
6762 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6763 unbind_to (count
, Qnil
);
6770 /* Get a list of matching fonts on frame F.
6772 FAMILY, if a string, specifies a font family derived from the fontset.
6773 It is only used if the face does not specify any family in ATTRS or
6774 if we cannot find any font of the face's family.
6776 REGISTRY, if a string, specifies a font registry and encoding to
6777 match. A value of nil means include fonts of any registry and
6780 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6781 Otherwise, prefer FAMILY.
6783 Return in *FONTS a pointer to a vector of font_name structures for
6784 the fonts matched. Value is the number of fonts found. */
6787 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6790 Lisp_Object family
, registry
;
6791 struct font_name
**fonts
;
6792 int prefer_face_family
;
6795 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6796 Lisp_Object try_family
;
6798 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6800 if (STRINGP (try_family
))
6801 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6804 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
))
6806 if (xstricmp (SDATA (registry
), "mac-roman") == 0)
6807 /* When realizing the default face and a font spec does not
6808 matched exactly, Emacs looks for ones with the same registry
6809 as the default font. On the Mac, this is mac-roman, which
6810 does not work if the family is -etl-fixed, e.g. The
6811 following widens the choices and fixes that problem. */
6812 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6813 else if (SBYTES (try_family
) > 0
6814 && SREF (try_family
, SBYTES (try_family
) - 1) != '*')
6815 /* Some Central European/Cyrillic font family names have the
6816 Roman counterpart name as their prefix. */
6817 nfonts
= try_alternative_families (f
, concat2 (try_family
,
6818 build_string ("*")),
6823 if (EQ (try_family
, family
))
6824 family
= face_family
;
6826 if (nfonts
== 0 && STRINGP (family
))
6827 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6829 /* Try font family of the default face or "fixed". */
6832 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6834 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6836 family
= build_string ("fixed");
6837 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6840 /* Try any family with the given registry. */
6842 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6848 /* Return the fontset id of the base fontset name or alias name given
6849 by the fontset attribute of ATTRS. Value is -1 if the fontset
6850 attribute of ATTRS doesn't name a fontset. */
6853 face_fontset (attrs
)
6858 name
= attrs
[LFACE_FONT_INDEX
];
6859 if (!STRINGP (name
))
6861 return fs_query_fontset (name
, 0);
6865 /* Choose a name of font to use on frame F to display character C with
6866 Lisp face attributes specified by ATTRS. The font name is
6867 determined by the font-related attributes in ATTRS and the name
6868 pattern for C in FONTSET. Value is the font name which is
6869 allocated from the heap and must be freed by the caller, or NULL if
6870 we can get no information about the font name of C. It is assured
6871 that we always get some information for a single byte
6874 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6875 indicate whether the resulting font should be drawn using overstrike
6876 to simulate bold-face. */
6879 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6883 int *needs_overstrike
;
6885 Lisp_Object pattern
;
6886 char *font_name
= NULL
;
6887 struct font_name
*fonts
;
6888 int nfonts
, width_ratio
;
6890 if (needs_overstrike
)
6891 *needs_overstrike
= 0;
6893 /* Get (foundry and) family name and registry (and encoding) name of
6895 pattern
= fontset_font_pattern (f
, fontset
, c
);
6898 xassert (!SINGLE_BYTE_CHAR_P (c
));
6902 /* If what we got is a name pattern, return it. */
6903 if (STRINGP (pattern
))
6904 return xstrdup (SDATA (pattern
));
6906 /* Get a list of fonts matching that pattern and choose the
6907 best match for the specified face attributes from it. */
6908 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6909 (SINGLE_BYTE_CHAR_P (c
)
6910 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6911 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6913 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6914 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6919 #endif /* HAVE_WINDOW_SYSTEM */
6923 /***********************************************************************
6925 ***********************************************************************/
6927 /* Realize basic faces on frame F. Value is zero if frame parameters
6928 of F don't contain enough information needed to realize the default
6932 realize_basic_faces (f
)
6936 int count
= SPECPDL_INDEX ();
6938 /* Block input here so that we won't be surprised by an X expose
6939 event, for instance, without having the faces set up. */
6941 specbind (Qscalable_fonts_allowed
, Qt
);
6943 if (realize_default_face (f
))
6945 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6946 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6947 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6948 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6949 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6950 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6951 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6952 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6953 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6954 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6955 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
6957 /* Reflect changes in the `menu' face in menu bars. */
6958 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6960 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6961 #ifdef USE_X_TOOLKIT
6962 x_update_menu_appearance (f
);
6969 unbind_to (count
, Qnil
);
6975 /* Realize the default face on frame F. If the face is not fully
6976 specified, make it fully-specified. Attributes of the default face
6977 that are not explicitly specified are taken from frame parameters. */
6980 realize_default_face (f
)
6983 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6985 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6986 Lisp_Object frame_font
;
6989 /* If the `default' face is not yet known, create it. */
6990 lface
= lface_from_face_name (f
, Qdefault
, 0);
6994 XSETFRAME (frame
, f
);
6995 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6999 #ifdef HAVE_WINDOW_SYSTEM
7000 if (FRAME_WINDOW_P (f
))
7002 /* Set frame_font to the value of the `font' frame parameter. */
7003 frame_font
= Fassq (Qfont
, f
->param_alist
);
7004 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
7005 frame_font
= XCDR (frame_font
);
7006 set_lface_from_font_name (f
, lface
, frame_font
,
7007 f
->default_face_done_p
, 1);
7008 f
->default_face_done_p
= 1;
7010 #endif /* HAVE_WINDOW_SYSTEM */
7012 if (!FRAME_WINDOW_P (f
))
7014 LFACE_FAMILY (lface
) = build_string ("default");
7015 LFACE_SWIDTH (lface
) = Qnormal
;
7016 LFACE_HEIGHT (lface
) = make_number (1);
7017 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
7018 LFACE_WEIGHT (lface
) = Qnormal
;
7019 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
7020 LFACE_SLANT (lface
) = Qnormal
;
7021 LFACE_AVGWIDTH (lface
) = Qunspecified
;
7024 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
7025 LFACE_UNDERLINE (lface
) = Qnil
;
7027 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
7028 LFACE_OVERLINE (lface
) = Qnil
;
7030 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
7031 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
7033 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
7034 LFACE_BOX (lface
) = Qnil
;
7036 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
7037 LFACE_INVERSE (lface
) = Qnil
;
7039 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
7041 /* This function is called so early that colors are not yet
7042 set in the frame parameter list. */
7043 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7045 if (CONSP (color
) && STRINGP (XCDR (color
)))
7046 LFACE_FOREGROUND (lface
) = XCDR (color
);
7047 else if (FRAME_WINDOW_P (f
))
7049 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7050 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7055 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7057 /* This function is called so early that colors are not yet
7058 set in the frame parameter list. */
7059 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7060 if (CONSP (color
) && STRINGP (XCDR (color
)))
7061 LFACE_BACKGROUND (lface
) = XCDR (color
);
7062 else if (FRAME_WINDOW_P (f
))
7064 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7065 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7070 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7071 LFACE_STIPPLE (lface
) = Qnil
;
7073 /* Realize the face; it must be fully-specified now. */
7074 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7075 check_lface (lface
);
7076 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7077 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
7079 #ifdef HAVE_WINDOW_SYSTEM
7080 #ifdef HAVE_X_WINDOWS
7081 if (face
->font
!= FRAME_FONT (f
))
7082 /* As the font specified for the frame was not acceptable as a
7083 font for the default face (perhaps because auto-scaled fonts
7084 are rejected), we must adjust the frame font. */
7085 x_set_font (f
, build_string (face
->font_name
), Qnil
);
7086 #endif /* HAVE_X_WINDOWS */
7087 #endif /* HAVE_WINDOW_SYSTEM */
7092 /* Realize basic faces other than the default face in face cache C.
7093 SYMBOL is the face name, ID is the face id the realized face must
7094 have. The default face must have been realized already. */
7097 realize_named_face (f
, symbol
, id
)
7102 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7103 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7104 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7105 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7106 struct face
*new_face
;
7108 /* The default face must exist and be fully specified. */
7109 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7110 check_lface_attrs (attrs
);
7111 xassert (lface_fully_specified_p (attrs
));
7113 /* If SYMBOL isn't know as a face, create it. */
7117 XSETFRAME (frame
, f
);
7118 lface
= Finternal_make_lisp_face (symbol
, frame
);
7121 /* Merge SYMBOL's face with the default face. */
7122 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7123 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7125 /* Realize the face. */
7126 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
7130 /* Realize the fully-specified face with attributes ATTRS in face
7131 cache CACHE for character C. If C is a multibyte character,
7132 BASE_FACE is a face that has the same attributes. Otherwise,
7133 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
7134 ID of face to remove before caching the new face. Value is a
7135 pointer to the newly created realized face. */
7137 static struct face
*
7138 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
7139 struct face_cache
*cache
;
7142 struct face
*base_face
;
7147 /* LFACE must be fully specified. */
7148 xassert (cache
!= NULL
);
7149 check_lface_attrs (attrs
);
7151 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7153 /* Remove the former face. */
7154 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7155 uncache_face (cache
, former_face
);
7156 free_realized_face (cache
->f
, former_face
);
7159 if (FRAME_WINDOW_P (cache
->f
))
7160 face
= realize_x_face (cache
, attrs
, c
, base_face
);
7161 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7162 face
= realize_tty_face (cache
, attrs
, c
);
7166 /* Insert the new face. */
7167 cache_face (cache
, face
, lface_hash (attrs
));
7168 #ifdef HAVE_WINDOW_SYSTEM
7169 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
7170 load_face_font (cache
->f
, face
, c
);
7171 #endif /* HAVE_WINDOW_SYSTEM */
7176 /* Realize the fully-specified face with attributes ATTRS in face
7177 cache CACHE for character C. Do it for X frame CACHE->f. If C is
7178 a multibyte character, BASE_FACE is a face that has the same
7179 attributes. Otherwise, BASE_FACE is ignored. If the new face
7180 doesn't share font with the default face, a fontname is allocated
7181 from the heap and set in `font_name' of the new face, but it is not
7182 yet loaded here. Value is a pointer to the newly created realized
7185 static struct face
*
7186 realize_x_face (cache
, attrs
, c
, base_face
)
7187 struct face_cache
*cache
;
7190 struct face
*base_face
;
7192 struct face
*face
= NULL
;
7193 #ifdef HAVE_WINDOW_SYSTEM
7194 struct face
*default_face
;
7196 Lisp_Object stipple
, overline
, strike_through
, box
;
7198 xassert (FRAME_WINDOW_P (cache
->f
));
7199 xassert (SINGLE_BYTE_CHAR_P (c
)
7202 /* Allocate a new realized face. */
7203 face
= make_realized_face (attrs
);
7207 /* If C is a multibyte character, we share all face attirbutes with
7208 BASE_FACE including the realized fontset. But, we must load a
7210 if (!SINGLE_BYTE_CHAR_P (c
))
7212 bcopy (base_face
, face
, sizeof *face
);
7215 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7216 face
->colors_copied_bitwise_p
= 1;
7218 /* to force realize_face to load font */
7223 /* Now we are realizing a face for ASCII (and unibyte) characters. */
7225 /* Determine the font to use. Most of the time, the font will be
7226 the same as the font of the default face, so try that first. */
7227 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7229 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
7230 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7232 face
->font
= default_face
->font
;
7233 face
->fontset
= default_face
->fontset
;
7234 face
->font_info_id
= default_face
->font_info_id
;
7235 face
->font_name
= default_face
->font_name
;
7236 face
->ascii_face
= face
;
7238 /* But, as we can't share the fontset, make a new realized
7239 fontset that has the same base fontset as of the default
7242 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
7246 /* If the face attribute ATTRS specifies a fontset, use it as
7247 the base of a new realized fontset. Otherwise, use the same
7248 base fontset as of the default face. The base determines
7249 registry and encoding of a font. It may also determine
7250 foundry and family. The other fields of font name pattern
7251 are constructed from ATTRS. */
7252 int fontset
= face_fontset (attrs
);
7254 if ((fontset
== -1) && default_face
)
7255 fontset
= default_face
->fontset
;
7256 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
7257 face
->font
= NULL
; /* to force realize_face to load font */
7260 /* Load colors, and set remaining attributes. */
7262 load_face_colors (f
, face
, attrs
);
7265 box
= attrs
[LFACE_BOX_INDEX
];
7268 /* A simple box of line width 1 drawn in color given by
7270 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7272 face
->box
= FACE_SIMPLE_BOX
;
7273 face
->box_line_width
= 1;
7275 else if (INTEGERP (box
))
7277 /* Simple box of specified line width in foreground color of the
7279 xassert (XINT (box
) != 0);
7280 face
->box
= FACE_SIMPLE_BOX
;
7281 face
->box_line_width
= XINT (box
);
7282 face
->box_color
= face
->foreground
;
7283 face
->box_color_defaulted_p
= 1;
7285 else if (CONSP (box
))
7287 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7288 being one of `raised' or `sunken'. */
7289 face
->box
= FACE_SIMPLE_BOX
;
7290 face
->box_color
= face
->foreground
;
7291 face
->box_color_defaulted_p
= 1;
7292 face
->box_line_width
= 1;
7296 Lisp_Object keyword
, value
;
7298 keyword
= XCAR (box
);
7306 if (EQ (keyword
, QCline_width
))
7308 if (INTEGERP (value
) && XINT (value
) != 0)
7309 face
->box_line_width
= XINT (value
);
7311 else if (EQ (keyword
, QCcolor
))
7313 if (STRINGP (value
))
7315 face
->box_color
= load_color (f
, face
, value
,
7317 face
->use_box_color_for_shadows_p
= 1;
7320 else if (EQ (keyword
, QCstyle
))
7322 if (EQ (value
, Qreleased_button
))
7323 face
->box
= FACE_RAISED_BOX
;
7324 else if (EQ (value
, Qpressed_button
))
7325 face
->box
= FACE_SUNKEN_BOX
;
7330 /* Text underline, overline, strike-through. */
7332 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7334 /* Use default color (same as foreground color). */
7335 face
->underline_p
= 1;
7336 face
->underline_defaulted_p
= 1;
7337 face
->underline_color
= 0;
7339 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7341 /* Use specified color. */
7342 face
->underline_p
= 1;
7343 face
->underline_defaulted_p
= 0;
7344 face
->underline_color
7345 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7346 LFACE_UNDERLINE_INDEX
);
7348 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7350 face
->underline_p
= 0;
7351 face
->underline_defaulted_p
= 0;
7352 face
->underline_color
= 0;
7355 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7356 if (STRINGP (overline
))
7358 face
->overline_color
7359 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7360 LFACE_OVERLINE_INDEX
);
7361 face
->overline_p
= 1;
7363 else if (EQ (overline
, Qt
))
7365 face
->overline_color
= face
->foreground
;
7366 face
->overline_color_defaulted_p
= 1;
7367 face
->overline_p
= 1;
7370 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7371 if (STRINGP (strike_through
))
7373 face
->strike_through_color
7374 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7375 LFACE_STRIKE_THROUGH_INDEX
);
7376 face
->strike_through_p
= 1;
7378 else if (EQ (strike_through
, Qt
))
7380 face
->strike_through_color
= face
->foreground
;
7381 face
->strike_through_color_defaulted_p
= 1;
7382 face
->strike_through_p
= 1;
7385 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7386 if (!NILP (stipple
))
7387 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7389 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7390 #endif /* HAVE_WINDOW_SYSTEM */
7395 /* Map a specified color of face FACE on frame F to a tty color index.
7396 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7397 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7398 default foreground/background colors. */
7401 map_tty_color (f
, face
, idx
, defaulted
)
7404 enum lface_attribute_index idx
;
7407 Lisp_Object frame
, color
, def
;
7408 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7409 unsigned long default_pixel
, default_other_pixel
, pixel
;
7411 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7415 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7416 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7420 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7421 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7424 XSETFRAME (frame
, f
);
7425 color
= face
->lface
[idx
];
7429 && CONSP (Vtty_defined_color_alist
)
7430 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7433 /* Associations in tty-defined-color-alist are of the form
7434 (NAME INDEX R G B). We need the INDEX part. */
7435 pixel
= XINT (XCAR (XCDR (def
)));
7438 if (pixel
== default_pixel
&& STRINGP (color
))
7440 pixel
= load_color (f
, face
, color
, idx
);
7442 #if defined (MSDOS) || defined (WINDOWSNT)
7443 /* If the foreground of the default face is the default color,
7444 use the foreground color defined by the frame. */
7446 if (FRAME_MSDOS_P (f
))
7449 if (pixel
== default_pixel
7450 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7453 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7455 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7456 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7459 else if (pixel
== default_other_pixel
)
7462 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7464 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7465 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7471 #endif /* MSDOS or WINDOWSNT */
7475 face
->foreground
= pixel
;
7477 face
->background
= pixel
;
7481 /* Realize the fully-specified face with attributes ATTRS in face
7482 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7483 pointer to the newly created realized face. */
7485 static struct face
*
7486 realize_tty_face (cache
, attrs
, c
)
7487 struct face_cache
*cache
;
7493 int face_colors_defaulted
= 0;
7494 struct frame
*f
= cache
->f
;
7496 /* Frame must be a termcap frame. */
7497 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7499 /* Allocate a new realized face. */
7500 face
= make_realized_face (attrs
);
7501 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7503 /* Map face attributes to TTY appearances. We map slant to
7504 dimmed text because we want italic text to appear differently
7505 and because dimmed text is probably used infrequently. */
7506 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7507 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7509 if (weight
> XLFD_WEIGHT_MEDIUM
)
7510 face
->tty_bold_p
= 1;
7511 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7512 face
->tty_dim_p
= 1;
7513 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7514 face
->tty_underline_p
= 1;
7515 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7516 face
->tty_reverse_p
= 1;
7518 /* Map color names to color indices. */
7519 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7520 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7522 /* Swap colors if face is inverse-video. If the colors are taken
7523 from the frame colors, they are already inverted, since the
7524 frame-creation function calls x-handle-reverse-video. */
7525 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7527 unsigned long tem
= face
->foreground
;
7528 face
->foreground
= face
->background
;
7529 face
->background
= tem
;
7532 if (tty_suppress_bold_inverse_default_colors_p
7534 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7535 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7536 face
->tty_bold_p
= 0;
7542 DEFUN ("tty-suppress-bold-inverse-default-colors",
7543 Ftty_suppress_bold_inverse_default_colors
,
7544 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7545 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7546 SUPPRESS non-nil means suppress it.
7547 This affects bold faces on TTYs whose foreground is the default background
7548 color of the display and whose background is the default foreground color.
7549 For such faces, the bold face attribute is ignored if this variable
7552 Lisp_Object suppress
;
7554 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7555 ++face_change_count
;
7561 /***********************************************************************
7563 ***********************************************************************/
7565 /* Return the ID of the face to use to display character CH with face
7566 property PROP on frame F in current_buffer. */
7569 compute_char_face (f
, ch
, prop
)
7576 if (NILP (current_buffer
->enable_multibyte_characters
))
7581 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7582 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7586 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7587 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7588 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7589 merge_face_ref (f
, prop
, attrs
, 1, 0);
7590 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7596 /* Return the face ID associated with buffer position POS for
7597 displaying ASCII characters. Return in *ENDPTR the position at
7598 which a different face is needed, as far as text properties and
7599 overlays are concerned. W is a window displaying current_buffer.
7601 REGION_BEG, REGION_END delimit the region, so it can be
7604 LIMIT is a position not to scan beyond. That is to limit the time
7605 this function can take.
7607 If MOUSE is non-zero, use the character's mouse-face, not its face.
7609 The face returned is suitable for displaying ASCII characters. */
7612 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7613 endptr
, limit
, mouse
)
7616 int region_beg
, region_end
;
7621 struct frame
*f
= XFRAME (w
->frame
);
7622 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7623 Lisp_Object prop
, position
;
7625 Lisp_Object
*overlay_vec
;
7628 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7629 Lisp_Object limit1
, end
;
7630 struct face
*default_face
;
7632 /* W must display the current buffer. We could write this function
7633 to use the frame and buffer of W, but right now it doesn't. */
7634 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7636 XSETFRAME (frame
, f
);
7637 XSETFASTINT (position
, pos
);
7640 if (pos
< region_beg
&& region_beg
< endpos
)
7641 endpos
= region_beg
;
7643 /* Get the `face' or `mouse_face' text property at POS, and
7644 determine the next position at which the property changes. */
7645 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7646 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7647 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7649 endpos
= XINT (end
);
7651 /* Look at properties from overlays. */
7655 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7656 if (next_overlay
< endpos
)
7657 endpos
= next_overlay
;
7662 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7664 /* Optimize common cases where we can use the default face. */
7667 && !(pos
>= region_beg
&& pos
< region_end
))
7668 return DEFAULT_FACE_ID
;
7670 /* Begin with attributes from the default face. */
7671 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7673 /* Merge in attributes specified via text properties. */
7675 merge_face_ref (f
, prop
, attrs
, 1, 0);
7677 /* Now merge the overlay data. */
7678 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7679 for (i
= 0; i
< noverlays
; i
++)
7684 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7686 merge_face_ref (f
, prop
, attrs
, 1, 0);
7688 oend
= OVERLAY_END (overlay_vec
[i
]);
7689 oendpos
= OVERLAY_POSITION (oend
);
7690 if (oendpos
< endpos
)
7694 /* If in the region, merge in the region face. */
7695 if (pos
>= region_beg
&& pos
< region_end
)
7697 merge_named_face (f
, Qregion
, attrs
, 0);
7699 if (region_end
< endpos
)
7700 endpos
= region_end
;
7705 /* Look up a realized face with the given face attributes,
7706 or realize a new one for ASCII characters. */
7707 return lookup_face (f
, attrs
, 0, NULL
);
7711 /* Compute the face at character position POS in Lisp string STRING on
7712 window W, for ASCII characters.
7714 If STRING is an overlay string, it comes from position BUFPOS in
7715 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7716 not an overlay string. W must display the current buffer.
7717 REGION_BEG and REGION_END give the start and end positions of the
7718 region; both are -1 if no region is visible.
7720 BASE_FACE_ID is the id of a face to merge with. For strings coming
7721 from overlays or the `display' property it is the face at BUFPOS.
7723 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7725 Set *ENDPTR to the next position where to check for faces in
7726 STRING; -1 if the face is constant from POS to the end of the
7729 Value is the id of the face to use. The face returned is suitable
7730 for displaying ASCII characters. */
7733 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7734 region_end
, endptr
, base_face_id
, mouse_p
)
7738 int region_beg
, region_end
;
7740 enum face_id base_face_id
;
7743 Lisp_Object prop
, position
, end
, limit
;
7744 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7745 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7746 struct face
*base_face
;
7747 int multibyte_p
= STRING_MULTIBYTE (string
);
7748 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7750 /* Get the value of the face property at the current position within
7751 STRING. Value is nil if there is no face property. */
7752 XSETFASTINT (position
, pos
);
7753 prop
= Fget_text_property (position
, prop_name
, string
);
7755 /* Get the next position at which to check for faces. Value of end
7756 is nil if face is constant all the way to the end of the string.
7757 Otherwise it is a string position where to check faces next.
7758 Limit is the maximum position up to which to check for property
7759 changes in Fnext_single_property_change. Strings are usually
7760 short, so set the limit to the end of the string. */
7761 XSETFASTINT (limit
, SCHARS (string
));
7762 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7764 *endptr
= XFASTINT (end
);
7768 base_face
= FACE_FROM_ID (f
, base_face_id
);
7769 xassert (base_face
);
7771 /* Optimize the default case that there is no face property and we
7772 are not in the region. */
7774 && (base_face_id
!= DEFAULT_FACE_ID
7775 /* BUFPOS <= 0 means STRING is not an overlay string, so
7776 that the region doesn't have to be taken into account. */
7778 || bufpos
< region_beg
7779 || bufpos
>= region_end
)
7781 /* We can't realize faces for different charsets differently
7782 if we don't have fonts, so we can stop here if not working
7783 on a window-system frame. */
7784 || !FRAME_WINDOW_P (f
)
7785 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7786 return base_face
->id
;
7788 /* Begin with attributes from the base face. */
7789 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7791 /* Merge in attributes specified via text properties. */
7793 merge_face_ref (f
, prop
, attrs
, 1, 0);
7795 /* If in the region, merge in the region face. */
7797 && bufpos
>= region_beg
7798 && bufpos
< region_end
)
7799 merge_named_face (f
, Qregion
, attrs
, 0);
7801 /* Look up a realized face with the given face attributes,
7802 or realize a new one for ASCII characters. */
7803 return lookup_face (f
, attrs
, 0, NULL
);
7807 /* Merge a face into a realized face.
7809 F is frame where faces are (to be) realized.
7811 FACE_NAME is named face to merge.
7813 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
7815 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
7817 BASE_FACE_ID is realized face to merge into.
7823 merge_faces (f
, face_name
, face_id
, base_face_id
)
7825 Lisp_Object face_name
;
7826 int face_id
, base_face_id
;
7828 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7829 struct face
*base_face
;
7831 base_face
= FACE_FROM_ID (f
, base_face_id
);
7833 return base_face_id
;
7835 if (EQ (face_name
, Qt
))
7837 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
7838 return base_face_id
;
7839 face_name
= lface_id_to_name
[face_id
];
7840 face_id
= lookup_derived_face (f
, face_name
, 0, base_face_id
, 1);
7843 return base_face_id
;
7846 /* Begin with attributes from the base face. */
7847 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7849 if (!NILP (face_name
))
7851 if (!merge_named_face (f
, face_name
, attrs
, 0))
7852 return base_face_id
;
7858 return base_face_id
;
7859 face
= FACE_FROM_ID (f
, face_id
);
7861 return base_face_id
;
7862 merge_face_vectors (f
, face
->lface
, attrs
, 0);
7865 /* Look up a realized face with the given face attributes,
7866 or realize a new one for ASCII characters. */
7867 return lookup_face (f
, attrs
, 0, NULL
);
7871 /***********************************************************************
7873 ***********************************************************************/
7877 /* Print the contents of the realized face FACE to stderr. */
7880 dump_realized_face (face
)
7883 fprintf (stderr
, "ID: %d\n", face
->id
);
7884 #ifdef HAVE_X_WINDOWS
7885 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
7887 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7889 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7890 fprintf (stderr
, "background: 0x%lx (%s)\n",
7892 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7893 fprintf (stderr
, "font_name: %s (%s)\n",
7895 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7896 #ifdef HAVE_X_WINDOWS
7897 fprintf (stderr
, "font = %p\n", face
->font
);
7899 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7900 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7901 fprintf (stderr
, "underline: %d (%s)\n",
7903 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7904 fprintf (stderr
, "hash: %d\n", face
->hash
);
7905 fprintf (stderr
, "charset: %d\n", face
->charset
);
7909 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7917 fprintf (stderr
, "font selection order: ");
7918 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7919 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7920 fprintf (stderr
, "\n");
7922 fprintf (stderr
, "alternative fonts: ");
7923 debug_print (Vface_alternative_font_family_alist
);
7924 fprintf (stderr
, "\n");
7926 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7927 Fdump_face (make_number (i
));
7933 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7935 error ("Not a valid face");
7936 dump_realized_face (face
);
7943 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7944 0, 0, 0, doc
: /* */)
7947 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7948 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7949 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7953 #endif /* GLYPH_DEBUG != 0 */
7957 /***********************************************************************
7959 ***********************************************************************/
7964 Qface
= intern ("face");
7966 Qface_no_inherit
= intern ("face-no-inherit");
7967 staticpro (&Qface_no_inherit
);
7968 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7969 staticpro (&Qbitmap_spec_p
);
7970 Qframe_set_background_mode
= intern ("frame-set-background-mode");
7971 staticpro (&Qframe_set_background_mode
);
7973 /* Lisp face attribute keywords. */
7974 QCfamily
= intern (":family");
7975 staticpro (&QCfamily
);
7976 QCheight
= intern (":height");
7977 staticpro (&QCheight
);
7978 QCweight
= intern (":weight");
7979 staticpro (&QCweight
);
7980 QCslant
= intern (":slant");
7981 staticpro (&QCslant
);
7982 QCunderline
= intern (":underline");
7983 staticpro (&QCunderline
);
7984 QCinverse_video
= intern (":inverse-video");
7985 staticpro (&QCinverse_video
);
7986 QCreverse_video
= intern (":reverse-video");
7987 staticpro (&QCreverse_video
);
7988 QCforeground
= intern (":foreground");
7989 staticpro (&QCforeground
);
7990 QCbackground
= intern (":background");
7991 staticpro (&QCbackground
);
7992 QCstipple
= intern (":stipple");;
7993 staticpro (&QCstipple
);
7994 QCwidth
= intern (":width");
7995 staticpro (&QCwidth
);
7996 QCfont
= intern (":font");
7997 staticpro (&QCfont
);
7998 QCbold
= intern (":bold");
7999 staticpro (&QCbold
);
8000 QCitalic
= intern (":italic");
8001 staticpro (&QCitalic
);
8002 QCoverline
= intern (":overline");
8003 staticpro (&QCoverline
);
8004 QCstrike_through
= intern (":strike-through");
8005 staticpro (&QCstrike_through
);
8006 QCbox
= intern (":box");
8008 QCinherit
= intern (":inherit");
8009 staticpro (&QCinherit
);
8011 /* Symbols used for Lisp face attribute values. */
8012 QCcolor
= intern (":color");
8013 staticpro (&QCcolor
);
8014 QCline_width
= intern (":line-width");
8015 staticpro (&QCline_width
);
8016 QCstyle
= intern (":style");
8017 staticpro (&QCstyle
);
8018 Qreleased_button
= intern ("released-button");
8019 staticpro (&Qreleased_button
);
8020 Qpressed_button
= intern ("pressed-button");
8021 staticpro (&Qpressed_button
);
8022 Qnormal
= intern ("normal");
8023 staticpro (&Qnormal
);
8024 Qultra_light
= intern ("ultra-light");
8025 staticpro (&Qultra_light
);
8026 Qextra_light
= intern ("extra-light");
8027 staticpro (&Qextra_light
);
8028 Qlight
= intern ("light");
8029 staticpro (&Qlight
);
8030 Qsemi_light
= intern ("semi-light");
8031 staticpro (&Qsemi_light
);
8032 Qsemi_bold
= intern ("semi-bold");
8033 staticpro (&Qsemi_bold
);
8034 Qbold
= intern ("bold");
8036 Qextra_bold
= intern ("extra-bold");
8037 staticpro (&Qextra_bold
);
8038 Qultra_bold
= intern ("ultra-bold");
8039 staticpro (&Qultra_bold
);
8040 Qoblique
= intern ("oblique");
8041 staticpro (&Qoblique
);
8042 Qitalic
= intern ("italic");
8043 staticpro (&Qitalic
);
8044 Qreverse_oblique
= intern ("reverse-oblique");
8045 staticpro (&Qreverse_oblique
);
8046 Qreverse_italic
= intern ("reverse-italic");
8047 staticpro (&Qreverse_italic
);
8048 Qultra_condensed
= intern ("ultra-condensed");
8049 staticpro (&Qultra_condensed
);
8050 Qextra_condensed
= intern ("extra-condensed");
8051 staticpro (&Qextra_condensed
);
8052 Qcondensed
= intern ("condensed");
8053 staticpro (&Qcondensed
);
8054 Qsemi_condensed
= intern ("semi-condensed");
8055 staticpro (&Qsemi_condensed
);
8056 Qsemi_expanded
= intern ("semi-expanded");
8057 staticpro (&Qsemi_expanded
);
8058 Qexpanded
= intern ("expanded");
8059 staticpro (&Qexpanded
);
8060 Qextra_expanded
= intern ("extra-expanded");
8061 staticpro (&Qextra_expanded
);
8062 Qultra_expanded
= intern ("ultra-expanded");
8063 staticpro (&Qultra_expanded
);
8064 Qbackground_color
= intern ("background-color");
8065 staticpro (&Qbackground_color
);
8066 Qforeground_color
= intern ("foreground-color");
8067 staticpro (&Qforeground_color
);
8068 Qunspecified
= intern ("unspecified");
8069 staticpro (&Qunspecified
);
8070 Qignore_defface
= intern (":ignore-defface");
8071 staticpro (&Qignore_defface
);
8073 Qface_alias
= intern ("face-alias");
8074 staticpro (&Qface_alias
);
8075 Qdefault
= intern ("default");
8076 staticpro (&Qdefault
);
8077 Qtool_bar
= intern ("tool-bar");
8078 staticpro (&Qtool_bar
);
8079 Qregion
= intern ("region");
8080 staticpro (&Qregion
);
8081 Qfringe
= intern ("fringe");
8082 staticpro (&Qfringe
);
8083 Qheader_line
= intern ("header-line");
8084 staticpro (&Qheader_line
);
8085 Qscroll_bar
= intern ("scroll-bar");
8086 staticpro (&Qscroll_bar
);
8087 Qmenu
= intern ("menu");
8089 Qcursor
= intern ("cursor");
8090 staticpro (&Qcursor
);
8091 Qborder
= intern ("border");
8092 staticpro (&Qborder
);
8093 Qmouse
= intern ("mouse");
8094 staticpro (&Qmouse
);
8095 Qmode_line_inactive
= intern ("mode-line-inactive");
8096 staticpro (&Qmode_line_inactive
);
8097 Qvertical_border
= intern ("vertical-border");
8098 staticpro (&Qvertical_border
);
8099 Qtty_color_desc
= intern ("tty-color-desc");
8100 staticpro (&Qtty_color_desc
);
8101 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8102 staticpro (&Qtty_color_standard_values
);
8103 Qtty_color_by_index
= intern ("tty-color-by-index");
8104 staticpro (&Qtty_color_by_index
);
8105 Qtty_color_alist
= intern ("tty-color-alist");
8106 staticpro (&Qtty_color_alist
);
8107 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8108 staticpro (&Qscalable_fonts_allowed
);
8110 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8111 staticpro (&Vparam_value_alist
);
8112 Vface_alternative_font_family_alist
= Qnil
;
8113 staticpro (&Vface_alternative_font_family_alist
);
8114 Vface_alternative_font_registry_alist
= Qnil
;
8115 staticpro (&Vface_alternative_font_registry_alist
);
8117 defsubr (&Sinternal_make_lisp_face
);
8118 defsubr (&Sinternal_lisp_face_p
);
8119 defsubr (&Sinternal_set_lisp_face_attribute
);
8120 #ifdef HAVE_WINDOW_SYSTEM
8121 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8123 defsubr (&Scolor_gray_p
);
8124 defsubr (&Scolor_supported_p
);
8125 defsubr (&Sface_attribute_relative_p
);
8126 defsubr (&Smerge_face_attribute
);
8127 defsubr (&Sinternal_get_lisp_face_attribute
);
8128 defsubr (&Sinternal_lisp_face_attribute_values
);
8129 defsubr (&Sinternal_lisp_face_equal_p
);
8130 defsubr (&Sinternal_lisp_face_empty_p
);
8131 defsubr (&Sinternal_copy_lisp_face
);
8132 defsubr (&Sinternal_merge_in_global_face
);
8133 defsubr (&Sface_font
);
8134 defsubr (&Sframe_face_alist
);
8135 defsubr (&Sdisplay_supports_face_attributes_p
);
8136 defsubr (&Scolor_distance
);
8137 defsubr (&Sinternal_set_font_selection_order
);
8138 defsubr (&Sinternal_set_alternative_font_family_alist
);
8139 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8140 defsubr (&Sface_attributes_as_vector
);
8142 defsubr (&Sdump_face
);
8143 defsubr (&Sshow_face_resources
);
8144 #endif /* GLYPH_DEBUG */
8145 defsubr (&Sclear_face_cache
);
8146 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8148 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8149 defsubr (&Sdump_colors
);
8152 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8153 doc
: /* *Limit for font matching.
8154 If an integer > 0, font matching functions won't load more than
8155 that number of fonts when searching for a matching font. */);
8156 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8158 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8159 doc
: /* List of global face definitions (for internal use only.) */);
8160 Vface_new_frame_defaults
= Qnil
;
8162 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8163 doc
: /* *Default stipple pattern used on monochrome displays.
8164 This stipple pattern is used on monochrome displays
8165 instead of shades of gray for a face background color.
8166 See `set-face-stipple' for possible values for this variable. */);
8167 Vface_default_stipple
= build_string ("gray3");
8169 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8170 doc
: /* An alist of defined terminal colors and their RGB values. */);
8171 Vtty_defined_color_alist
= Qnil
;
8173 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8174 doc
: /* Allowed scalable fonts.
8175 A value of nil means don't allow any scalable fonts.
8176 A value of t means allow any scalable font.
8177 Otherwise, value must be a list of regular expressions. A font may be
8178 scaled if its name matches a regular expression in the list.
8179 Note that if value is nil, a scalable font might still be used, if no
8180 other font of the appropriate family and registry is available. */);
8181 Vscalable_fonts_allowed
= Qnil
;
8183 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8184 doc
: /* List of ignored fonts.
8185 Each element is a regular expression that matches names of fonts to
8187 Vface_ignored_fonts
= Qnil
;
8189 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8190 doc
: /* Alist of fonts vs the rescaling factors.
8191 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8192 FONT-NAME-PATTERN is a regular expression matching a font name, and
8193 RESCALE-RATIO is a floating point number to specify how much larger
8194 \(or smaller) font we should use. For instance, if a face requests
8195 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8196 Vface_font_rescale_alist
= Qnil
;
8198 #ifdef HAVE_WINDOW_SYSTEM
8199 defsubr (&Sbitmap_spec_p
);
8200 defsubr (&Sx_list_fonts
);
8201 defsubr (&Sinternal_face_x_get_resource
);
8202 defsubr (&Sx_family_fonts
);
8203 defsubr (&Sx_font_family_list
);
8204 #endif /* HAVE_WINDOW_SYSTEM */
8207 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8208 (do not change this comment) */