1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004
3 Free Software Foundation.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
77 Faces are frame-local by nature because Emacs allows to define the
78 same named face (face names are symbols) differently for different
79 frames. Each frame has an alist of face definitions for all named
80 faces. The value of a named face in such an alist is a Lisp vector
81 with the symbol `face' in slot 0, and a slot for each of the face
82 attributes mentioned above.
84 There is also a global face alist `Vface_new_frame_defaults'. Face
85 definitions from this list are used to initialize faces of newly
88 A face doesn't have to specify all attributes. Those not specified
89 have a value of `unspecified'. Faces specifying all attributes but
90 the 14th are called `fully-specified'.
95 The display style of a given character in the text is determined by
96 combining several faces. This process is called `face merging'.
97 Any aspect of the display style that isn't specified by overlays or
98 text properties is taken from the `default' face. Since it is made
99 sure that the default face is always fully-specified, face merging
100 always results in a fully-specified face.
105 After all face attributes for a character have been determined by
106 merging faces of that character, that face is `realized'. The
107 realization process maps face attributes to what is physically
108 available on the system where Emacs runs. The result is a
109 `realized face' in form of a struct face which is stored in the
110 face cache of the frame on which it was realized.
112 Face realization is done in the context of the character to display
113 because different fonts may be used for different characters. In
114 other words, for characters that have different font
115 specifications, different realized faces are needed to display
118 Font specification is done by fontsets. See the comment in
119 fontset.c for the details. In the current implementation, all ASCII
120 characters share the same font in a fontset.
122 Faces are at first realized for ASCII characters, and, at that
123 time, assigned a specific realized fontset. Hereafter, we call
124 such a face as `ASCII face'. When a face for a multibyte character
125 is realized, it inherits (thus shares) a fontset of an ASCII face
126 that has the same attributes other than font-related ones.
128 Thus, all realized faces have a realized fontset.
133 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
134 font as ASCII characters. That is because it is expected that
135 unibyte text users specify a font that is suitable both for ASCII
136 and raw 8-bit characters.
141 Font selection tries to find the best available matching font for a
142 given (character, face) combination.
144 If the face specifies a fontset name, that fontset determines a
145 pattern for fonts of the given character. If the face specifies a
146 font name or the other font-related attributes, a fontset is
147 realized from the default fontset. In that case, that
148 specification determines a pattern for ASCII characters and the
149 default fontset determines a pattern for multibyte characters.
151 Available fonts on the system on which Emacs runs are then matched
152 against the font pattern. The result of font selection is the best
153 match for the given face attributes in this font list.
155 Font selection can be influenced by the user.
157 1. The user can specify the relative importance he gives the face
158 attributes width, height, weight, and slant by setting
159 face-font-selection-order (faces.el) to a list of face attribute
160 names. The default is '(:width :height :weight :slant), and means
161 that font selection first tries to find a good match for the font
162 width specified by a face, then---within fonts with that
163 width---tries to find a best match for the specified font height,
166 2. Setting face-font-family-alternatives allows the user to
167 specify alternative font families to try if a family specified by a
170 3. Setting face-font-registry-alternatives allows the user to
171 specify all alternative font registries to try for a face
172 specifying a registry.
174 4. Setting face-ignored-fonts allows the user to ignore specific
178 Character composition.
180 Usually, the realization process is already finished when Emacs
181 actually reflects the desired glyph matrix on the screen. However,
182 on displaying a composition (sequence of characters to be composed
183 on the screen), a suitable font for the components of the
184 composition is selected and realized while drawing them on the
185 screen, i.e. the realization process is delayed but in principle
189 Initialization of basic faces.
191 The faces `default', `modeline' are considered `basic faces'.
192 When redisplay happens the first time for a newly created frame,
193 basic faces are realized for CHARSET_ASCII. Frame parameters are
194 used to fill in unspecified attributes of the default face. */
198 #include <sys/types.h>
199 #include <sys/stat.h>
202 #include "character.h"
204 #include "keyboard.h"
207 #ifdef HAVE_WINDOW_SYSTEM
209 #endif /* HAVE_WINDOW_SYSTEM */
211 #ifdef HAVE_X_WINDOWS
215 #include <Xm/XmStrDefs.h>
216 #endif /* USE_MOTIF */
217 #endif /* HAVE_X_WINDOWS */
226 /* Redefine X specifics to W32 equivalents to avoid cluttering the
227 code with #ifdef blocks. */
228 #undef FRAME_X_DISPLAY_INFO
229 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
230 #define x_display_info w32_display_info
231 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
232 #define check_x check_w32
233 #define x_list_fonts w32_list_fonts
234 #define GCGraphicsExposures 0
235 #endif /* WINDOWSNT */
239 #define x_display_info mac_display_info
240 #define check_x check_mac
244 #include "dispextern.h"
245 #include "blockinput.h"
247 #include "intervals.h"
249 #ifdef HAVE_X_WINDOWS
251 /* Compensate for a bug in Xos.h on some systems, on which it requires
252 time.h. On some such systems, Xos.h tries to redefine struct
253 timeval and struct timezone if USG is #defined while it is
256 #ifdef XOS_NEEDS_TIME_H
262 #else /* not XOS_NEEDS_TIME_H */
264 #endif /* not XOS_NEEDS_TIME_H */
266 #endif /* HAVE_X_WINDOWS */
270 #define abs(X) ((X) < 0 ? -(X) : (X))
272 /* Number of pt per inch (from the TeXbook). */
274 #define PT_PER_INCH 72.27
276 /* Non-zero if face attribute ATTR is unspecified. */
278 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
280 /* Value is the number of elements of VECTOR. */
282 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
284 /* Make a copy of string S on the stack using alloca. Value is a pointer
287 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
289 /* Make a copy of the contents of Lisp string S on the stack using
290 alloca. Value is a pointer to the copy. */
292 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
294 /* Size of hash table of realized faces in face caches (should be a
297 #define FACE_CACHE_BUCKETS_SIZE 1001
299 /* Keyword symbols used for face attribute names. */
301 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
302 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
303 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
304 Lisp_Object QCreverse_video
;
305 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
306 Lisp_Object QCfontset
;
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
;
320 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
322 /* The name of the function to call when the background of the frame
323 has changed, frame_update_face_colors. */
325 Lisp_Object Qframe_update_face_colors
;
327 /* Names of basic faces. */
329 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
330 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
331 Lisp_Object Qmode_line_inactive
;
332 extern Lisp_Object Qmode_line
;
334 /* The symbol `face-alias'. A symbols having that property is an
335 alias for another face. Value of the property is the name of
338 Lisp_Object Qface_alias
;
340 /* Default stipple pattern used on monochrome displays. This stipple
341 pattern is used on monochrome displays instead of shades of gray
342 for a face background color. See `set-face-stipple' for possible
343 values for this variable. */
345 Lisp_Object Vface_default_stipple
;
347 /* Alist of alternative font families. Each element is of the form
348 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
349 try FAMILY1, then FAMILY2, ... */
351 Lisp_Object Vface_alternative_font_family_alist
;
353 /* Alist of alternative font registries. Each element is of the form
354 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
355 loaded, try REGISTRY1, then REGISTRY2, ... */
357 Lisp_Object Vface_alternative_font_registry_alist
;
359 /* Allowed scalable fonts. A value of nil means don't allow any
360 scalable fonts. A value of t means allow the use of any scalable
361 font. Otherwise, value must be a list of regular expressions. A
362 font may be scaled if its name matches a regular expression in the
365 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
367 /* List of regular expressions that matches names of fonts to ignore. */
369 Lisp_Object Vface_ignored_fonts
;
371 /* Alist of font name patterns vs the rescaling factor. */
373 Lisp_Object Vface_font_rescale_alist
;
375 /* Maximum number of fonts to consider in font_list. If not an
376 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
378 Lisp_Object Vfont_list_limit
;
379 #define DEFAULT_FONT_LIST_LIMIT 100
381 /* The symbols `foreground-color' and `background-color' which can be
382 used as part of a `face' property. This is for compatibility with
385 Lisp_Object Qforeground_color
, Qbackground_color
;
387 /* The symbols `face' and `mouse-face' used as text properties. */
390 extern Lisp_Object Qmouse_face
;
392 /* Error symbol for wrong_type_argument in load_pixmap. */
394 Lisp_Object Qbitmap_spec_p
;
396 /* Alist of global face definitions. Each element is of the form
397 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
398 is a Lisp vector of face attributes. These faces are used
399 to initialize faces for new frames. */
401 Lisp_Object Vface_new_frame_defaults
;
403 /* The next ID to assign to Lisp faces. */
405 static int next_lface_id
;
407 /* A vector mapping Lisp face Id's to face names. */
409 static Lisp_Object
*lface_id_to_name
;
410 static int lface_id_to_name_size
;
412 /* TTY color-related functions (defined in tty-colors.el). */
414 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
416 /* The name of the function used to compute colors on TTYs. */
418 Lisp_Object Qtty_color_alist
;
420 /* An alist of defined terminal colors and their RGB values. */
422 Lisp_Object Vtty_defined_color_alist
;
424 /* Counter for calls to clear_face_cache. If this counter reaches
425 CLEAR_FONT_TABLE_COUNT, and a frame has more than
426 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
428 static int clear_font_table_count
;
429 #define CLEAR_FONT_TABLE_COUNT 100
430 #define CLEAR_FONT_TABLE_NFONTS 10
432 /* Non-zero means face attributes have been changed since the last
433 redisplay. Used in redisplay_internal. */
435 int face_change_count
;
437 /* Non-zero means don't display bold text if a face's foreground
438 and background colors are the inverse of the default colors of the
439 display. This is a kluge to suppress `bold black' foreground text
440 which is hard to read on an LCD monitor. */
442 int tty_suppress_bold_inverse_default_colors_p
;
444 /* A list of the form `((x . y))' used to avoid consing in
445 Finternal_set_lisp_face_attribute. */
447 static Lisp_Object Vparam_value_alist
;
449 /* The total number of colors currently allocated. */
452 static int ncolors_allocated
;
453 static int npixmaps_allocated
;
457 /* Non-zero means the definition of the `menu' face for new frames has
460 int menu_face_changed_default
;
463 /* Function prototypes. */
467 struct named_merge_point
;
469 static void map_tty_color
P_ ((struct frame
*, struct face
*,
470 enum lface_attribute_index
, int *));
471 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
));
472 static int may_use_scalable_font_p
P_ ((const char *));
473 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
474 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
476 static int x_face_list_fonts
P_ ((struct frame
*, char *,
477 struct font_name
**, int, int));
478 static int font_scalable_p
P_ ((struct font_name
*));
479 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
480 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
481 static unsigned char *xstrlwr
P_ ((unsigned char *));
482 static void signal_error
P_ ((char *, Lisp_Object
));
483 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
484 static void load_face_font
P_ ((struct frame
*, struct face
*));
485 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
486 static void free_face_colors
P_ ((struct frame
*, struct face
*));
487 static int face_color_gray_p
P_ ((struct frame
*, char *));
488 static char *build_font_name
P_ ((struct font_name
*));
489 static void free_font_names
P_ ((struct font_name
*, int));
490 static int sorted_font_list
P_ ((struct frame
*, char *,
491 int (*cmpfn
) P_ ((const void *, const void *)),
492 struct font_name
**));
493 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
494 Lisp_Object
, struct font_name
**));
495 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
496 Lisp_Object
, struct font_name
**));
497 static int try_font_list
P_ ((struct frame
*, Lisp_Object
,
498 Lisp_Object
, Lisp_Object
, struct font_name
**));
499 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
500 Lisp_Object
, struct font_name
**));
501 static int cmp_font_names
P_ ((const void *, const void *));
502 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*,
504 static struct face
*realize_non_ascii_face
P_ ((struct frame
*, int,
506 static struct face
*realize_x_face
P_ ((struct face_cache
*, Lisp_Object
*));
507 static struct face
*realize_tty_face
P_ ((struct face_cache
*, Lisp_Object
*));
508 static int realize_basic_faces
P_ ((struct frame
*));
509 static int realize_default_face
P_ ((struct frame
*));
510 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
511 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
512 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
513 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
514 static unsigned lface_hash
P_ ((Lisp_Object
*));
515 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
516 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
517 static void clear_face_gcs
P_ ((struct face_cache
*));
518 static void free_face_cache
P_ ((struct face_cache
*));
519 static int face_numeric_weight
P_ ((Lisp_Object
));
520 static int face_numeric_slant
P_ ((Lisp_Object
));
521 static int face_numeric_swidth
P_ ((Lisp_Object
));
522 static int face_fontset
P_ ((Lisp_Object
*));
523 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
524 struct named_merge_point
*));
525 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
526 int, struct named_merge_point
*));
527 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
528 Lisp_Object
, int, int));
529 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
530 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
531 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
532 struct font_name
*, int, int, int *));
533 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
534 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
535 static int xlfd_numeric_slant
P_ ((struct font_name
*));
536 static int xlfd_numeric_weight
P_ ((struct font_name
*));
537 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
538 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
539 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
540 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
541 static int xlfd_fixed_p
P_ ((struct font_name
*));
542 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
544 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
545 struct font_name
*, int,
547 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
548 struct font_name
*, int));
550 #ifdef HAVE_WINDOW_SYSTEM
552 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
553 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
554 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
555 int (*cmpfn
) P_ ((const void *, const void *))));
556 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
557 static void x_free_gc
P_ ((struct frame
*, GC
));
558 static void clear_font_table
P_ ((struct x_display_info
*));
561 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
562 #endif /* WINDOWSNT */
565 static void x_update_menu_appearance
P_ ((struct frame
*));
567 extern void free_frame_menubar
P_ ((struct frame
*));
568 #endif /* USE_X_TOOLKIT */
570 #endif /* HAVE_WINDOW_SYSTEM */
573 /***********************************************************************
575 ***********************************************************************/
577 #ifdef HAVE_X_WINDOWS
579 #ifdef DEBUG_X_COLORS
581 /* The following is a poor mans infrastructure for debugging X color
582 allocation problems on displays with PseudoColor-8. Some X servers
583 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
584 color reference counts completely so that they don't signal an
585 error when a color is freed whose reference count is already 0.
586 Other X servers do. To help me debug this, the following code
587 implements a simple reference counting schema of its own, for a
588 single display/screen. --gerd. */
590 /* Reference counts for pixel colors. */
592 int color_count
[256];
594 /* Register color PIXEL as allocated. */
597 register_color (pixel
)
600 xassert (pixel
< 256);
601 ++color_count
[pixel
];
605 /* Register color PIXEL as deallocated. */
608 unregister_color (pixel
)
611 xassert (pixel
< 256);
612 if (color_count
[pixel
] > 0)
613 --color_count
[pixel
];
619 /* Register N colors from PIXELS as deallocated. */
622 unregister_colors (pixels
, n
)
623 unsigned long *pixels
;
627 for (i
= 0; i
< n
; ++i
)
628 unregister_color (pixels
[i
]);
632 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
633 doc
: /* Dump currently allocated colors to stderr. */)
638 fputc ('\n', stderr
);
640 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
643 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
646 fputc ('\n', stderr
);
648 fputc ('\t', stderr
);
652 fputc ('\n', stderr
);
656 #endif /* DEBUG_X_COLORS */
659 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
660 color values. Interrupt input must be blocked when this function
664 x_free_colors (f
, pixels
, npixels
)
666 unsigned long *pixels
;
669 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
671 /* If display has an immutable color map, freeing colors is not
672 necessary and some servers don't allow it. So don't do it. */
673 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
675 #ifdef DEBUG_X_COLORS
676 unregister_colors (pixels
, npixels
);
678 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
684 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
685 color values. Interrupt input must be blocked when this function
689 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
693 unsigned long *pixels
;
696 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
697 int class = dpyinfo
->visual
->class;
699 /* If display has an immutable color map, freeing colors is not
700 necessary and some servers don't allow it. So don't do it. */
701 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
703 #ifdef DEBUG_X_COLORS
704 unregister_colors (pixels
, npixels
);
706 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
711 /* Create and return a GC for use on frame F. GC values and mask
712 are given by XGCV and MASK. */
715 x_create_gc (f
, mask
, xgcv
)
722 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
729 /* Free GC which was used on frame F. */
737 xassert (--ngcs
>= 0);
738 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
742 #endif /* HAVE_X_WINDOWS */
745 /* W32 emulation of GCs */
748 x_create_gc (f
, mask
, xgcv
)
755 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
762 /* Free GC which was used on frame F. */
770 xassert (--ngcs
>= 0);
775 #endif /* WINDOWSNT */
778 /* Mac OS emulation of GCs */
780 extern XGCValues
*XCreateGC (void *, Window
, unsigned long, XGCValues
*);
783 x_create_gc (f
, mask
, xgcv
)
789 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
798 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
803 /* Like stricmp. Used to compare parts of font names which are in
808 const unsigned char *s1
, *s2
;
812 unsigned char c1
= tolower (*s1
);
813 unsigned char c2
= tolower (*s2
);
815 return c1
< c2
? -1 : 1;
820 return *s2
== 0 ? 0 : -1;
825 /* Like strlwr, which might not always be available. */
827 static unsigned char *
831 unsigned char *p
= s
;
840 /* Signal `error' with message S, and additional argument ARG. */
843 signal_error (s
, arg
)
847 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
851 /* If FRAME is nil, return a pointer to the selected frame.
852 Otherwise, check that FRAME is a live frame, and return a pointer
853 to it. NPARAM is the parameter number of FRAME, for
854 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
855 Lisp function definitions. */
857 static INLINE
struct frame
*
858 frame_or_selected_frame (frame
, nparam
)
863 frame
= selected_frame
;
865 CHECK_LIVE_FRAME (frame
);
866 return XFRAME (frame
);
870 /***********************************************************************
872 ***********************************************************************/
874 /* Initialize face cache and basic faces for frame F. */
880 /* Make a face cache, if F doesn't have one. */
881 if (FRAME_FACE_CACHE (f
) == NULL
)
882 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
884 #ifdef HAVE_WINDOW_SYSTEM
885 /* Make the image cache. */
886 if (FRAME_WINDOW_P (f
))
888 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
889 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
890 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
892 #endif /* HAVE_WINDOW_SYSTEM */
894 /* Realize basic faces. Must have enough information in frame
895 parameters to realize basic faces at this point. */
896 #ifdef HAVE_X_WINDOWS
897 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
900 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
903 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
905 if (!realize_basic_faces (f
))
910 /* Free face cache of frame F. Called from Fdelete_frame. */
916 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
920 free_face_cache (face_cache
);
921 FRAME_FACE_CACHE (f
) = NULL
;
924 #ifdef HAVE_WINDOW_SYSTEM
925 if (FRAME_WINDOW_P (f
))
927 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
930 --image_cache
->refcount
;
931 if (image_cache
->refcount
== 0)
932 free_image_cache (f
);
935 #endif /* HAVE_WINDOW_SYSTEM */
939 /* Clear face caches, and recompute basic faces for frame F. Call
940 this after changing frame parameters on which those faces depend,
941 or when realized faces have been freed due to changing attributes
945 recompute_basic_faces (f
)
948 if (FRAME_FACE_CACHE (f
))
950 clear_face_cache (0);
951 if (!realize_basic_faces (f
))
957 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
958 try to free unused fonts, too. */
961 clear_face_cache (clear_fonts_p
)
964 #ifdef HAVE_WINDOW_SYSTEM
965 Lisp_Object tail
, frame
;
969 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
971 struct x_display_info
*dpyinfo
;
973 /* Fonts are common for frames on one display, i.e. on
975 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
976 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
977 clear_font_table (dpyinfo
);
979 /* From time to time see if we can unload some fonts. This also
980 frees all realized faces on all frames. Fonts needed by
981 faces will be loaded again when faces are realized again. */
982 clear_font_table_count
= 0;
984 FOR_EACH_FRAME (tail
, frame
)
986 struct frame
*f
= XFRAME (frame
);
987 if (FRAME_WINDOW_P (f
)
988 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
989 free_all_realized_faces (frame
);
994 /* Clear GCs of realized faces. */
995 FOR_EACH_FRAME (tail
, frame
)
998 if (FRAME_WINDOW_P (f
))
1000 clear_face_gcs (FRAME_FACE_CACHE (f
));
1001 clear_image_cache (f
, 0);
1005 #endif /* HAVE_WINDOW_SYSTEM */
1009 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1010 doc
: /* Clear face caches on all frames.
1011 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1013 Lisp_Object thoroughly
;
1015 clear_face_cache (!NILP (thoroughly
));
1016 ++face_change_count
;
1017 ++windows_or_buffers_changed
;
1023 #ifdef HAVE_WINDOW_SYSTEM
1026 /* Remove fonts from the font table of DPYINFO except for the default
1027 ASCII fonts of frames on that display. Called from clear_face_cache
1028 from time to time. */
1031 clear_font_table (dpyinfo
)
1032 struct x_display_info
*dpyinfo
;
1036 /* Free those fonts that are not used by frames on DPYINFO. */
1037 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1039 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1040 Lisp_Object tail
, frame
;
1042 /* Check if slot is already free. */
1043 if (font_info
->name
== NULL
)
1046 /* Don't free a default font of some frame. */
1047 FOR_EACH_FRAME (tail
, frame
)
1049 struct frame
*f
= XFRAME (frame
);
1050 if (FRAME_WINDOW_P (f
)
1051 && font_info
->font
== FRAME_FONT (f
))
1059 if (font_info
->full_name
!= font_info
->name
)
1060 xfree (font_info
->full_name
);
1061 xfree (font_info
->name
);
1063 /* Free the font. */
1065 #ifdef HAVE_X_WINDOWS
1066 XFreeFont (dpyinfo
->display
, font_info
->font
);
1069 w32_unload_font (dpyinfo
, font_info
->font
);
1073 /* Mark font table slot free. */
1074 font_info
->font
= NULL
;
1075 font_info
->name
= font_info
->full_name
= NULL
;
1079 #endif /* HAVE_WINDOW_SYSTEM */
1083 /***********************************************************************
1085 ***********************************************************************/
1087 #ifdef HAVE_WINDOW_SYSTEM
1089 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1090 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1091 A bitmap specification is either a string, a file name, or a list
1092 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1093 HEIGHT is its height, and DATA is a string containing the bits of
1094 the pixmap. Bits are stored row by row, each row occupies
1095 \(WIDTH + 7)/8 bytes. */)
1101 if (STRINGP (object
))
1102 /* If OBJECT is a string, it's a file name. */
1104 else if (CONSP (object
))
1106 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1107 HEIGHT must be integers > 0, and DATA must be string large
1108 enough to hold a bitmap of the specified size. */
1109 Lisp_Object width
, height
, data
;
1111 height
= width
= data
= Qnil
;
1115 width
= XCAR (object
);
1116 object
= XCDR (object
);
1119 height
= XCAR (object
);
1120 object
= XCDR (object
);
1122 data
= XCAR (object
);
1126 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1128 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1130 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1135 return pixmap_p
? Qt
: Qnil
;
1139 /* Load a bitmap according to NAME (which is either a file name or a
1140 pixmap spec) for use on frame F. Value is the bitmap_id (see
1141 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1142 bitmap cannot be loaded, display a message saying so, and return
1143 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1144 if these pointers are not null. */
1147 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1150 unsigned int *w_ptr
, *h_ptr
;
1158 tem
= Fbitmap_spec_p (name
);
1160 wrong_type_argument (Qbitmap_spec_p
, name
);
1165 /* Decode a bitmap spec into a bitmap. */
1170 w
= XINT (Fcar (name
));
1171 h
= XINT (Fcar (Fcdr (name
)));
1172 bits
= Fcar (Fcdr (Fcdr (name
)));
1174 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1179 /* It must be a string -- a file name. */
1180 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1186 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1197 ++npixmaps_allocated
;
1200 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1203 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1209 #endif /* HAVE_WINDOW_SYSTEM */
1213 /***********************************************************************
1215 ***********************************************************************/
1217 #ifdef HAVE_WINDOW_SYSTEM
1219 /* Load font of face FACE which is used on frame F to display ASCII
1220 characters. The name of the font to load is determined by lface. */
1223 load_face_font (f
, face
)
1227 struct font_info
*font_info
= NULL
;
1229 int needs_overstrike
;
1231 face
->font_info_id
= -1;
1233 face
->font_name
= NULL
;
1235 font_name
= choose_face_font (f
, face
->lface
, Qnil
, &needs_overstrike
);
1240 font_info
= FS_LOAD_FONT (f
, font_name
);
1245 face
->font_info_id
= font_info
->font_idx
;
1246 face
->font
= font_info
->font
;
1247 face
->font_name
= font_info
->full_name
;
1248 face
->overstrike
= needs_overstrike
;
1251 x_free_gc (f
, face
->gc
);
1256 add_to_log ("Unable to load font %s",
1257 build_string (font_name
), Qnil
);
1261 #endif /* HAVE_WINDOW_SYSTEM */
1265 /***********************************************************************
1267 ***********************************************************************/
1269 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1270 RGB_LIST should contain (at least) 3 lisp integers.
1271 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1274 parse_rgb_list (rgb_list
, color
)
1275 Lisp_Object rgb_list
;
1278 #define PARSE_RGB_LIST_FIELD(field) \
1279 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1281 color->field = XINT (XCAR (rgb_list)); \
1282 rgb_list = XCDR (rgb_list); \
1287 PARSE_RGB_LIST_FIELD (red
);
1288 PARSE_RGB_LIST_FIELD (green
);
1289 PARSE_RGB_LIST_FIELD (blue
);
1295 /* Lookup on frame F the color described by the lisp string COLOR.
1296 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1297 non-zero, then the `standard' definition of the same color is
1301 tty_lookup_color (f
, color
, tty_color
, std_color
)
1304 XColor
*tty_color
, *std_color
;
1306 Lisp_Object frame
, color_desc
;
1308 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1311 XSETFRAME (frame
, f
);
1313 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1314 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1318 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1321 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1323 rgb
= XCDR (XCDR (color_desc
));
1324 if (! parse_rgb_list (rgb
, tty_color
))
1327 /* Should we fill in STD_COLOR too? */
1330 /* Default STD_COLOR to the same as TTY_COLOR. */
1331 *std_color
= *tty_color
;
1333 /* Do a quick check to see if the returned descriptor is
1334 actually _exactly_ equal to COLOR, otherwise we have to
1335 lookup STD_COLOR separately. If it's impossible to lookup
1336 a standard color, we just give up and use TTY_COLOR. */
1337 if ((!STRINGP (XCAR (color_desc
))
1338 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1339 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1341 /* Look up STD_COLOR separately. */
1342 rgb
= call1 (Qtty_color_standard_values
, color
);
1343 if (! parse_rgb_list (rgb
, std_color
))
1350 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1351 /* We were called early during startup, and the colors are not
1352 yet set up in tty-defined-color-alist. Don't return a failure
1353 indication, since this produces the annoying "Unable to
1354 load color" messages in the *Messages* buffer. */
1357 /* tty-color-desc seems to have returned a bad value. */
1361 /* A version of defined_color for non-X frames. */
1364 tty_defined_color (f
, color_name
, color_def
, alloc
)
1373 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1375 color_def
->blue
= 0;
1376 color_def
->green
= 0;
1379 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, NULL
);
1381 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1383 if (strcmp (color_name
, "unspecified-fg") == 0)
1384 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1385 else if (strcmp (color_name
, "unspecified-bg") == 0)
1386 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1389 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1396 /* Decide if color named COLOR_NAME is valid for the display
1397 associated with the frame F; if so, return the rgb values in
1398 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1400 This does the right thing for any type of frame. */
1403 defined_color (f
, color_name
, color_def
, alloc
)
1409 if (!FRAME_WINDOW_P (f
))
1410 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1411 #ifdef HAVE_X_WINDOWS
1412 else if (FRAME_X_P (f
))
1413 return x_defined_color (f
, color_name
, color_def
, alloc
);
1416 else if (FRAME_W32_P (f
))
1417 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1420 else if (FRAME_MAC_P (f
))
1421 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1428 /* Given the index IDX of a tty color on frame F, return its name, a
1432 tty_color_name (f
, idx
)
1436 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1439 Lisp_Object coldesc
;
1441 XSETFRAME (frame
, f
);
1442 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1444 if (!NILP (coldesc
))
1445 return XCAR (coldesc
);
1448 /* We can have an MSDOG frame under -nw for a short window of
1449 opportunity before internal_terminal_init is called. DTRT. */
1450 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1451 return msdos_stdcolor_name (idx
);
1454 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1455 return build_string (unspecified_fg
);
1456 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1457 return build_string (unspecified_bg
);
1460 return vga_stdcolor_name (idx
);
1463 return Qunspecified
;
1467 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1468 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1471 face_color_gray_p (f
, color_name
)
1478 if (defined_color (f
, color_name
, &color
, 0))
1479 gray_p
= ((abs (color
.red
- color
.green
)
1480 < max (color
.red
, color
.green
) / 20)
1481 && (abs (color
.green
- color
.blue
)
1482 < max (color
.green
, color
.blue
) / 20)
1483 && (abs (color
.blue
- color
.red
)
1484 < max (color
.blue
, color
.red
) / 20));
1492 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1493 BACKGROUND_P non-zero means the color will be used as background
1497 face_color_supported_p (f
, color_name
, background_p
)
1505 XSETFRAME (frame
, f
);
1507 #ifdef HAVE_X_WINDOWS
1509 ? (!NILP (Fxw_display_color_p (frame
))
1510 || xstricmp (color_name
, "black") == 0
1511 || xstricmp (color_name
, "white") == 0
1513 && face_color_gray_p (f
, color_name
))
1514 || (!NILP (Fx_display_grayscale_p (frame
))
1515 && face_color_gray_p (f
, color_name
)))
1518 tty_defined_color (f
, color_name
, ¬_used
, 0);
1522 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1523 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1524 FRAME specifies the frame and thus the display for interpreting COLOR.
1525 If FRAME is nil or omitted, use the selected frame. */)
1527 Lisp_Object color
, frame
;
1531 CHECK_STRING (color
);
1533 frame
= selected_frame
;
1535 CHECK_FRAME (frame
);
1537 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1541 DEFUN ("color-supported-p", Fcolor_supported_p
,
1542 Scolor_supported_p
, 1, 3, 0,
1543 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1544 BACKGROUND-P non-nil means COLOR is used as a background.
1545 If FRAME is nil or omitted, use the selected frame.
1546 COLOR must be a valid color name. */)
1547 (color
, frame
, background_p
)
1548 Lisp_Object frame
, color
, background_p
;
1552 CHECK_STRING (color
);
1554 frame
= selected_frame
;
1556 CHECK_FRAME (frame
);
1558 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1564 /* Load color with name NAME for use by face FACE on frame F.
1565 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1566 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1567 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1568 pixel color. If color cannot be loaded, display a message, and
1569 return the foreground, background or underline color of F, but
1570 record that fact in flags of the face so that we don't try to free
1574 load_color (f
, face
, name
, target_index
)
1578 enum lface_attribute_index target_index
;
1582 xassert (STRINGP (name
));
1583 xassert (target_index
== LFACE_FOREGROUND_INDEX
1584 || target_index
== LFACE_BACKGROUND_INDEX
1585 || target_index
== LFACE_UNDERLINE_INDEX
1586 || target_index
== LFACE_OVERLINE_INDEX
1587 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1588 || target_index
== LFACE_BOX_INDEX
);
1590 /* if the color map is full, defined_color will return a best match
1591 to the values in an existing cell. */
1592 if (!defined_color (f
, SDATA (name
), &color
, 1))
1594 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1596 switch (target_index
)
1598 case LFACE_FOREGROUND_INDEX
:
1599 face
->foreground_defaulted_p
= 1;
1600 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1603 case LFACE_BACKGROUND_INDEX
:
1604 face
->background_defaulted_p
= 1;
1605 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1608 case LFACE_UNDERLINE_INDEX
:
1609 face
->underline_defaulted_p
= 1;
1610 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1613 case LFACE_OVERLINE_INDEX
:
1614 face
->overline_color_defaulted_p
= 1;
1615 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1618 case LFACE_STRIKE_THROUGH_INDEX
:
1619 face
->strike_through_color_defaulted_p
= 1;
1620 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1623 case LFACE_BOX_INDEX
:
1624 face
->box_color_defaulted_p
= 1;
1625 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1634 ++ncolors_allocated
;
1641 #ifdef HAVE_WINDOW_SYSTEM
1643 /* Load colors for face FACE which is used on frame F. Colors are
1644 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1645 of ATTRS. If the background color specified is not supported on F,
1646 try to emulate gray colors with a stipple from Vface_default_stipple. */
1649 load_face_colors (f
, face
, attrs
)
1656 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1657 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1659 /* Swap colors if face is inverse-video. */
1660 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1668 /* Check for support for foreground, not for background because
1669 face_color_supported_p is smart enough to know that grays are
1670 "supported" as background because we are supposed to use stipple
1672 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1673 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1675 x_destroy_bitmap (f
, face
->stipple
);
1676 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1677 &face
->pixmap_w
, &face
->pixmap_h
);
1680 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1681 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1685 /* Free color PIXEL on frame F. */
1688 unload_color (f
, pixel
)
1690 unsigned long pixel
;
1692 #ifdef HAVE_X_WINDOWS
1696 x_free_colors (f
, &pixel
, 1);
1703 /* Free colors allocated for FACE. */
1706 free_face_colors (f
, face
)
1710 #ifdef HAVE_X_WINDOWS
1711 if (face
->colors_copied_bitwise_p
)
1716 if (!face
->foreground_defaulted_p
)
1718 x_free_colors (f
, &face
->foreground
, 1);
1719 IF_DEBUG (--ncolors_allocated
);
1722 if (!face
->background_defaulted_p
)
1724 x_free_colors (f
, &face
->background
, 1);
1725 IF_DEBUG (--ncolors_allocated
);
1728 if (face
->underline_p
1729 && !face
->underline_defaulted_p
)
1731 x_free_colors (f
, &face
->underline_color
, 1);
1732 IF_DEBUG (--ncolors_allocated
);
1735 if (face
->overline_p
1736 && !face
->overline_color_defaulted_p
)
1738 x_free_colors (f
, &face
->overline_color
, 1);
1739 IF_DEBUG (--ncolors_allocated
);
1742 if (face
->strike_through_p
1743 && !face
->strike_through_color_defaulted_p
)
1745 x_free_colors (f
, &face
->strike_through_color
, 1);
1746 IF_DEBUG (--ncolors_allocated
);
1749 if (face
->box
!= FACE_NO_BOX
1750 && !face
->box_color_defaulted_p
)
1752 x_free_colors (f
, &face
->box_color
, 1);
1753 IF_DEBUG (--ncolors_allocated
);
1757 #endif /* HAVE_X_WINDOWS */
1760 #endif /* HAVE_WINDOW_SYSTEM */
1764 /***********************************************************************
1766 ***********************************************************************/
1768 /* An enumerator for each field of an XLFD font name. */
1789 /* An enumerator for each possible slant value of a font. Taken from
1790 the XLFD specification. */
1798 XLFD_SLANT_REVERSE_ITALIC
,
1799 XLFD_SLANT_REVERSE_OBLIQUE
,
1803 /* Relative font weight according to XLFD documentation. */
1807 XLFD_WEIGHT_UNKNOWN
,
1808 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1809 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1810 XLFD_WEIGHT_LIGHT
, /* 30 */
1811 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1812 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1813 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1814 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1815 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1816 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1819 /* Relative proportionate width. */
1823 XLFD_SWIDTH_UNKNOWN
,
1824 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1825 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1826 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1827 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1828 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1829 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1830 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1831 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1832 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1835 /* Structure used for tables mapping XLFD weight, slant, and width
1836 names to numeric and symbolic values. */
1842 Lisp_Object
*symbol
;
1845 /* Table of XLFD slant names and their numeric and symbolic
1846 representations. This table must be sorted by slant names in
1849 static struct table_entry slant_table
[] =
1851 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1852 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1853 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1854 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1855 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1856 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1859 /* Table of XLFD weight names. This table must be sorted by weight
1860 names in ascending order. */
1862 static struct table_entry weight_table
[] =
1864 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1865 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1866 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1867 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1868 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1869 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1870 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1871 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1872 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1873 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1874 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1875 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1876 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1877 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1878 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1879 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1882 /* Table of XLFD width names. This table must be sorted by width
1883 names in ascending order. */
1885 static struct table_entry swidth_table
[] =
1887 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1888 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1889 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1890 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1891 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1892 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1893 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1894 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1895 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1896 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1897 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1898 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1899 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1900 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1901 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1904 /* Structure used to hold the result of splitting font names in XLFD
1905 format into their fields. */
1909 /* The original name which is modified destructively by
1910 split_font_name. The pointer is kept here to be able to free it
1911 if it was allocated from the heap. */
1914 /* Font name fields. Each vector element points into `name' above.
1915 Fields are NUL-terminated. */
1916 char *fields
[XLFD_LAST
];
1918 /* Numeric values for those fields that interest us. See
1919 split_font_name for which these are. */
1920 int numeric
[XLFD_LAST
];
1922 /* If the original name matches one of Vface_font_rescale_alist,
1923 the value is the corresponding rescale ratio. Otherwise, the
1925 double rescale_ratio
;
1927 /* Lower value mean higher priority. */
1928 int registry_priority
;
1931 /* The frame in effect when sorting font names. Set temporarily in
1932 sort_fonts so that it is available in font comparison functions. */
1934 static struct frame
*font_frame
;
1936 /* Order by which font selection chooses fonts. The default values
1937 mean `first, find a best match for the font width, then for the
1938 font height, then for weight, then for slant.' This variable can be
1939 set via set-face-font-sort-order. */
1942 static int font_sort_order
[4] = {
1943 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1946 static int font_sort_order
[4];
1949 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1950 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1951 is a pointer to the matching table entry or null if no table entry
1954 static struct table_entry
*
1955 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1956 struct table_entry
*table
;
1958 struct font_name
*font
;
1961 /* Function split_font_name converts fields to lower-case, so there
1962 is no need to use xstrlwr or xstricmp here. */
1963 char *s
= font
->fields
[field_index
];
1964 int low
, mid
, high
, cmp
;
1971 mid
= (low
+ high
) / 2;
1972 cmp
= strcmp (table
[mid
].name
, s
);
1986 /* Return a numeric representation for font name field
1987 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
1988 has DIM entries. Value is the numeric value found or DFLT if no
1989 table entry matches. This function is used to translate weight,
1990 slant, and swidth names of XLFD font names to numeric values. */
1993 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
1994 struct table_entry
*table
;
1996 struct font_name
*font
;
2000 struct table_entry
*p
;
2001 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2002 return p
? p
->numeric
: dflt
;
2006 /* Return a symbolic representation for font name field
2007 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2008 has DIM entries. Value is the symbolic value found or DFLT if no
2009 table entry matches. This function is used to translate weight,
2010 slant, and swidth names of XLFD font names to symbols. */
2012 static INLINE Lisp_Object
2013 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2014 struct table_entry
*table
;
2016 struct font_name
*font
;
2020 struct table_entry
*p
;
2021 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2022 return p
? *p
->symbol
: dflt
;
2026 /* Return a numeric value for the slant of the font given by FONT. */
2029 xlfd_numeric_slant (font
)
2030 struct font_name
*font
;
2032 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2033 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2037 /* Return a symbol representing the weight of the font given by FONT. */
2039 static INLINE Lisp_Object
2040 xlfd_symbolic_slant (font
)
2041 struct font_name
*font
;
2043 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2044 font
, XLFD_SLANT
, Qnormal
);
2048 /* Return a numeric value for the weight of the font given by FONT. */
2051 xlfd_numeric_weight (font
)
2052 struct font_name
*font
;
2054 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2055 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2059 /* Return a symbol representing the slant of the font given by FONT. */
2061 static INLINE Lisp_Object
2062 xlfd_symbolic_weight (font
)
2063 struct font_name
*font
;
2065 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2066 font
, XLFD_WEIGHT
, Qnormal
);
2070 /* Return a numeric value for the swidth of the font whose XLFD font
2071 name fields are found in FONT. */
2074 xlfd_numeric_swidth (font
)
2075 struct font_name
*font
;
2077 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2078 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2082 /* Return a symbolic value for the swidth of FONT. */
2084 static INLINE Lisp_Object
2085 xlfd_symbolic_swidth (font
)
2086 struct font_name
*font
;
2088 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2089 font
, XLFD_SWIDTH
, Qnormal
);
2093 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2094 entries. Value is a pointer to the matching table entry or null if
2095 no element of TABLE contains SYMBOL. */
2097 static struct table_entry
*
2098 face_value (table
, dim
, symbol
)
2099 struct table_entry
*table
;
2105 xassert (SYMBOLP (symbol
));
2107 for (i
= 0; i
< dim
; ++i
)
2108 if (EQ (*table
[i
].symbol
, symbol
))
2111 return i
< dim
? table
+ i
: NULL
;
2115 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2116 entries. Value is -1 if SYMBOL is not found in TABLE. */
2119 face_numeric_value (table
, dim
, symbol
)
2120 struct table_entry
*table
;
2124 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2125 return p
? p
->numeric
: -1;
2129 /* Return a numeric value representing the weight specified by Lisp
2130 symbol WEIGHT. Value is one of the enumerators of enum
2134 face_numeric_weight (weight
)
2137 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2141 /* Return a numeric value representing the slant specified by Lisp
2142 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2145 face_numeric_slant (slant
)
2148 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2152 /* Return a numeric value representing the swidth specified by Lisp
2153 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2156 face_numeric_swidth (width
)
2159 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2163 split_font_name_into_vector (fontname
)
2164 Lisp_Object fontname
;
2166 struct font_name font
;
2170 font
.name
= LSTRDUPA (fontname
);
2171 if (! split_font_name (NULL
, &font
, 0))
2173 vec
= Fmake_vector (make_number (XLFD_LAST
), Qnil
);
2174 for (i
= 0; i
< XLFD_LAST
; i
++)
2175 if (font
.fields
[i
][0] != '*')
2176 ASET (vec
, i
, build_string (font
.fields
[i
]));
2181 build_font_name_from_vector (vec
)
2184 struct font_name font
;
2185 Lisp_Object fontname
;
2189 for (i
= 0; i
< XLFD_LAST
; i
++)
2191 font
.fields
[i
] = (NILP (AREF (vec
, i
))
2192 ? "*" : (char *) SDATA (AREF (vec
, i
)));
2193 if ((i
== XLFD_FAMILY
|| i
== XLFD_REGISTRY
)
2194 && (p
= strchr (font
.fields
[i
], '-')))
2196 char *p1
= STRDUPA (font
.fields
[i
]);
2198 p1
[p
- font
.fields
[i
]] = '\0';
2199 if (i
== XLFD_FAMILY
)
2201 font
.fields
[XLFD_FOUNDRY
] = p1
;
2202 font
.fields
[XLFD_FAMILY
] = p
+ 1;
2206 font
.fields
[XLFD_REGISTRY
] = p1
;
2207 font
.fields
[XLFD_ENCODING
] = p
+ 1;
2213 p
= build_font_name (&font
);
2214 fontname
= build_string (p
);
2219 #ifdef HAVE_WINDOW_SYSTEM
2221 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2225 struct font_name
*font
;
2227 /* Function split_font_name converts fields to lower-case, so there
2228 is no need to use tolower here. */
2229 return *font
->fields
[XLFD_SPACING
] != 'p';
2233 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2235 The actual height of the font when displayed on F depends on the
2236 resolution of both the font and frame. For example, a 10pt font
2237 designed for a 100dpi display will display larger than 10pt on a
2238 75dpi display. (It's not unusual to use fonts not designed for the
2239 display one is using. For example, some intlfonts are available in
2240 72dpi versions, only.)
2242 Value is the real point size of FONT on frame F, or 0 if it cannot
2245 By side effect, set FONT->numeric[XLFD_PIXEL_SIZE]. */
2248 xlfd_point_size (f
, font
)
2250 struct font_name
*font
;
2252 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2253 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2257 if (*pixel_field
== '[')
2259 /* The pixel size field is `[A B C D]' which specifies
2260 a transformation matrix.
2266 by which all glyphs of the font are transformed. The spec
2267 says that s scalar value N for the pixel size is equivalent
2268 to A = N * resx/resy, B = C = 0, D = N. */
2269 char *start
= pixel_field
+ 1, *end
;
2273 for (i
= 0; i
< 4; ++i
)
2275 matrix
[i
] = strtod (start
, &end
);
2282 pixel
= atoi (pixel_field
);
2284 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel
;
2288 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2294 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2295 of frame F. This function is used to guess a point size of font
2296 when only the pixel height of the font is available. */
2299 pixel_point_size (f
, pixel
)
2303 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2307 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2308 point size of one dot. */
2309 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2310 int_pt
= real_pt
+ 0.5;
2316 /* Return a rescaling ratio of a font of NAME. */
2319 font_rescale_ratio (name
)
2322 Lisp_Object tail
, elt
;
2324 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2327 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2328 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2329 return XFLOAT_DATA (XCDR (elt
));
2335 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2336 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2337 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2338 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2339 zero if the font name doesn't have the format we expect. The
2340 expected format is a font name that starts with a `-' and has
2341 XLFD_LAST fields separated by `-'. */
2344 split_font_name (f
, font
, numeric_p
)
2346 struct font_name
*font
;
2351 double rescale_ratio
;
2354 /* This must be done before splitting the font name. */
2355 rescale_ratio
= font_rescale_ratio (font
->name
);
2357 if (*font
->name
== '-')
2359 char *p
= xstrlwr (font
->name
) + 1;
2361 while (i
< XLFD_LAST
)
2363 font
->fields
[i
] = p
;
2366 /* Pixel and point size may be of the form `[....]'. For
2367 BNF, see XLFD spec, chapter 4. Negative values are
2368 indicated by tilde characters which we replace with
2369 `-' characters, here. */
2371 && (i
- 1 == XLFD_PIXEL_SIZE
2372 || i
- 1 == XLFD_POINT_SIZE
))
2377 for (++p
; *p
&& *p
!= ']'; ++p
)
2381 /* Check that the matrix contains 4 floating point
2383 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2386 if (strtod (start
, &end
) == 0 && start
== end
)
2393 while (*p
&& *p
!= '-')
2403 success_p
= i
== XLFD_LAST
;
2405 /* If requested, and font name was in the expected format,
2406 compute numeric values for some fields. */
2407 if (numeric_p
&& success_p
)
2409 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2410 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2411 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2412 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2413 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2414 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2415 font
->rescale_ratio
= rescale_ratio
;
2418 /* Initialize it to zero. It will be overridden by font_list while
2419 trying alternate registries. */
2420 font
->registry_priority
= 0;
2426 /* Build an XLFD font name from font name fields in FONT. Value is a
2427 pointer to the font name, which is allocated via xmalloc. */
2430 build_font_name (font
)
2431 struct font_name
*font
;
2435 char *font_name
= (char *) xmalloc (size
);
2436 int total_length
= 0;
2438 for (i
= 0; i
< XLFD_LAST
; ++i
)
2440 /* Add 1 because of the leading `-'. */
2441 int len
= strlen (font
->fields
[i
]) + 1;
2443 /* Reallocate font_name if necessary. Add 1 for the final
2445 if (total_length
+ len
+ 1 >= size
)
2447 int new_size
= max (2 * size
, size
+ len
+ 1);
2448 int sz
= new_size
* sizeof *font_name
;
2449 font_name
= (char *) xrealloc (font_name
, sz
);
2453 font_name
[total_length
] = '-';
2454 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2455 total_length
+= len
;
2458 font_name
[total_length
] = 0;
2463 /* Free an array FONTS of N font_name structures. This frees FONTS
2464 itself and all `name' fields in its elements. */
2467 free_font_names (fonts
, n
)
2468 struct font_name
*fonts
;
2472 xfree (fonts
[--n
].name
);
2477 /* Sort vector FONTS of font_name structures which contains NFONTS
2478 elements using qsort and comparison function CMPFN. F is the frame
2479 on which the fonts will be used. The global variable font_frame
2480 is temporarily set to F to make it available in CMPFN. */
2483 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2485 struct font_name
*fonts
;
2487 int (*cmpfn
) P_ ((const void *, const void *));
2490 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2495 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2496 display in x_display_list. FONTS is a pointer to a vector of
2497 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2498 alternative patterns from Valternate_fontname_alist if no fonts are
2499 found matching PATTERN.
2501 For all fonts found, set FONTS[i].name to the name of the font,
2502 allocated via xmalloc, and split font names into fields. Ignore
2503 fonts that we can't parse. Value is the number of fonts found. */
2506 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2509 struct font_name
**pfonts
;
2510 int nfonts
, try_alternatives_p
;
2514 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2515 better to do it the other way around. */
2517 Lisp_Object lpattern
, tem
;
2518 struct font_name
*fonts
= 0;
2519 int num_fonts
= nfonts
;
2522 lpattern
= build_string (pattern
);
2524 /* Get the list of fonts matching PATTERN. */
2527 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2530 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2533 if (nfonts
< 0 && CONSP (lfonts
))
2534 num_fonts
= XFASTINT (Flength (lfonts
));
2536 /* Make a copy of the font names we got from X, and
2537 split them into fields. */
2539 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2541 Lisp_Object elt
, tail
;
2542 const char *name
= SDATA (XCAR (tem
));
2544 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2545 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2549 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2560 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2564 /* Make a copy of the font name. */
2565 fonts
[n
].name
= xstrdup (name
);
2567 if (split_font_name (f
, fonts
+ n
, 1))
2569 if (font_scalable_p (fonts
+ n
)
2570 && !may_use_scalable_font_p (name
))
2573 xfree (fonts
[n
].name
);
2579 xfree (fonts
[n
].name
);
2582 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2583 if (n
== 0 && try_alternatives_p
)
2585 Lisp_Object list
= Valternate_fontname_alist
;
2593 while (CONSP (list
))
2595 Lisp_Object entry
= XCAR (list
);
2597 && STRINGP (XCAR (entry
))
2598 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2605 Lisp_Object patterns
= XCAR (list
);
2608 while (CONSP (patterns
)
2609 /* If list is screwed up, give up. */
2610 && (name
= XCAR (patterns
),
2612 /* Ignore patterns equal to PATTERN because we tried that
2613 already with no success. */
2614 && (strcmp (SDATA (name
), pattern
) == 0
2615 || (n
= x_face_list_fonts (f
, SDATA (name
),
2618 patterns
= XCDR (patterns
);
2626 /* Check if a font matching pattern_offset_t on frame F is available
2627 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2628 a font name pattern is generated from FAMILY and REGISTRY. */
2631 face_font_available_p (f
, pattern
)
2633 Lisp_Object pattern
;
2637 if (! STRINGP (pattern
))
2639 Lisp_Object family
, registry
;
2640 char *family_str
, *registry_str
, *pattern_str
;
2642 CHECK_CONS (pattern
);
2643 family
= XCAR (pattern
);
2648 CHECK_STRING (family
);
2649 family_str
= (char *) SDATA (family
);
2651 registry
= XCDR (pattern
);
2652 if (NILP (registry
))
2656 CHECK_STRING (registry
);
2657 registry_str
= (char *) SDATA (registry
);
2660 pattern_str
= (char *) alloca (strlen (family_str
)
2661 + strlen (registry_str
)
2663 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2664 strcat (pattern_str
, family_str
);
2665 strcat (pattern_str
, "-*-");
2666 strcat (pattern_str
, registry_str
);
2667 if (!index (registry_str
, '-'))
2669 if (registry_str
[strlen (registry_str
) - 1] == '*')
2670 strcat (pattern_str
, "-*");
2672 strcat (pattern_str
, "*-*");
2674 pattern
= build_string (pattern_str
);
2677 /* Get the list of fonts matching PATTERN. */
2680 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2683 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2685 return XINT (Flength (fonts
));
2689 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2690 using comparison function CMPFN. Value is the number of fonts
2691 found. If value is non-zero, *FONTS is set to a vector of
2692 font_name structures allocated from the heap containing matching
2693 fonts. Each element of *FONTS contains a name member that is also
2694 allocated from the heap. Font names in these structures are split
2695 into fields. Use free_font_names to free such an array. */
2698 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2701 int (*cmpfn
) P_ ((const void *, const void *));
2702 struct font_name
**fonts
;
2706 /* Get the list of fonts matching pattern. 100 should suffice. */
2707 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2708 if (INTEGERP (Vfont_list_limit
))
2709 nfonts
= XINT (Vfont_list_limit
);
2712 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2714 /* Sort the resulting array and return it in *FONTS. If no
2715 fonts were found, make sure to set *FONTS to null. */
2717 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2728 /* Compare two font_name structures *A and *B. Value is analogous to
2729 strcmp. Sort order is given by the global variable
2730 font_sort_order. Font names are sorted so that, everything else
2731 being equal, fonts with a resolution closer to that of the frame on
2732 which they are used are listed first. The global variable
2733 font_frame is the frame on which we operate. */
2736 cmp_font_names (a
, b
)
2739 struct font_name
*x
= (struct font_name
*) a
;
2740 struct font_name
*y
= (struct font_name
*) b
;
2743 /* All strings have been converted to lower-case by split_font_name,
2744 so we can use strcmp here. */
2745 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2750 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2752 int j
= font_sort_order
[i
];
2753 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2758 /* Everything else being equal, we prefer fonts with an
2759 y-resolution closer to that of the frame. */
2760 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2761 int x_resy
= x
->numeric
[XLFD_RESY
];
2762 int y_resy
= y
->numeric
[XLFD_RESY
];
2763 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2771 /* Get a sorted list of fonts matching PATTERN on frame F. If PATTERN
2772 is nil, list fonts matching FAMILY and REGISTRY. FAMILY is a
2773 family name string or nil. REGISTRY is a registry name string.
2774 Set *FONTS to a vector of font_name structures allocated from the
2775 heap containing the fonts found. Value is the number of fonts
2779 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2781 Lisp_Object pattern
, family
, registry
;
2782 struct font_name
**fonts
;
2784 char *pattern_str
, *family_str
, *registry_str
;
2788 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2789 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2791 pattern_str
= (char *) alloca (strlen (family_str
)
2792 + strlen (registry_str
)
2794 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2795 strcat (pattern_str
, family_str
);
2796 strcat (pattern_str
, "-*-");
2797 strcat (pattern_str
, registry_str
);
2798 if (!index (registry_str
, '-'))
2800 if (registry_str
[strlen (registry_str
) - 1] == '*')
2801 strcat (pattern_str
, "-*");
2803 strcat (pattern_str
, "*-*");
2807 pattern_str
= (char *) SDATA (pattern
);
2809 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2813 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2814 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2815 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2818 static struct font_name
*
2819 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2820 struct font_name
*fonts1
, *fonts2
;
2821 int nfonts1
, nfonts2
;
2823 int new_nfonts
= nfonts1
+ nfonts2
;
2824 struct font_name
*new_fonts
;
2826 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2827 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2828 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2835 /* Get a sorted list of fonts of family FAMILY on frame F.
2837 If PATTERN is non-nil, list fonts matching that pattern.
2839 If REGISTRY is non-nil, it is a list of registry (and encoding)
2840 names. Return fonts with those registries and the alternative
2841 registries from Vface_alternative_font_registry_alist.
2843 If REGISTRY is nil return fonts of any registry.
2845 Set *FONTS to a vector of font_name structures allocated from the
2846 heap containing the fonts found. Value is the number of fonts
2850 font_list (f
, pattern
, family
, registry
, fonts
)
2852 Lisp_Object pattern
, family
, registry
;
2853 struct font_name
**fonts
;
2859 if (NILP (registry
))
2860 return font_list_1 (f
, pattern
, family
, registry
, fonts
);
2862 for (reg_prio
= 0, nfonts
= 0; CONSP (registry
); registry
= XCDR (registry
))
2864 Lisp_Object elt
, alter
;
2866 struct font_name
*fonts2
;
2868 elt
= XCAR (registry
);
2869 alter
= Fassoc (elt
, Vface_alternative_font_registry_alist
);
2871 alter
= Fcons (elt
, Qnil
);
2872 for (; CONSP (alter
); alter
= XCDR (alter
), reg_prio
++)
2874 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
), &fonts2
);
2878 for (i
= 0; i
< nfonts2
; i
++)
2879 fonts2
[i
].registry_priority
= reg_prio
;
2881 *fonts
= concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
);
2893 /* Remove elements from LIST whose cars are `equal'. Called from
2894 x-family-fonts and x-font-family-list to remove duplicate font
2898 remove_duplicates (list
)
2901 Lisp_Object tail
= list
;
2903 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2905 Lisp_Object next
= XCDR (tail
);
2906 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2907 XSETCDR (tail
, XCDR (next
));
2914 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2915 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2916 If FAMILY is omitted or nil, list all families.
2917 Otherwise, FAMILY must be a string, possibly containing wildcards
2919 If FRAME is omitted or nil, use the selected frame.
2920 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2921 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2922 FAMILY is the font family name. POINT-SIZE is the size of the
2923 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2924 width, weight and slant of the font. These symbols are the same as for
2925 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2926 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2927 giving the registry and encoding of the font.
2928 The result list is sorted according to the current setting of
2929 the face font sort order. */)
2931 Lisp_Object family
, frame
;
2933 struct frame
*f
= check_x_frame (frame
);
2934 struct font_name
*fonts
;
2937 struct gcpro gcpro1
;
2940 CHECK_STRING (family
);
2944 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2945 for (i
= nfonts
- 1; i
>= 0; --i
)
2947 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2950 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2951 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2952 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2953 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2954 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2955 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2956 tem
= build_font_name (fonts
+ i
);
2957 ASET (v
, 6, build_string (tem
));
2958 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2959 fonts
[i
].fields
[XLFD_ENCODING
]);
2960 ASET (v
, 7, build_string (tem
));
2963 result
= Fcons (v
, result
);
2966 remove_duplicates (result
);
2967 free_font_names (fonts
, nfonts
);
2973 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2975 doc
: /* Return a list of available font families on FRAME.
2976 If FRAME is omitted or nil, use the selected frame.
2977 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2978 is a font family, and FIXED-P is non-nil if fonts of that family
2979 are fixed-pitch. */)
2983 struct frame
*f
= check_x_frame (frame
);
2985 struct font_name
*fonts
;
2987 struct gcpro gcpro1
;
2988 int count
= SPECPDL_INDEX ();
2990 /* Let's consider all fonts. */
2991 specbind (intern ("font-list-limit"), make_number (-1));
2992 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2996 for (i
= nfonts
- 1; i
>= 0; --i
)
2997 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2998 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
3001 remove_duplicates (result
);
3002 free_font_names (fonts
, nfonts
);
3004 return unbind_to (count
, result
);
3008 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
3009 doc
: /* Return a list of the names of available fonts matching PATTERN.
3010 If optional arguments FACE and FRAME are specified, return only fonts
3011 the same size as FACE on FRAME.
3012 PATTERN is a string, perhaps with wildcard characters;
3013 the * character matches any substring, and
3014 the ? character matches any single character.
3015 PATTERN is case-insensitive.
3016 FACE is a face name--a symbol.
3018 The return value is a list of strings, suitable as arguments to
3021 Fonts Emacs can't use may or may not be excluded
3022 even if they match PATTERN and FACE.
3023 The optional fourth argument MAXIMUM sets a limit on how many
3024 fonts to match. The first MAXIMUM fonts are reported.
3025 The optional fifth argument WIDTH, if specified, is a number of columns
3026 occupied by a character of a font. In that case, return only fonts
3027 the WIDTH times as wide as FACE on FRAME. */)
3028 (pattern
, face
, frame
, maximum
, width
)
3029 Lisp_Object pattern
, face
, frame
, maximum
, width
;
3036 CHECK_STRING (pattern
);
3042 CHECK_NATNUM (maximum
);
3043 maxnames
= XINT (maximum
);
3047 CHECK_NUMBER (width
);
3049 /* We can't simply call check_x_frame because this function may be
3050 called before any frame is created. */
3051 f
= frame_or_selected_frame (frame
, 2);
3052 if (!FRAME_WINDOW_P (f
))
3054 /* Perhaps we have not yet created any frame. */
3059 /* Determine the width standard for comparison with the fonts we find. */
3065 /* This is of limited utility since it works with character
3066 widths. Keep it for compatibility. --gerd. */
3067 int face_id
= lookup_named_face (f
, face
);
3068 struct face
*face
= (face_id
< 0
3070 : FACE_FROM_ID (f
, face_id
));
3073 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3074 not maximum as on X. Redefine here. */
3076 #define FONT_WIDTH FONT_MAX_WIDTH
3079 if (face
&& face
->font
)
3080 size
= FONT_WIDTH (face
->font
);
3082 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3085 size
*= XINT (width
);
3089 Lisp_Object args
[2];
3091 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3093 /* We don't have to check fontsets. */
3095 args
[1] = list_fontsets (f
, pattern
, size
);
3096 return Fnconc (2, args
);
3100 #endif /* HAVE_WINDOW_SYSTEM */
3104 /***********************************************************************
3106 ***********************************************************************/
3108 /* Access face attributes of face LFACE, a Lisp vector. */
3110 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3111 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3112 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3113 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3114 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3115 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3116 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3117 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3118 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3119 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3120 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3121 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3122 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3123 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3124 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3125 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3126 #define LFACE_FONTSET(LFACE) AREF ((LFACE), LFACE_FONTSET_INDEX)
3128 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3129 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3131 #define LFACEP(LFACE) \
3133 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3134 && EQ (AREF (LFACE, 0), Qface))
3139 /* Check consistency of Lisp face attribute vector ATTRS. */
3142 check_lface_attrs (attrs
)
3145 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3146 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3147 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3148 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3149 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3150 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3151 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3152 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3153 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3154 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3155 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3156 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3157 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3158 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3159 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3160 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3161 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3162 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3163 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3164 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3165 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3166 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3167 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3168 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3169 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3170 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3171 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3172 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3173 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3174 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3175 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3176 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3177 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3178 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3179 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3180 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3181 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3182 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3183 #ifdef HAVE_WINDOW_SYSTEM
3184 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3185 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3186 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3187 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3188 || NILP (attrs
[LFACE_FONT_INDEX
])
3189 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3190 xassert (UNSPECIFIEDP (attrs
[LFACE_FONTSET_INDEX
])
3191 || STRINGP (attrs
[LFACE_FONTSET_INDEX
]));
3196 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3204 xassert (LFACEP (lface
));
3205 check_lface_attrs (XVECTOR (lface
)->contents
);
3209 #else /* GLYPH_DEBUG == 0 */
3211 #define check_lface_attrs(attrs) (void) 0
3212 #define check_lface(lface) (void) 0
3214 #endif /* GLYPH_DEBUG == 0 */
3218 /* Face-merge cycle checking. */
3220 /* A `named merge point' is simply a point during face-merging where we
3221 look up a face by name. We keep a stack of which named lookups we're
3222 currently processing so that we can easily detect cycles, using a
3223 linked- list of struct named_merge_point structures, typically
3224 allocated on the stack frame of the named lookup functions which are
3225 active (so no consing is required). */
3226 struct named_merge_point
3228 Lisp_Object face_name
;
3229 struct named_merge_point
*prev
;
3233 /* If a face merging cycle is detected for FACE_NAME, return 0,
3234 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3235 FACE_NAME, as the head of the linked list pointed to by
3236 NAMED_MERGE_POINTS, and return 1. */
3239 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3240 Lisp_Object face_name
,
3241 struct named_merge_point
**named_merge_points
)
3243 struct named_merge_point
*prev
;
3245 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3246 if (EQ (face_name
, prev
->face_name
))
3249 new_named_merge_point
->face_name
= face_name
;
3250 new_named_merge_point
->prev
= *named_merge_points
;
3252 *named_merge_points
= new_named_merge_point
;
3260 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3261 to make it a symvol. If FACE_NAME is an alias for another face,
3262 return that face's name. */
3265 resolve_face_name (face_name
)
3266 Lisp_Object face_name
;
3268 Lisp_Object aliased
;
3270 if (STRINGP (face_name
))
3271 face_name
= intern (SDATA (face_name
));
3273 while (SYMBOLP (face_name
))
3275 aliased
= Fget (face_name
, Qface_alias
);
3279 face_name
= aliased
;
3286 /* Return the face definition of FACE_NAME on frame F. F null means
3287 return the definition for new frames. FACE_NAME may be a string or
3288 a symbol (apparently Emacs 20.2 allowed strings as face names in
3289 face text properties; Ediff uses that). If FACE_NAME is an alias
3290 for another face, return that face's definition. If SIGNAL_P is
3291 non-zero, signal an error if FACE_NAME is not a valid face name.
3292 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3295 static INLINE Lisp_Object
3296 lface_from_face_name (f
, face_name
, signal_p
)
3298 Lisp_Object face_name
;
3303 face_name
= resolve_face_name (face_name
);
3306 lface
= assq_no_quit (face_name
, f
->face_alist
);
3308 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3311 lface
= XCDR (lface
);
3313 signal_error ("Invalid face", face_name
);
3315 check_lface (lface
);
3320 /* Get face attributes of face FACE_NAME from frame-local faces on
3321 frame F. Store the resulting attributes in ATTRS which must point
3322 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3323 is non-zero, signal an error if FACE_NAME does not name a face.
3324 Otherwise, value is zero if FACE_NAME is not a face. */
3327 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3329 Lisp_Object face_name
;
3336 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3339 bcopy (XVECTOR (lface
)->contents
, attrs
,
3340 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3350 /* Non-zero if all attributes in face attribute vector ATTRS are
3351 specified, i.e. are non-nil. */
3354 lface_fully_specified_p (attrs
)
3359 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3360 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3361 && i
!= LFACE_AVGWIDTH_INDEX
&& i
!= LFACE_FONTSET_INDEX
)
3362 if (UNSPECIFIEDP (attrs
[i
])
3364 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3365 always unspecified. */
3366 && i
!= LFACE_STIPPLE_INDEX
3371 return i
== LFACE_VECTOR_SIZE
;
3374 #ifdef HAVE_WINDOW_SYSTEM
3376 /* Set font-related attributes of Lisp face LFACE from the fullname of
3377 the font opened by FONTNAME. If FORCE_P is zero, set only
3378 unspecified attributes of LFACE. The exception is `font'
3379 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3381 If FONTNAME is not available on frame F,
3382 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3383 If the fullname is not in a valid XLFD format,
3384 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3385 in LFACE and return 1.
3386 Otherwise, return 1. */
3389 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3392 Lisp_Object fontname
;
3393 int force_p
, may_fail_p
;
3395 struct font_name font
;
3400 char *font_name
= SDATA (fontname
);
3401 struct font_info
*font_info
;
3403 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3404 fontset
= fs_query_fontset (fontname
, 0);
3406 font_name
= SDATA (fontset_ascii (fontset
));
3407 else if (fontset
== 0)
3414 /* Check if FONT_NAME is surely available on the system. Usually
3415 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3416 returns quickly. But, even if FONT_NAME is not yet cached,
3417 caching it now is not futail because we anyway load the font
3420 font_info
= FS_LOAD_FONT (f
, font_name
);
3430 font
.name
= STRDUPA (font_info
->full_name
);
3431 have_xlfd_p
= split_font_name (f
, &font
, 1);
3433 /* Set attributes only if unspecified, otherwise face defaults for
3434 new frames would never take effect. If we couldn't get a font
3435 name conforming to XLFD, set normal values. */
3437 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3442 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3443 + strlen (font
.fields
[XLFD_FOUNDRY
])
3445 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3446 font
.fields
[XLFD_FAMILY
]);
3447 val
= build_string (buffer
);
3450 val
= build_string ("*");
3451 LFACE_FAMILY (lface
) = val
;
3454 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3457 pt
= xlfd_point_size (f
, &font
);
3459 pt
= pixel_point_size (f
, font_info
->height
* 10);
3461 LFACE_HEIGHT (lface
) = make_number (pt
);
3464 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3465 LFACE_SWIDTH (lface
)
3466 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3468 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3469 LFACE_AVGWIDTH (lface
)
3471 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3474 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3475 LFACE_WEIGHT (lface
)
3476 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3478 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3480 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3484 LFACE_FONT (lface
) = build_string (font_info
->full_name
);
3485 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3489 LFACE_FONT (lface
) = fontname
;
3491 = new_fontset_from_font_name (build_string (font_info
->full_name
));
3492 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3497 #endif /* HAVE_WINDOW_SYSTEM */
3500 /* Merges the face height FROM with the face height TO, and returns the
3501 merged height. If FROM is an invalid height, then INVALID is
3502 returned instead. FROM and TO may be either absolute face heights or
3503 `relative' heights; the returned value is always an absolute height
3504 unless both FROM and TO are relative. GCPRO is a lisp value that
3505 will be protected from garbage-collection if this function makes a
3509 merge_face_heights (from
, to
, invalid
, gcpro
)
3510 Lisp_Object from
, to
, invalid
, gcpro
;
3512 Lisp_Object result
= invalid
;
3514 if (INTEGERP (from
))
3515 /* FROM is absolute, just use it as is. */
3517 else if (FLOATP (from
))
3518 /* FROM is a scale, use it to adjust TO. */
3521 /* relative X absolute => absolute */
3522 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3523 else if (FLOATP (to
))
3524 /* relative X relative => relative */
3525 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3526 else if (UNSPECIFIEDP (to
))
3529 else if (FUNCTIONP (from
))
3530 /* FROM is a function, which use to adjust TO. */
3532 /* Call function with current height as argument.
3533 From is the new height. */
3534 Lisp_Object args
[2];
3535 struct gcpro gcpro1
;
3541 result
= safe_call (2, args
);
3545 /* Ensure that if TO was absolute, so is the result. */
3546 if (INTEGERP (to
) && !INTEGERP (result
))
3554 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3555 store the resulting attributes in TO, which must be already be
3556 completely specified and contain only absolute attributes. Every
3557 specified attribute of FROM overrides the corresponding attribute of
3558 TO; relative attributes in FROM are merged with the absolute value in
3559 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3560 loops in face inheritance; it should be 0 when called from other
3564 merge_face_vectors (f
, from
, to
, named_merge_points
)
3566 Lisp_Object
*from
, *to
;
3567 struct named_merge_point
*named_merge_points
;
3571 /* If FROM inherits from some other faces, merge their attributes into
3572 TO before merging FROM's direct attributes. Note that an :inherit
3573 attribute of `unspecified' is the same as one of nil; we never
3574 merge :inherit attributes, so nil is more correct, but lots of
3575 other code uses `unspecified' as a generic value for face attributes. */
3576 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3577 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3578 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3580 /* If TO specifies a :font attribute, and FROM specifies some
3581 font-related attribute, we need to clear TO's :font attribute
3582 (because it will be inconsistent with whatever FROM specifies, and
3583 FROM takes precedence). */
3584 if (!NILP (to
[LFACE_FONT_INDEX
])
3585 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3586 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3587 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3588 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3589 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3590 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3591 to
[LFACE_FONT_INDEX
] = Qnil
;
3593 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3594 if (!UNSPECIFIEDP (from
[i
]))
3596 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3597 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
],
3598 named_merge_points
);
3603 /* TO is always an absolute face, which should inherit from nothing.
3604 We blindly copy the :inherit attribute above and fix it up here. */
3605 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3608 /* Merge the named face FACE_NAME on frame F, into the vector of face
3609 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3610 inheritance. Returns true if FACE_NAME is a valid face name and
3611 merging succeeded. */
3614 merge_named_face (f
, face_name
, to
, named_merge_points
)
3616 Lisp_Object face_name
;
3618 struct named_merge_point
*named_merge_points
;
3620 struct named_merge_point named_merge_point
;
3622 if (push_named_merge_point (&named_merge_point
,
3623 face_name
, &named_merge_points
))
3625 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3626 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3629 merge_face_vectors (f
, from
, to
, named_merge_points
);
3638 /* Merge face attributes from the lisp `face reference' FACE_REF on
3639 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3640 problems with FACE_REF cause an error message to be shown. Return
3641 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3642 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3643 list structure; it may be 0 for most callers.
3645 FACE_REF may be a single face specification or a list of such
3646 specifications. Each face specification can be:
3648 1. A symbol or string naming a Lisp face.
3650 2. A property list of the form (KEYWORD VALUE ...) where each
3651 KEYWORD is a face attribute name, and value is an appropriate value
3654 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3655 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3656 for compatibility with 20.2.
3658 Face specifications earlier in lists take precedence over later
3662 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3664 Lisp_Object face_ref
;
3667 struct named_merge_point
*named_merge_points
;
3669 int ok
= 1; /* Succeed without an error? */
3671 if (CONSP (face_ref
))
3673 Lisp_Object first
= XCAR (face_ref
);
3675 if (EQ (first
, Qforeground_color
)
3676 || EQ (first
, Qbackground_color
))
3678 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3679 . COLOR). COLOR must be a string. */
3680 Lisp_Object color_name
= XCDR (face_ref
);
3681 Lisp_Object color
= first
;
3683 if (STRINGP (color_name
))
3685 if (EQ (color
, Qforeground_color
))
3686 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3688 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3693 add_to_log ("Invalid face color", color_name
, Qnil
);
3697 else if (SYMBOLP (first
)
3698 && *SDATA (SYMBOL_NAME (first
)) == ':')
3700 /* Assume this is the property list form. */
3701 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3703 Lisp_Object keyword
= XCAR (face_ref
);
3704 Lisp_Object value
= XCAR (XCDR (face_ref
));
3707 if (EQ (keyword
, QCfamily
))
3709 if (STRINGP (value
))
3710 to
[LFACE_FAMILY_INDEX
] = value
;
3714 else if (EQ (keyword
, QCheight
))
3716 Lisp_Object new_height
=
3717 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
],
3720 if (! NILP (new_height
))
3721 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3725 else if (EQ (keyword
, QCweight
))
3728 && face_numeric_weight (value
) >= 0)
3729 to
[LFACE_WEIGHT_INDEX
] = value
;
3733 else if (EQ (keyword
, QCslant
))
3736 && face_numeric_slant (value
) >= 0)
3737 to
[LFACE_SLANT_INDEX
] = value
;
3741 else if (EQ (keyword
, QCunderline
))
3746 to
[LFACE_UNDERLINE_INDEX
] = value
;
3750 else if (EQ (keyword
, QCoverline
))
3755 to
[LFACE_OVERLINE_INDEX
] = value
;
3759 else if (EQ (keyword
, QCstrike_through
))
3764 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3768 else if (EQ (keyword
, QCbox
))
3771 value
= make_number (1);
3772 if (INTEGERP (value
)
3776 to
[LFACE_BOX_INDEX
] = value
;
3780 else if (EQ (keyword
, QCinverse_video
)
3781 || EQ (keyword
, QCreverse_video
))
3783 if (EQ (value
, Qt
) || NILP (value
))
3784 to
[LFACE_INVERSE_INDEX
] = value
;
3788 else if (EQ (keyword
, QCforeground
))
3790 if (STRINGP (value
))
3791 to
[LFACE_FOREGROUND_INDEX
] = value
;
3795 else if (EQ (keyword
, QCbackground
))
3797 if (STRINGP (value
))
3798 to
[LFACE_BACKGROUND_INDEX
] = value
;
3802 else if (EQ (keyword
, QCstipple
))
3804 #ifdef HAVE_X_WINDOWS
3805 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3806 if (!NILP (pixmap_p
))
3807 to
[LFACE_STIPPLE_INDEX
] = value
;
3812 else if (EQ (keyword
, QCwidth
))
3815 && face_numeric_swidth (value
) >= 0)
3816 to
[LFACE_SWIDTH_INDEX
] = value
;
3820 else if (EQ (keyword
, QCinherit
))
3822 /* This is not really very useful; it's just like a
3823 normal face reference. */
3824 if (! merge_face_ref (f
, value
, to
,
3825 err_msgs
, named_merge_points
))
3833 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3837 face_ref
= XCDR (XCDR (face_ref
));
3842 /* This is a list of face refs. Those at the beginning of the
3843 list take precedence over what follows, so we have to merge
3844 from the end backwards. */
3845 Lisp_Object next
= XCDR (face_ref
);
3848 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3850 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3856 /* FACE_REF ought to be a face name. */
3857 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3858 if (!ok
&& err_msgs
)
3859 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3866 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3867 Sinternal_make_lisp_face
, 1, 2, 0,
3868 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3869 If FACE was not known as a face before, create a new one.
3870 If optional argument FRAME is specified, make a frame-local face
3871 for that frame. Otherwise operate on the global face definition.
3872 Value is a vector of face attributes. */)
3874 Lisp_Object face
, frame
;
3876 Lisp_Object global_lface
, lface
;
3880 CHECK_SYMBOL (face
);
3881 global_lface
= lface_from_face_name (NULL
, face
, 0);
3885 CHECK_LIVE_FRAME (frame
);
3887 lface
= lface_from_face_name (f
, face
, 0);
3890 f
= NULL
, lface
= Qnil
;
3892 /* Add a global definition if there is none. */
3893 if (NILP (global_lface
))
3895 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3897 AREF (global_lface
, 0) = Qface
;
3898 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3899 Vface_new_frame_defaults
);
3901 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3902 face id to Lisp face is given by the vector lface_id_to_name.
3903 The mapping from Lisp face to Lisp face id is given by the
3904 property `face' of the Lisp face name. */
3905 if (next_lface_id
== lface_id_to_name_size
)
3907 int new_size
= max (50, 2 * lface_id_to_name_size
);
3908 int sz
= new_size
* sizeof *lface_id_to_name
;
3909 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3910 lface_id_to_name_size
= new_size
;
3913 lface_id_to_name
[next_lface_id
] = face
;
3914 Fput (face
, Qface
, make_number (next_lface_id
));
3918 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3919 AREF (global_lface
, i
) = Qunspecified
;
3921 /* Add a frame-local definition. */
3926 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3928 AREF (lface
, 0) = Qface
;
3929 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3932 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3933 AREF (lface
, i
) = Qunspecified
;
3936 lface
= global_lface
;
3938 /* Changing a named face means that all realized faces depending on
3939 that face are invalid. Since we cannot tell which realized faces
3940 depend on the face, make sure they are all removed. This is done
3941 by incrementing face_change_count. The next call to
3942 init_iterator will then free realized faces. */
3943 ++face_change_count
;
3944 ++windows_or_buffers_changed
;
3946 xassert (LFACEP (lface
));
3947 check_lface (lface
);
3952 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3953 Sinternal_lisp_face_p
, 1, 2, 0,
3954 doc
: /* Return non-nil if FACE names a face.
3955 If optional second parameter FRAME is non-nil, check for the
3956 existence of a frame-local face with name FACE on that frame.
3957 Otherwise check for the existence of a global face. */)
3959 Lisp_Object face
, frame
;
3965 CHECK_LIVE_FRAME (frame
);
3966 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3969 lface
= lface_from_face_name (NULL
, face
, 0);
3975 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3976 Sinternal_copy_lisp_face
, 4, 4, 0,
3977 doc
: /* Copy face FROM to TO.
3978 If FRAME is t, copy the global face definition of FROM.
3979 Otherwise, copy the frame-local definition of FROM on FRAME.
3980 If NEW-FRAME is a frame, copy that data into the frame-local
3981 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
3982 FRAME controls where the data is copied to.
3984 The value is TO. */)
3985 (from
, to
, frame
, new_frame
)
3986 Lisp_Object from
, to
, frame
, new_frame
;
3988 Lisp_Object lface
, copy
;
3990 CHECK_SYMBOL (from
);
3995 /* Copy global definition of FROM. We don't make copies of
3996 strings etc. because 20.2 didn't do it either. */
3997 lface
= lface_from_face_name (NULL
, from
, 1);
3998 copy
= Finternal_make_lisp_face (to
, Qnil
);
4002 /* Copy frame-local definition of FROM. */
4003 if (NILP (new_frame
))
4005 CHECK_LIVE_FRAME (frame
);
4006 CHECK_LIVE_FRAME (new_frame
);
4007 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
4008 copy
= Finternal_make_lisp_face (to
, new_frame
);
4011 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
4012 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
4014 /* Changing a named face means that all realized faces depending on
4015 that face are invalid. Since we cannot tell which realized faces
4016 depend on the face, make sure they are all removed. This is done
4017 by incrementing face_change_count. The next call to
4018 init_iterator will then free realized faces. */
4019 ++face_change_count
;
4020 ++windows_or_buffers_changed
;
4026 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4027 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4028 doc
: /* Set attribute ATTR of FACE to VALUE.
4029 FRAME being a frame means change the face on that frame.
4030 FRAME nil means change the face of the selected frame.
4031 FRAME t means change the default for new frames.
4032 FRAME 0 means change the face on all frames, and change the default
4034 (face
, attr
, value
, frame
)
4035 Lisp_Object face
, attr
, value
, frame
;
4038 Lisp_Object old_value
= Qnil
;
4039 /* Set 1 if ATTR is QCfont. */
4040 int font_attr_p
= 0;
4041 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4042 int font_related_attr_p
= 0;
4044 CHECK_SYMBOL (face
);
4045 CHECK_SYMBOL (attr
);
4047 face
= resolve_face_name (face
);
4049 /* If FRAME is 0, change face on all frames, and change the
4050 default for new frames. */
4051 if (INTEGERP (frame
) && XINT (frame
) == 0)
4054 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4055 FOR_EACH_FRAME (tail
, frame
)
4056 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4060 /* Set lface to the Lisp attribute vector of FACE. */
4062 lface
= lface_from_face_name (NULL
, face
, 1);
4066 frame
= selected_frame
;
4068 CHECK_LIVE_FRAME (frame
);
4069 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4071 /* If a frame-local face doesn't exist yet, create one. */
4073 lface
= Finternal_make_lisp_face (face
, frame
);
4076 if (EQ (attr
, QCfamily
))
4078 if (!UNSPECIFIEDP (value
))
4080 CHECK_STRING (value
);
4081 if (SCHARS (value
) == 0)
4082 signal_error ("Invalid face family", value
);
4084 old_value
= LFACE_FAMILY (lface
);
4085 LFACE_FAMILY (lface
) = value
;
4086 font_related_attr_p
= 1;
4088 else if (EQ (attr
, QCheight
))
4090 if (!UNSPECIFIEDP (value
))
4094 test
= (EQ (face
, Qdefault
)
4096 /* The default face must have an absolute size,
4097 otherwise, we do a test merge with a random
4098 height to see if VALUE's ok. */
4099 : merge_face_heights (value
, make_number (10), Qnil
, Qnil
));
4101 if (!INTEGERP (test
) || XINT (test
) <= 0)
4102 signal_error ("Invalid face height", value
);
4105 old_value
= LFACE_HEIGHT (lface
);
4106 LFACE_HEIGHT (lface
) = value
;
4107 font_related_attr_p
= 1;
4109 else if (EQ (attr
, QCweight
))
4111 if (!UNSPECIFIEDP (value
))
4113 CHECK_SYMBOL (value
);
4114 if (face_numeric_weight (value
) < 0)
4115 signal_error ("Invalid face weight", value
);
4117 old_value
= LFACE_WEIGHT (lface
);
4118 LFACE_WEIGHT (lface
) = value
;
4119 font_related_attr_p
= 1;
4121 else if (EQ (attr
, QCslant
))
4123 if (!UNSPECIFIEDP (value
))
4125 CHECK_SYMBOL (value
);
4126 if (face_numeric_slant (value
) < 0)
4127 signal_error ("Invalid face slant", value
);
4129 old_value
= LFACE_SLANT (lface
);
4130 LFACE_SLANT (lface
) = value
;
4131 font_related_attr_p
= 1;
4133 else if (EQ (attr
, QCunderline
))
4135 if (!UNSPECIFIEDP (value
))
4136 if ((SYMBOLP (value
)
4138 && !EQ (value
, Qnil
))
4139 /* Underline color. */
4141 && SCHARS (value
) == 0))
4142 signal_error ("Invalid face underline", value
);
4144 old_value
= LFACE_UNDERLINE (lface
);
4145 LFACE_UNDERLINE (lface
) = value
;
4147 else if (EQ (attr
, QCoverline
))
4149 if (!UNSPECIFIEDP (value
))
4150 if ((SYMBOLP (value
)
4152 && !EQ (value
, Qnil
))
4153 /* Overline color. */
4155 && SCHARS (value
) == 0))
4156 signal_error ("Invalid face overline", value
);
4158 old_value
= LFACE_OVERLINE (lface
);
4159 LFACE_OVERLINE (lface
) = value
;
4161 else if (EQ (attr
, QCstrike_through
))
4163 if (!UNSPECIFIEDP (value
))
4164 if ((SYMBOLP (value
)
4166 && !EQ (value
, Qnil
))
4167 /* Strike-through color. */
4169 && SCHARS (value
) == 0))
4170 signal_error ("Invalid face strike-through", value
);
4172 old_value
= LFACE_STRIKE_THROUGH (lface
);
4173 LFACE_STRIKE_THROUGH (lface
) = value
;
4175 else if (EQ (attr
, QCbox
))
4179 /* Allow t meaning a simple box of width 1 in foreground color
4182 value
= make_number (1);
4184 if (UNSPECIFIEDP (value
))
4186 else if (NILP (value
))
4188 else if (INTEGERP (value
))
4189 valid_p
= XINT (value
) != 0;
4190 else if (STRINGP (value
))
4191 valid_p
= SCHARS (value
) > 0;
4192 else if (CONSP (value
))
4208 if (EQ (k
, QCline_width
))
4210 if (!INTEGERP (v
) || XINT (v
) == 0)
4213 else if (EQ (k
, QCcolor
))
4215 if (!STRINGP (v
) || SCHARS (v
) == 0)
4218 else if (EQ (k
, QCstyle
))
4220 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4227 valid_p
= NILP (tem
);
4233 signal_error ("Invalid face box", value
);
4235 old_value
= LFACE_BOX (lface
);
4236 LFACE_BOX (lface
) = value
;
4238 else if (EQ (attr
, QCinverse_video
)
4239 || EQ (attr
, QCreverse_video
))
4241 if (!UNSPECIFIEDP (value
))
4243 CHECK_SYMBOL (value
);
4244 if (!EQ (value
, Qt
) && !NILP (value
))
4245 signal_error ("Invalid inverse-video face attribute value", value
);
4247 old_value
= LFACE_INVERSE (lface
);
4248 LFACE_INVERSE (lface
) = value
;
4250 else if (EQ (attr
, QCforeground
))
4252 if (!UNSPECIFIEDP (value
))
4254 /* Don't check for valid color names here because it depends
4255 on the frame (display) whether the color will be valid
4256 when the face is realized. */
4257 CHECK_STRING (value
);
4258 if (SCHARS (value
) == 0)
4259 signal_error ("Empty foreground color value", value
);
4261 old_value
= LFACE_FOREGROUND (lface
);
4262 LFACE_FOREGROUND (lface
) = value
;
4264 else if (EQ (attr
, QCbackground
))
4266 if (!UNSPECIFIEDP (value
))
4268 /* Don't check for valid color names here because it depends
4269 on the frame (display) whether the color will be valid
4270 when the face is realized. */
4271 CHECK_STRING (value
);
4272 if (SCHARS (value
) == 0)
4273 signal_error ("Empty background color value", value
);
4275 old_value
= LFACE_BACKGROUND (lface
);
4276 LFACE_BACKGROUND (lface
) = value
;
4278 else if (EQ (attr
, QCstipple
))
4280 #ifdef HAVE_X_WINDOWS
4281 if (!UNSPECIFIEDP (value
)
4283 && NILP (Fbitmap_spec_p (value
)))
4284 signal_error ("Invalid stipple attribute", value
);
4285 old_value
= LFACE_STIPPLE (lface
);
4286 LFACE_STIPPLE (lface
) = value
;
4287 #endif /* HAVE_X_WINDOWS */
4289 else if (EQ (attr
, QCwidth
))
4291 if (!UNSPECIFIEDP (value
))
4293 CHECK_SYMBOL (value
);
4294 if (face_numeric_swidth (value
) < 0)
4295 signal_error ("Invalid face width", value
);
4297 old_value
= LFACE_SWIDTH (lface
);
4298 LFACE_SWIDTH (lface
) = value
;
4299 font_related_attr_p
= 1;
4301 else if (EQ (attr
, QCfont
) || EQ (attr
, QCfontset
))
4303 #ifdef HAVE_WINDOW_SYSTEM
4304 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4306 /* Set font-related attributes of the Lisp face from an XLFD
4312 f
= SELECTED_FRAME ();
4314 f
= check_x_frame (frame
);
4316 if (!UNSPECIFIEDP (value
))
4318 CHECK_STRING (value
);
4320 /* VALUE may be a fontset name or an alias of fontset. In
4321 such a case, use the base fontset name. */
4322 tmp
= Fquery_fontset (value
, Qnil
);
4325 else if (EQ (attr
, QCfontset
))
4326 signal_error ("Invalid fontset name", value
);
4328 if (EQ (attr
, QCfont
))
4330 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4331 signal_error ("Invalid font or fontset name", value
);
4334 LFACE_FONTSET (lface
) = value
;
4339 #endif /* HAVE_WINDOW_SYSTEM */
4341 else if (EQ (attr
, QCinherit
))
4344 if (SYMBOLP (value
))
4347 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4348 if (!SYMBOLP (XCAR (tail
)))
4351 LFACE_INHERIT (lface
) = value
;
4353 signal_error ("Invalid face inheritance", value
);
4355 else if (EQ (attr
, QCbold
))
4357 old_value
= LFACE_WEIGHT (lface
);
4358 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4359 font_related_attr_p
= 1;
4361 else if (EQ (attr
, QCitalic
))
4363 old_value
= LFACE_SLANT (lface
);
4364 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4365 font_related_attr_p
= 1;
4368 signal_error ("Invalid face attribute name", attr
);
4370 if (font_related_attr_p
4371 && !UNSPECIFIEDP (value
))
4372 /* If a font-related attribute other than QCfont is specified, the
4373 original `font' attribute nor that of default face is useless
4374 to determine a new font. Thus, we set it to nil so that font
4375 selection mechanism doesn't use it. */
4376 LFACE_FONT (lface
) = Qnil
;
4378 /* Changing a named face means that all realized faces depending on
4379 that face are invalid. Since we cannot tell which realized faces
4380 depend on the face, make sure they are all removed. This is done
4381 by incrementing face_change_count. The next call to
4382 init_iterator will then free realized faces. */
4384 && (EQ (attr
, QCfont
)
4385 || EQ (attr
, QCfontset
)
4386 || NILP (Fequal (old_value
, value
))))
4388 ++face_change_count
;
4389 ++windows_or_buffers_changed
;
4392 if (!UNSPECIFIEDP (value
)
4393 && NILP (Fequal (old_value
, value
)))
4399 if (EQ (face
, Qdefault
))
4401 #ifdef HAVE_WINDOW_SYSTEM
4402 /* Changed font-related attributes of the `default' face are
4403 reflected in changed `font' frame parameters. */
4405 && (font_related_attr_p
|| font_attr_p
)
4406 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4407 set_font_frame_param (frame
, lface
);
4409 #endif /* HAVE_WINDOW_SYSTEM */
4411 if (EQ (attr
, QCforeground
))
4412 param
= Qforeground_color
;
4413 else if (EQ (attr
, QCbackground
))
4414 param
= Qbackground_color
;
4416 #ifdef HAVE_WINDOW_SYSTEM
4418 else if (EQ (face
, Qscroll_bar
))
4420 /* Changing the colors of `scroll-bar' sets frame parameters
4421 `scroll-bar-foreground' and `scroll-bar-background'. */
4422 if (EQ (attr
, QCforeground
))
4423 param
= Qscroll_bar_foreground
;
4424 else if (EQ (attr
, QCbackground
))
4425 param
= Qscroll_bar_background
;
4427 #endif /* not WINDOWSNT */
4428 else if (EQ (face
, Qborder
))
4430 /* Changing background color of `border' sets frame parameter
4432 if (EQ (attr
, QCbackground
))
4433 param
= Qborder_color
;
4435 else if (EQ (face
, Qcursor
))
4437 /* Changing background color of `cursor' sets frame parameter
4439 if (EQ (attr
, QCbackground
))
4440 param
= Qcursor_color
;
4442 else if (EQ (face
, Qmouse
))
4444 /* Changing background color of `mouse' sets frame parameter
4446 if (EQ (attr
, QCbackground
))
4447 param
= Qmouse_color
;
4449 #endif /* HAVE_WINDOW_SYSTEM */
4450 else if (EQ (face
, Qmenu
))
4452 /* Indicate that we have to update the menu bar when
4453 realizing faces on FRAME. FRAME t change the
4454 default for new frames. We do this by setting
4455 setting the flag in new face caches */
4458 struct frame
*f
= XFRAME (frame
);
4459 if (FRAME_FACE_CACHE (f
) == NULL
)
4460 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4461 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4464 menu_face_changed_default
= 1;
4470 /* Update `default-frame-alist', which is used for new frames. */
4472 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4475 /* Update the current frame's parameters. */
4478 cons
= XCAR (Vparam_value_alist
);
4479 XSETCAR (cons
, param
);
4480 XSETCDR (cons
, value
);
4481 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4490 #ifdef HAVE_WINDOW_SYSTEM
4492 /* Set the `font' frame parameter of FRAME determined from `default'
4493 face attributes LFACE. If a font name is explicitely
4494 specfied in LFACE, use it as is. Otherwise, determine a font name
4495 from the other font-related atrributes of LFACE. In that case, if
4496 there's no matching font, signals an error. */
4499 set_font_frame_param (frame
, lface
)
4500 Lisp_Object frame
, lface
;
4502 struct frame
*f
= XFRAME (frame
);
4504 if (FRAME_WINDOW_P (f
))
4506 Lisp_Object font_name
;
4509 if (STRINGP (LFACE_FONT (lface
)))
4510 font_name
= LFACE_FONT (lface
);
4513 /* Choose a font name that reflects LFACE's attributes and has
4514 the registry and encoding pattern specified in the default
4515 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4516 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, Qnil
, NULL
);
4518 error ("No font matches the specified attribute");
4519 font_name
= build_string (font
);
4523 f
->default_face_done_p
= 0;
4524 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4529 /* Update the corresponding face when frame parameter PARAM on frame F
4530 has been assigned the value NEW_VALUE. */
4533 update_face_from_frame_parameter (f
, param
, new_value
)
4535 Lisp_Object param
, new_value
;
4539 /* If there are no faces yet, give up. This is the case when called
4540 from Fx_create_frame, and we do the necessary things later in
4541 face-set-after-frame-defaults. */
4542 if (NILP (f
->face_alist
))
4545 /* Changing a named face means that all realized faces depending on
4546 that face are invalid. Since we cannot tell which realized faces
4547 depend on the face, make sure they are all removed. This is done
4548 by incrementing face_change_count. The next call to
4549 init_iterator will then free realized faces. */
4550 ++face_change_count
;
4551 ++windows_or_buffers_changed
;
4553 if (EQ (param
, Qforeground_color
))
4555 lface
= lface_from_face_name (f
, Qdefault
, 1);
4556 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4557 ? new_value
: Qunspecified
);
4558 realize_basic_faces (f
);
4560 else if (EQ (param
, Qbackground_color
))
4564 /* Changing the background color might change the background
4565 mode, so that we have to load new defface specs. Call
4566 frame-update-face-colors to do that. */
4567 XSETFRAME (frame
, f
);
4568 call1 (Qframe_update_face_colors
, frame
);
4570 lface
= lface_from_face_name (f
, Qdefault
, 1);
4571 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4572 ? new_value
: Qunspecified
);
4573 realize_basic_faces (f
);
4575 if (EQ (param
, Qborder_color
))
4577 lface
= lface_from_face_name (f
, Qborder
, 1);
4578 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4579 ? new_value
: Qunspecified
);
4581 else if (EQ (param
, Qcursor_color
))
4583 lface
= lface_from_face_name (f
, Qcursor
, 1);
4584 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4585 ? new_value
: Qunspecified
);
4587 else if (EQ (param
, Qmouse_color
))
4589 lface
= lface_from_face_name (f
, Qmouse
, 1);
4590 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4591 ? new_value
: Qunspecified
);
4596 /* Get the value of X resource RESOURCE, class CLASS for the display
4597 of frame FRAME. This is here because ordinary `x-get-resource'
4598 doesn't take a frame argument. */
4600 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4601 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4602 (resource
, class, frame
)
4603 Lisp_Object resource
, class, frame
;
4605 Lisp_Object value
= Qnil
;
4606 CHECK_STRING (resource
);
4607 CHECK_STRING (class);
4608 CHECK_LIVE_FRAME (frame
);
4610 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4611 resource
, class, Qnil
, Qnil
);
4617 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4618 If VALUE is "on" or "true", return t. If VALUE is "off" or
4619 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4620 error; if SIGNAL_P is zero, return 0. */
4623 face_boolean_x_resource_value (value
, signal_p
)
4627 Lisp_Object result
= make_number (0);
4629 xassert (STRINGP (value
));
4631 if (xstricmp (SDATA (value
), "on") == 0
4632 || xstricmp (SDATA (value
), "true") == 0)
4634 else if (xstricmp (SDATA (value
), "off") == 0
4635 || xstricmp (SDATA (value
), "false") == 0)
4637 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4638 result
= Qunspecified
;
4640 signal_error ("Invalid face attribute value from X resource", value
);
4646 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4647 Finternal_set_lisp_face_attribute_from_resource
,
4648 Sinternal_set_lisp_face_attribute_from_resource
,
4649 3, 4, 0, doc
: /* */)
4650 (face
, attr
, value
, frame
)
4651 Lisp_Object face
, attr
, value
, frame
;
4653 CHECK_SYMBOL (face
);
4654 CHECK_SYMBOL (attr
);
4655 CHECK_STRING (value
);
4657 if (xstricmp (SDATA (value
), "unspecified") == 0)
4658 value
= Qunspecified
;
4659 else if (EQ (attr
, QCheight
))
4661 value
= Fstring_to_number (value
, make_number (10));
4662 if (XINT (value
) <= 0)
4663 signal_error ("Invalid face height from X resource", value
);
4665 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4666 value
= face_boolean_x_resource_value (value
, 1);
4667 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4668 value
= intern (SDATA (value
));
4669 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4670 value
= face_boolean_x_resource_value (value
, 1);
4671 else if (EQ (attr
, QCunderline
)
4672 || EQ (attr
, QCoverline
)
4673 || EQ (attr
, QCstrike_through
))
4675 Lisp_Object boolean_value
;
4677 /* If the result of face_boolean_x_resource_value is t or nil,
4678 VALUE does NOT specify a color. */
4679 boolean_value
= face_boolean_x_resource_value (value
, 0);
4680 if (SYMBOLP (boolean_value
))
4681 value
= boolean_value
;
4683 else if (EQ (attr
, QCbox
))
4684 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4686 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4689 #endif /* HAVE_WINDOW_SYSTEM */
4692 /***********************************************************************
4694 ***********************************************************************/
4696 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4698 /* Make menus on frame F appear as specified by the `menu' face. */
4701 x_update_menu_appearance (f
)
4704 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4708 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4712 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4713 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4714 const char *myname
= SDATA (Vx_resource_name
);
4717 const char *popup_path
= "popup_menu";
4719 const char *popup_path
= "menu.popup";
4722 if (STRINGP (LFACE_FOREGROUND (lface
)))
4724 sprintf (line
, "%s.%s*foreground: %s",
4726 SDATA (LFACE_FOREGROUND (lface
)));
4727 XrmPutLineResource (&rdb
, line
);
4728 sprintf (line
, "%s.pane.menubar*foreground: %s",
4729 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4730 XrmPutLineResource (&rdb
, line
);
4734 if (STRINGP (LFACE_BACKGROUND (lface
)))
4736 sprintf (line
, "%s.%s*background: %s",
4738 SDATA (LFACE_BACKGROUND (lface
)));
4739 XrmPutLineResource (&rdb
, line
);
4740 sprintf (line
, "%s.pane.menubar*background: %s",
4741 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4742 XrmPutLineResource (&rdb
, line
);
4747 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4748 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4749 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4750 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4751 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4752 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4755 const char *suffix
= "List";
4757 const char *suffix
= "";
4759 sprintf (line
, "%s.pane.menubar*font%s: %s",
4760 myname
, suffix
, face
->font_name
);
4761 XrmPutLineResource (&rdb
, line
);
4762 sprintf (line
, "%s.%s*font%s: %s",
4763 myname
, popup_path
, suffix
, face
->font_name
);
4764 XrmPutLineResource (&rdb
, line
);
4768 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4769 free_frame_menubar (f
);
4773 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4776 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4777 Sface_attribute_relative_p
,
4779 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4781 Lisp_Object attribute
, value
;
4783 if (EQ (value
, Qunspecified
))
4785 else if (EQ (attribute
, QCheight
))
4786 return INTEGERP (value
) ? Qnil
: Qt
;
4791 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4793 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4794 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4795 the result will be absolute, otherwise it will be relative. */)
4796 (attribute
, value1
, value2
)
4797 Lisp_Object attribute
, value1
, value2
;
4799 if (EQ (value1
, Qunspecified
))
4801 else if (EQ (attribute
, QCheight
))
4802 return merge_face_heights (value1
, value2
, value1
, Qnil
);
4808 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4809 Sinternal_get_lisp_face_attribute
,
4811 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4812 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4813 face attribute name, signal an error.
4814 If the optional argument FRAME is given, report on face SYMBOL in that
4815 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4816 frames). If FRAME is omitted or nil, use the selected frame. */)
4817 (symbol
, keyword
, frame
)
4818 Lisp_Object symbol
, keyword
, frame
;
4820 Lisp_Object lface
, value
= Qnil
;
4822 CHECK_SYMBOL (symbol
);
4823 CHECK_SYMBOL (keyword
);
4826 lface
= lface_from_face_name (NULL
, symbol
, 1);
4830 frame
= selected_frame
;
4831 CHECK_LIVE_FRAME (frame
);
4832 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4835 if (EQ (keyword
, QCfamily
))
4836 value
= LFACE_FAMILY (lface
);
4837 else if (EQ (keyword
, QCheight
))
4838 value
= LFACE_HEIGHT (lface
);
4839 else if (EQ (keyword
, QCweight
))
4840 value
= LFACE_WEIGHT (lface
);
4841 else if (EQ (keyword
, QCslant
))
4842 value
= LFACE_SLANT (lface
);
4843 else if (EQ (keyword
, QCunderline
))
4844 value
= LFACE_UNDERLINE (lface
);
4845 else if (EQ (keyword
, QCoverline
))
4846 value
= LFACE_OVERLINE (lface
);
4847 else if (EQ (keyword
, QCstrike_through
))
4848 value
= LFACE_STRIKE_THROUGH (lface
);
4849 else if (EQ (keyword
, QCbox
))
4850 value
= LFACE_BOX (lface
);
4851 else if (EQ (keyword
, QCinverse_video
)
4852 || EQ (keyword
, QCreverse_video
))
4853 value
= LFACE_INVERSE (lface
);
4854 else if (EQ (keyword
, QCforeground
))
4855 value
= LFACE_FOREGROUND (lface
);
4856 else if (EQ (keyword
, QCbackground
))
4857 value
= LFACE_BACKGROUND (lface
);
4858 else if (EQ (keyword
, QCstipple
))
4859 value
= LFACE_STIPPLE (lface
);
4860 else if (EQ (keyword
, QCwidth
))
4861 value
= LFACE_SWIDTH (lface
);
4862 else if (EQ (keyword
, QCinherit
))
4863 value
= LFACE_INHERIT (lface
);
4864 else if (EQ (keyword
, QCfont
))
4865 value
= LFACE_FONT (lface
);
4866 else if (EQ (keyword
, QCfontset
))
4867 value
= LFACE_FONTSET (lface
);
4869 signal_error ("Invalid face attribute name", keyword
);
4875 DEFUN ("internal-lisp-face-attribute-values",
4876 Finternal_lisp_face_attribute_values
,
4877 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4878 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4879 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4883 Lisp_Object result
= Qnil
;
4885 CHECK_SYMBOL (attr
);
4887 if (EQ (attr
, QCweight
)
4888 || EQ (attr
, QCslant
)
4889 || EQ (attr
, QCwidth
))
4891 /* Extract permissible symbols from tables. */
4892 struct table_entry
*table
;
4895 if (EQ (attr
, QCweight
))
4896 table
= weight_table
, dim
= DIM (weight_table
);
4897 else if (EQ (attr
, QCslant
))
4898 table
= slant_table
, dim
= DIM (slant_table
);
4900 table
= swidth_table
, dim
= DIM (swidth_table
);
4902 for (i
= 0; i
< dim
; ++i
)
4904 Lisp_Object symbol
= *table
[i
].symbol
;
4905 Lisp_Object tail
= result
;
4908 && !EQ (XCAR (tail
), symbol
))
4912 result
= Fcons (symbol
, result
);
4915 else if (EQ (attr
, QCunderline
))
4916 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4917 else if (EQ (attr
, QCoverline
))
4918 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4919 else if (EQ (attr
, QCstrike_through
))
4920 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4921 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4922 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4928 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4929 Sinternal_merge_in_global_face
, 2, 2, 0,
4930 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4931 Default face attributes override any local face attributes. */)
4933 Lisp_Object face
, frame
;
4936 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4938 CHECK_LIVE_FRAME (frame
);
4939 global_lface
= lface_from_face_name (NULL
, face
, 1);
4940 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4941 if (NILP (local_lface
))
4942 local_lface
= Finternal_make_lisp_face (face
, frame
);
4944 /* Make every specified global attribute override the local one.
4945 BEWARE!! This is only used from `face-set-after-frame-default' where
4946 the local frame is defined from default specs in `face-defface-spec'
4947 and those should be overridden by global settings. Hence the strange
4948 "global before local" priority. */
4949 lvec
= XVECTOR (local_lface
)->contents
;
4950 gvec
= XVECTOR (global_lface
)->contents
;
4951 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4952 if (! UNSPECIFIEDP (gvec
[i
]))
4959 /* The following function is implemented for compatibility with 20.2.
4960 The function is used in x-resolve-fonts when it is asked to
4961 return fonts with the same size as the font of a face. This is
4962 done in fontset.el. */
4964 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 3, 0,
4965 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4966 The font name is, by default, for ASCII characters.
4967 If the optional argument FRAME is given, report on face FACE in that frame.
4968 If FRAME is t, report on the defaults for face FACE (for new frames).
4969 The font default for a face is either nil, or a list
4970 of the form (bold), (italic) or (bold italic).
4971 If FRAME is omitted or nil, use the selected frame. And, in this case,
4972 if the optional third argument CHARACTER is given,
4973 return the font name used for CHARACTER. */)
4974 (face
, frame
, character
)
4975 Lisp_Object face
, frame
, character
;
4979 Lisp_Object result
= Qnil
;
4980 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4982 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4983 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4984 result
= Fcons (Qbold
, result
);
4986 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4987 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4988 result
= Fcons (Qitalic
, result
);
4994 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4995 int face_id
= lookup_named_face (f
, face
);
4996 struct face
*face
= FACE_FROM_ID (f
, face_id
);
5000 if (NILP (character
))
5001 return build_string (face
->font_name
);
5002 CHECK_CHARACTER (character
);
5003 face_id
= FACE_FOR_CHAR (f
, face
, XINT (character
), -1, Qnil
);
5004 face
= FACE_FROM_ID (f
, face_id
);
5005 return (face
->font
&& face
->font_name
5006 ? build_string (face
->font_name
)
5012 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
5013 all attributes are `equal'. Tries to be fast because this function
5014 is called quite often. */
5017 face_attr_equal_p (v1
, v2
)
5020 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5021 and the other is specified. */
5022 if (XTYPE (v1
) != XTYPE (v2
))
5031 if (SBYTES (v1
) != SBYTES (v2
))
5034 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5041 return !NILP (Fequal (v1
, v2
));
5046 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5047 all attributes are `equal'. Tries to be fast because this function
5048 is called quite often. */
5051 lface_equal_p (v1
, v2
)
5052 Lisp_Object
*v1
, *v2
;
5056 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5057 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5063 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5064 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5065 doc
: /* True if FACE1 and FACE2 are equal.
5066 If the optional argument FRAME is given, report on face FACE in that frame.
5067 If FRAME is t, report on the defaults for face FACE (for new frames).
5068 If FRAME is omitted or nil, use the selected frame. */)
5069 (face1
, face2
, frame
)
5070 Lisp_Object face1
, face2
, frame
;
5073 Lisp_Object lface1
, lface2
;
5075 lface1
= lface_from_face_name (NULL
, face1
, 1);
5076 lface2
= lface_from_face_name (NULL
, face2
, 1);
5077 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5078 XVECTOR (lface2
)->contents
);
5079 return equal_p
? Qt
: Qnil
;
5083 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5084 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5085 doc
: /* True if FACE has no attribute specified.
5086 If the optional argument FRAME is given, report on face FACE in that frame.
5087 If FRAME is t, report on the defaults for face FACE (for new frames).
5088 If FRAME is omitted or nil, use the selected frame. */)
5090 Lisp_Object face
, frame
;
5097 frame
= selected_frame
;
5098 CHECK_LIVE_FRAME (frame
);
5102 lface
= lface_from_face_name (NULL
, face
, 1);
5104 lface
= lface_from_face_name (f
, face
, 1);
5106 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5107 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5110 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5114 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5116 doc
: /* Return an alist of frame-local faces defined on FRAME.
5117 For internal use only. */)
5121 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5122 return f
->face_alist
;
5126 /* Return a hash code for Lisp string STRING with case ignored. Used
5127 below in computing a hash value for a Lisp face. */
5129 static INLINE
unsigned
5130 hash_string_case_insensitive (string
)
5133 const unsigned char *s
;
5135 xassert (STRINGP (string
));
5136 for (s
= SDATA (string
); *s
; ++s
)
5137 hash
= (hash
<< 1) ^ tolower (*s
);
5142 /* Return a hash code for face attribute vector V. */
5144 static INLINE
unsigned
5148 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5149 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5150 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5151 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5152 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5153 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5154 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5158 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5159 considering charsets/registries). They do if they specify the same
5160 family, point size, weight, width, slant, font, and fontset. Both
5161 LFACE1 and LFACE2 must be fully-specified. */
5164 lface_same_font_attributes_p (lface1
, lface2
)
5165 Lisp_Object
*lface1
, *lface2
;
5167 xassert (lface_fully_specified_p (lface1
)
5168 && lface_fully_specified_p (lface2
));
5169 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5170 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5171 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5172 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5173 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5174 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5175 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5176 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5177 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5178 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5179 && ! xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5180 SDATA (lface2
[LFACE_FONT_INDEX
]))))
5181 && (EQ (lface1
[LFACE_FONTSET_INDEX
], lface2
[LFACE_FONTSET_INDEX
])
5182 || (STRINGP (lface1
[LFACE_FONTSET_INDEX
])
5183 && STRINGP (lface2
[LFACE_FONTSET_INDEX
])
5184 && ! xstricmp (SDATA (lface1
[LFACE_FONTSET_INDEX
]),
5185 SDATA (lface2
[LFACE_FONTSET_INDEX
]))))
5191 /***********************************************************************
5193 ***********************************************************************/
5195 /* Allocate and return a new realized face for Lisp face attribute
5198 static struct face
*
5199 make_realized_face (attr
)
5202 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5203 bzero (face
, sizeof *face
);
5204 face
->ascii_face
= face
;
5205 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5210 /* Free realized face FACE, including its X resources. FACE may
5214 free_realized_face (f
, face
)
5220 #ifdef HAVE_WINDOW_SYSTEM
5221 if (FRAME_WINDOW_P (f
))
5223 /* Free fontset of FACE if it is ASCII face. */
5224 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5225 free_face_fontset (f
, face
);
5228 x_free_gc (f
, face
->gc
);
5232 free_face_colors (f
, face
);
5233 x_destroy_bitmap (f
, face
->stipple
);
5235 #endif /* HAVE_WINDOW_SYSTEM */
5242 /* Prepare face FACE for subsequent display on frame F. This
5243 allocated GCs if they haven't been allocated yet or have been freed
5244 by clearing the face cache. */
5247 prepare_face_for_display (f
, face
)
5251 #ifdef HAVE_WINDOW_SYSTEM
5252 xassert (FRAME_WINDOW_P (f
));
5257 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5259 xgcv
.foreground
= face
->foreground
;
5260 xgcv
.background
= face
->background
;
5261 #ifdef HAVE_X_WINDOWS
5262 xgcv
.graphics_exposures
= False
;
5264 /* The font of FACE may be null if we couldn't load it. */
5267 #ifdef HAVE_X_WINDOWS
5268 xgcv
.font
= face
->font
->fid
;
5271 xgcv
.font
= face
->font
;
5274 xgcv
.font
= face
->font
;
5280 #ifdef HAVE_X_WINDOWS
5283 xgcv
.fill_style
= FillOpaqueStippled
;
5284 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5285 mask
|= GCFillStyle
| GCStipple
;
5288 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5291 #endif /* HAVE_WINDOW_SYSTEM */
5295 /* Returns the `distance' between the colors X and Y. */
5298 color_distance (x
, y
)
5301 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5302 Quoting from that paper:
5304 This formula has results that are very close to L*u*v* (with the
5305 modified lightness curve) and, more importantly, it is a more even
5306 algorithm: it does not have a range of colours where it suddenly
5307 gives far from optimal results.
5309 See <http://www.compuphase.com/cmetric.htm> for more info. */
5311 long r
= (x
->red
- y
->red
) >> 8;
5312 long g
= (x
->green
- y
->green
) >> 8;
5313 long b
= (x
->blue
- y
->blue
) >> 8;
5314 long r_mean
= (x
->red
+ y
->red
) >> 9;
5317 (((512 + r_mean
) * r
* r
) >> 8)
5319 + (((767 - r_mean
) * b
* b
) >> 8);
5323 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5324 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5325 COLOR1 and COLOR2 may be either strings containing the color name,
5326 or lists of the form (RED GREEN BLUE).
5327 If FRAME is unspecified or nil, the current frame is used. */)
5328 (color1
, color2
, frame
)
5329 Lisp_Object color1
, color2
, frame
;
5332 XColor cdef1
, cdef2
;
5335 frame
= selected_frame
;
5336 CHECK_LIVE_FRAME (frame
);
5339 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5340 || !STRINGP (color1
)
5341 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5342 signal_error ("Invalid color", color1
);
5343 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5344 || !STRINGP (color2
)
5345 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5346 signal_error ("Invalid color", color2
);
5348 return make_number (color_distance (&cdef1
, &cdef2
));
5352 /***********************************************************************
5354 ***********************************************************************/
5356 /* Return a new face cache for frame F. */
5358 static struct face_cache
*
5362 struct face_cache
*c
;
5365 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5366 bzero (c
, sizeof *c
);
5367 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5368 c
->buckets
= (struct face
**) xmalloc (size
);
5369 bzero (c
->buckets
, size
);
5371 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5373 c
->menu_face_changed_p
= menu_face_changed_default
;
5378 /* Clear out all graphics contexts for all realized faces, except for
5379 the basic faces. This should be done from time to time just to avoid
5380 keeping too many graphics contexts that are no longer needed. */
5384 struct face_cache
*c
;
5386 if (c
&& FRAME_WINDOW_P (c
->f
))
5388 #ifdef HAVE_WINDOW_SYSTEM
5390 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5392 struct face
*face
= c
->faces_by_id
[i
];
5393 if (face
&& face
->gc
)
5395 x_free_gc (c
->f
, face
->gc
);
5399 #endif /* HAVE_WINDOW_SYSTEM */
5404 /* Free all realized faces in face cache C, including basic faces.
5405 C may be null. If faces are freed, make sure the frame's current
5406 matrix is marked invalid, so that a display caused by an expose
5407 event doesn't try to use faces we destroyed. */
5410 free_realized_faces (c
)
5411 struct face_cache
*c
;
5416 struct frame
*f
= c
->f
;
5418 /* We must block input here because we can't process X events
5419 safely while only some faces are freed, or when the frame's
5420 current matrix still references freed faces. */
5423 for (i
= 0; i
< c
->used
; ++i
)
5425 free_realized_face (f
, c
->faces_by_id
[i
]);
5426 c
->faces_by_id
[i
] = NULL
;
5430 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5431 bzero (c
->buckets
, size
);
5433 /* Must do a thorough redisplay the next time. Mark current
5434 matrices as invalid because they will reference faces freed
5435 above. This function is also called when a frame is
5436 destroyed. In this case, the root window of F is nil. */
5437 if (WINDOWP (f
->root_window
))
5439 clear_current_matrices (f
);
5440 ++windows_or_buffers_changed
;
5448 /* Free all realized faces that are using FONTSET on frame F. */
5451 free_realized_faces_for_fontset (f
, fontset
)
5455 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5459 /* We must block input here because we can't process X events safely
5460 while only some faces are freed, or when the frame's current
5461 matrix still references freed faces. */
5464 for (i
= 0; i
< cache
->used
; i
++)
5466 face
= cache
->faces_by_id
[i
];
5468 && face
->fontset
== fontset
)
5470 uncache_face (cache
, face
);
5471 free_realized_face (f
, face
);
5475 /* Must do a thorough redisplay the next time. Mark current
5476 matrices as invalid because they will reference faces freed
5477 above. This function is also called when a frame is destroyed.
5478 In this case, the root window of F is nil. */
5479 if (WINDOWP (f
->root_window
))
5481 clear_current_matrices (f
);
5482 ++windows_or_buffers_changed
;
5489 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5490 This is done after attributes of a named face have been changed,
5491 because we can't tell which realized faces depend on that face. */
5494 free_all_realized_faces (frame
)
5500 FOR_EACH_FRAME (rest
, frame
)
5501 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5504 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5508 /* Free face cache C and faces in it, including their X resources. */
5512 struct face_cache
*c
;
5516 free_realized_faces (c
);
5518 xfree (c
->faces_by_id
);
5524 /* Cache realized face FACE in face cache C. HASH is the hash value
5525 of FACE. If FACE is for ASCII characters (i.e. FACE->ascii_face ==
5526 FACE), insert the new face to the beginning of the collision list
5527 of the face hash table of C. Otherwise, add the new face to the
5528 end of the collision list. This way, lookup_face can quickly find
5529 that a requested face is not cached. */
5532 cache_face (c
, face
, hash
)
5533 struct face_cache
*c
;
5537 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5541 if (face
->ascii_face
!= face
)
5543 struct face
*last
= c
->buckets
[i
];
5554 c
->buckets
[i
] = face
;
5555 face
->prev
= face
->next
= NULL
;
5561 face
->next
= c
->buckets
[i
];
5563 face
->next
->prev
= face
;
5564 c
->buckets
[i
] = face
;
5567 /* Find a free slot in C->faces_by_id and use the index of the free
5568 slot as FACE->id. */
5569 for (i
= 0; i
< c
->used
; ++i
)
5570 if (c
->faces_by_id
[i
] == NULL
)
5574 /* Maybe enlarge C->faces_by_id. */
5577 if (c
->used
== c
->size
)
5580 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5581 if (new_size
== c
->size
)
5582 abort (); /* Alternatives? ++kfs */
5583 sz
= new_size
* sizeof *c
->faces_by_id
;
5584 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5591 /* Check that FACE got a unique id. */
5596 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5597 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5603 #endif /* GLYPH_DEBUG */
5605 c
->faces_by_id
[i
] = face
;
5609 /* Remove face FACE from cache C. */
5612 uncache_face (c
, face
)
5613 struct face_cache
*c
;
5616 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5619 face
->prev
->next
= face
->next
;
5621 c
->buckets
[i
] = face
->next
;
5624 face
->next
->prev
= face
->prev
;
5626 c
->faces_by_id
[face
->id
] = NULL
;
5627 if (face
->id
== c
->used
)
5632 /* Look up a realized face with face attributes ATTR in the face cache
5633 of frame F. The face will be used to display ASCII characters.
5634 Value is the ID of the face found. If no suitable face is found,
5635 realize a new one. */
5638 lookup_face (f
, attr
)
5642 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5647 xassert (cache
!= NULL
);
5648 check_lface_attrs (attr
);
5650 /* Look up ATTR in the face cache. */
5651 hash
= lface_hash (attr
);
5652 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5654 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5656 if (face
->ascii_face
!= face
)
5658 /* There's no more ASCII face. */
5662 if (face
->hash
== hash
5663 && lface_equal_p (face
->lface
, attr
))
5667 /* If not found, realize a new face. */
5669 face
= realize_face (cache
, attr
, -1);
5672 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5673 #endif /* GLYPH_DEBUG */
5679 /* Look up a realized face that has the same attributes as BASE_FACE
5680 except for the font in the face cache of frame F. If FONT_ID is
5681 not negative, it is an ID number of an already opened font that is
5682 used by the face. If FONT_ID is negative, the face has no font.
5683 Value is the ID of the face found. If no suitable face is found,
5684 realize a new one. */
5687 lookup_non_ascii_face (f
, font_id
, base_face
)
5690 struct face
*base_face
;
5692 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5697 xassert (cache
!= NULL
);
5698 base_face
= base_face
->ascii_face
;
5699 hash
= lface_hash (base_face
->lface
);
5700 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5702 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5704 if (face
->ascii_face
== face
)
5706 if (face
->ascii_face
== base_face
5707 && face
->font_info_id
== font_id
)
5711 /* If not found, realize a new face. */
5713 face
= realize_non_ascii_face (f
, font_id
, base_face
);
5716 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5717 #endif /* GLYPH_DEBUG */
5722 /* Return the face id of the realized face for named face SYMBOL on
5723 frame F suitable for displaying ASCII characters. Value is -1 if
5724 the face couldn't be determined, which might happen if the default
5725 face isn't realized and cannot be realized. */
5728 lookup_named_face (f
, symbol
)
5732 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5733 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5734 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5736 if (default_face
== NULL
)
5738 if (!realize_basic_faces (f
))
5740 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5743 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5744 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5745 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5747 return lookup_face (f
, attrs
);
5751 /* Return the ID of the realized ASCII face of Lisp face with ID
5752 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5755 ascii_face_of_lisp_face (f
, lface_id
)
5761 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5763 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5764 face_id
= lookup_named_face (f
, face_name
);
5773 /* Return a face for charset ASCII that is like the face with id
5774 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5775 STEPS < 0 means larger. Value is the id of the face. */
5778 smaller_face (f
, face_id
, steps
)
5782 #ifdef HAVE_WINDOW_SYSTEM
5784 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5785 int pt
, last_pt
, last_height
;
5788 struct face
*new_face
;
5790 /* If not called for an X frame, just return the original face. */
5791 if (FRAME_TERMCAP_P (f
))
5794 /* Try in increments of 1/2 pt. */
5795 delta
= steps
< 0 ? 5 : -5;
5796 steps
= abs (steps
);
5798 face
= FACE_FROM_ID (f
, face_id
);
5799 bcopy (face
->lface
, attrs
, sizeof attrs
);
5800 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5801 new_face_id
= face_id
;
5802 last_height
= FONT_HEIGHT (face
->font
);
5806 /* Give up if we cannot find a font within 10pt. */
5807 && abs (last_pt
- pt
) < 100)
5809 /* Look up a face for a slightly smaller/larger font. */
5811 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5812 new_face_id
= lookup_face (f
, attrs
);
5813 new_face
= FACE_FROM_ID (f
, new_face_id
);
5815 /* If height changes, count that as one step. */
5816 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5817 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5820 last_height
= FONT_HEIGHT (new_face
->font
);
5827 #else /* not HAVE_WINDOW_SYSTEM */
5831 #endif /* not HAVE_WINDOW_SYSTEM */
5835 /* Return a face for charset ASCII that is like the face with id
5836 FACE_ID on frame F, but has height HEIGHT. */
5839 face_with_height (f
, face_id
, height
)
5844 #ifdef HAVE_WINDOW_SYSTEM
5846 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5848 if (FRAME_TERMCAP_P (f
)
5852 face
= FACE_FROM_ID (f
, face_id
);
5853 bcopy (face
->lface
, attrs
, sizeof attrs
);
5854 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5855 face_id
= lookup_face (f
, attrs
);
5856 #endif /* HAVE_WINDOW_SYSTEM */
5862 /* Return the face id of the realized face for named face SYMBOL on
5863 frame F suitable for displaying ASCII characters, and use
5864 attributes of the face FACE_ID for attributes that aren't
5865 completely specified by SYMBOL. This is like lookup_named_face,
5866 except that the default attributes come from FACE_ID, not from the
5867 default face. FACE_ID is assumed to be already realized. */
5870 lookup_derived_face (f
, symbol
, face_id
)
5875 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5876 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5877 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5882 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5883 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5884 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5885 return lookup_face (f
, attrs
);
5888 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5889 Sface_attributes_as_vector
, 1, 1, 0,
5890 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5895 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5897 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5904 /***********************************************************************
5905 Face capability testing
5906 ***********************************************************************/
5909 /* If the distance (as returned by color_distance) between two colors is
5910 less than this, then they are considered the same, for determining
5911 whether a color is supported or not. The range of values is 0-65535. */
5913 #define TTY_SAME_COLOR_THRESHOLD 10000
5915 #ifdef HAVE_WINDOW_SYSTEM
5917 /* Return non-zero if all the face attributes in ATTRS are supported
5918 on the window-system frame F.
5920 The definition of `supported' is somewhat heuristic, but basically means
5921 that a face containing all the attributes in ATTRS, when merged with the
5922 default face for display, can be represented in a way that's
5924 \(1) different in appearance than the default face, and
5925 \(2) `close in spirit' to what the attributes specify, if not exact. */
5928 x_supports_face_attributes_p (f
, attrs
, def_face
)
5931 struct face
*def_face
;
5933 Lisp_Object
*def_attrs
= def_face
->lface
;
5935 /* Check that other specified attributes are different that the default
5937 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5938 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5939 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5940 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5941 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5942 def_attrs
[LFACE_INVERSE_INDEX
]))
5943 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5944 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5945 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5946 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5947 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5948 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5949 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5950 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5951 def_attrs
[LFACE_STIPPLE_INDEX
]))
5952 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5953 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5954 def_attrs
[LFACE_OVERLINE_INDEX
]))
5955 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5956 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5957 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5958 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5959 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5960 def_attrs
[LFACE_BOX_INDEX
])))
5963 /* Check font-related attributes, as those are the most commonly
5964 "unsupported" on a window-system (because of missing fonts). */
5965 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5966 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5967 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5968 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5969 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5970 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5974 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5976 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5978 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5980 face_id
= lookup_face (f
, merged_attrs
);
5981 face
= FACE_FROM_ID (f
, face_id
);
5984 signal_error ("cannot make face", 0);
5986 /* If the font is the same, then not supported. */
5987 if (face
->font
== def_face
->font
)
5991 /* Everything checks out, this face is supported. */
5995 #endif /* HAVE_WINDOW_SYSTEM */
5997 /* Return non-zero if all the face attributes in ATTRS are supported
6000 The definition of `supported' is somewhat heuristic, but basically means
6001 that a face containing all the attributes in ATTRS, when merged
6002 with the default face for display, can be represented in a way that's
6004 \(1) different in appearance than the default face, and
6005 \(2) `close in spirit' to what the attributes specify, if not exact.
6007 Point (2) implies that a `:weight black' attribute will be satisfied
6008 by any terminal that can display bold, and a `:foreground "yellow"' as
6009 long as the terminal can display a yellowish color, but `:slant italic'
6010 will _not_ be satisfied by the tty display code's automatic
6011 substitution of a `dim' face for italic. */
6014 tty_supports_face_attributes_p (f
, attrs
, def_face
)
6017 struct face
*def_face
;
6020 Lisp_Object val
, fg
, bg
;
6021 XColor fg_tty_color
, fg_std_color
;
6022 XColor bg_tty_color
, bg_std_color
;
6023 unsigned test_caps
= 0;
6024 Lisp_Object
*def_attrs
= def_face
->lface
;
6027 /* First check some easy-to-check stuff; ttys support none of the
6028 following attributes, so we can just return false if any are requested
6029 (even if `nominal' values are specified, we should still return false,
6030 as that will be the same value that the default face uses). We
6031 consider :slant unsupportable on ttys, even though the face code
6032 actually `fakes' them using a dim attribute if possible. This is
6033 because the faked result is too different from what the face
6035 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6036 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6037 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6038 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6039 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6040 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6041 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6042 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
6046 /* Test for terminal `capabilities' (non-color character attributes). */
6048 /* font weight (bold/dim) */
6049 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6052 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6054 if (weight
> XLFD_WEIGHT_MEDIUM
)
6056 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6057 return 0; /* same as default */
6058 test_caps
= TTY_CAP_BOLD
;
6060 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6062 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6063 return 0; /* same as default */
6064 test_caps
= TTY_CAP_DIM
;
6066 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6067 return 0; /* same as default */
6071 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6072 if (!UNSPECIFIEDP (val
))
6075 return 0; /* ttys can't use colored underlines */
6076 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6077 return 0; /* same as default */
6079 test_caps
|= TTY_CAP_UNDERLINE
;
6083 val
= attrs
[LFACE_INVERSE_INDEX
];
6084 if (!UNSPECIFIEDP (val
))
6086 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6087 return 0; /* same as default */
6089 test_caps
|= TTY_CAP_INVERSE
;
6093 /* Color testing. */
6095 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6096 we use them when calling `tty_capable_p' below, even if the face
6097 specifies no colors. */
6098 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6099 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6101 /* Check if foreground color is close enough. */
6102 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6105 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6107 if (face_attr_equal_p (fg
, def_fg
))
6108 return 0; /* same as default */
6109 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6110 return 0; /* not a valid color */
6111 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6112 > TTY_SAME_COLOR_THRESHOLD
)
6113 return 0; /* displayed color is too different */
6115 /* Make sure the color is really different than the default. */
6117 XColor def_fg_color
;
6118 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6119 && (color_distance (&fg_tty_color
, &def_fg_color
)
6120 <= TTY_SAME_COLOR_THRESHOLD
))
6125 /* Check if background color is close enough. */
6126 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6129 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6131 if (face_attr_equal_p (bg
, def_bg
))
6132 return 0; /* same as default */
6133 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6134 return 0; /* not a valid color */
6135 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6136 > TTY_SAME_COLOR_THRESHOLD
)
6137 return 0; /* displayed color is too different */
6139 /* Make sure the color is really different than the default. */
6141 XColor def_bg_color
;
6142 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6143 && (color_distance (&bg_tty_color
, &def_bg_color
)
6144 <= TTY_SAME_COLOR_THRESHOLD
))
6149 /* If both foreground and background are requested, see if the
6150 distance between them is OK. We just check to see if the distance
6151 between the tty's foreground and background is close enough to the
6152 distance between the standard foreground and background. */
6153 if (STRINGP (fg
) && STRINGP (bg
))
6156 = (color_distance (&fg_std_color
, &bg_std_color
)
6157 - color_distance (&fg_tty_color
, &bg_tty_color
));
6158 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6159 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6164 /* See if the capabilities we selected above are supported, with the
6166 if (test_caps
!= 0 &&
6167 ! tty_capable_p (f
, test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6171 /* Hmmm, everything checks out, this terminal must support this face. */
6176 DEFUN ("display-supports-face-attributes-p",
6177 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6179 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6180 The optional argument DISPLAY can be a display name, a frame, or
6181 nil (meaning the selected frame's display)
6183 The definition of `supported' is somewhat heuristic, but basically means
6184 that a face containing all the attributes in ATTRIBUTES, when merged
6185 with the default face for display, can be represented in a way that's
6187 \(1) different in appearance than the default face, and
6188 \(2) `close in spirit' to what the attributes specify, if not exact.
6190 Point (2) implies that a `:weight black' attribute will be satisfied by
6191 any display that can display bold, and a `:foreground \"yellow\"' as long
6192 as it can display a yellowish color, but `:slant italic' will _not_ be
6193 satisfied by the tty display code's automatic substitution of a `dim'
6194 face for italic. */)
6195 (attributes
, display
)
6196 Lisp_Object attributes
, display
;
6201 struct face
*def_face
;
6202 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6204 if (noninteractive
|| !initialized
)
6205 /* We may not be able to access low-level face information in batch
6206 mode, or before being dumped, and this function is not going to
6207 be very useful in those cases anyway, so just give up. */
6211 frame
= selected_frame
;
6212 else if (FRAMEP (display
))
6216 /* Find any frame on DISPLAY. */
6217 Lisp_Object fl_tail
;
6220 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6222 frame
= XCAR (fl_tail
);
6223 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6224 XFRAME (frame
)->param_alist
)),
6230 CHECK_LIVE_FRAME (frame
);
6233 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6234 attrs
[i
] = Qunspecified
;
6235 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6237 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6238 if (def_face
== NULL
)
6240 if (! realize_basic_faces (f
))
6241 signal_error ("Cannot realize default face", 0);
6242 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6245 /* Dispatch to the appropriate handler. */
6246 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6247 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6248 #ifdef HAVE_WINDOW_SYSTEM
6250 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6253 return supports
? Qt
: Qnil
;
6257 /***********************************************************************
6259 ***********************************************************************/
6261 DEFUN ("internal-set-font-selection-order",
6262 Finternal_set_font_selection_order
,
6263 Sinternal_set_font_selection_order
, 1, 1, 0,
6264 doc
: /* Set font selection order for face font selection to ORDER.
6265 ORDER must be a list of length 4 containing the symbols `:width',
6266 `:height', `:weight', and `:slant'. Face attributes appearing
6267 first in ORDER are matched first, e.g. if `:height' appears before
6268 `:weight' in ORDER, font selection first tries to find a font with
6269 a suitable height, and then tries to match the font weight.
6276 int indices
[DIM (font_sort_order
)];
6279 bzero (indices
, sizeof indices
);
6283 CONSP (list
) && i
< DIM (indices
);
6284 list
= XCDR (list
), ++i
)
6286 Lisp_Object attr
= XCAR (list
);
6289 if (EQ (attr
, QCwidth
))
6291 else if (EQ (attr
, QCheight
))
6292 xlfd
= XLFD_POINT_SIZE
;
6293 else if (EQ (attr
, QCweight
))
6295 else if (EQ (attr
, QCslant
))
6300 if (indices
[i
] != 0)
6305 if (!NILP (list
) || i
!= DIM (indices
))
6306 signal_error ("Invalid font sort order", order
);
6307 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6308 if (indices
[i
] == 0)
6309 signal_error ("Invalid font sort order", order
);
6311 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6313 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6314 free_all_realized_faces (Qnil
);
6321 DEFUN ("internal-set-alternative-font-family-alist",
6322 Finternal_set_alternative_font_family_alist
,
6323 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6324 doc
: /* Define alternative font families to try in face font selection.
6325 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6326 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6327 be found. Value is ALIST. */)
6332 Vface_alternative_font_family_alist
= alist
;
6333 free_all_realized_faces (Qnil
);
6338 DEFUN ("internal-set-alternative-font-registry-alist",
6339 Finternal_set_alternative_font_registry_alist
,
6340 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6341 doc
: /* Define alternative font registries to try in face font selection.
6342 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6343 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6344 be found. Value is ALIST. */)
6349 Vface_alternative_font_registry_alist
= alist
;
6350 free_all_realized_faces (Qnil
);
6355 #ifdef HAVE_WINDOW_SYSTEM
6357 /* Value is non-zero if FONT is the name of a scalable font. The
6358 X11R6 XLFD spec says that point size, pixel size, and average width
6359 are zero for scalable fonts. Intlfonts contain at least one
6360 scalable font ("*-muleindian-1") for which this isn't true, so we
6361 just test average width. */
6364 font_scalable_p (font
)
6365 struct font_name
*font
;
6367 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6368 return (*s
== '0' && *(s
+ 1) == '\0')
6370 /* Windows implementation of XLFD is slightly broken for backward
6371 compatibility with previous broken versions, so test for
6372 wildcards as well as 0. */
6379 /* Ignore the difference of font point size less than this value. */
6381 #define FONT_POINT_SIZE_QUANTUM 5
6383 /* Value is non-zero if FONT1 is a better match for font attributes
6384 VALUES than FONT2. VALUES is an array of face attribute values in
6385 font sort order. COMPARE_PT_P zero means don't compare point
6386 sizes. AVGWIDTH, if not zero, is a specified font average width
6390 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6392 struct font_name
*font1
, *font2
;
6393 int compare_pt_p
, avgwidth
;
6397 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6399 int xlfd_idx
= font_sort_order
[i
];
6401 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6405 if (xlfd_idx
== XLFD_POINT_SIZE
)
6407 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6408 / font1
->rescale_ratio
));
6409 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6410 / font2
->rescale_ratio
));
6411 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6416 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6417 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6420 if (delta1
> delta2
)
6422 else if (delta1
< delta2
)
6426 /* The difference may be equal because, e.g., the face
6427 specifies `italic' but we have only `regular' and
6428 `oblique'. Prefer `oblique' in this case. */
6429 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6430 && font1
->numeric
[xlfd_idx
] > values
[i
]
6431 && font2
->numeric
[xlfd_idx
] < values
[i
])
6439 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6440 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6441 if (delta1
> delta2
)
6443 else if (delta1
< delta2
)
6449 /* We prefer a real scalable font; i.e. not what autoscaled. */
6450 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6451 && font1
->numeric
[XLFD_RESY
] > 0);
6452 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6453 && font2
->numeric
[XLFD_RESY
] > 0);
6455 if (auto_scaled_1
!= auto_scaled_2
)
6456 return auto_scaled_2
;
6459 return font1
->registry_priority
< font2
->registry_priority
;
6463 /* Value is non-zero if FONT is an exact match for face attributes in
6464 SPECIFIED. SPECIFIED is an array of face attribute values in font
6465 sort order. AVGWIDTH, if non-zero, is an average width to compare
6469 exact_face_match_p (specified
, font
, avgwidth
)
6471 struct font_name
*font
;
6476 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6477 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6480 return (i
== DIM (font_sort_order
)
6482 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6486 /* Value is the name of a scaled font, generated from scalable font
6487 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6488 Value is allocated from heap. */
6491 build_scalable_font_name (f
, font
, specified_pt
)
6493 struct font_name
*font
;
6496 char pixel_size
[20];
6498 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6501 if (font
->numeric
[XLFD_PIXEL_SIZE
] != 0
6502 || font
->numeric
[XLFD_POINT_SIZE
] != 0)
6503 /* This is a scalable font but is requested for a specific size.
6504 We should not change that size. */
6505 return build_font_name (font
);
6507 /* If scalable font is for a specific resolution, compute
6508 the point size we must specify from the resolution of
6509 the display and the specified resolution of the font. */
6510 if (font
->numeric
[XLFD_RESY
] != 0)
6512 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6513 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
;
6518 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
;
6520 /* We may need a font of the different size. */
6521 pixel_value
*= font
->rescale_ratio
;
6523 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6524 font of the specified PIXEL_SIZE. */
6526 { /* Set point size of the font. */
6527 char point_size
[20];
6528 sprintf (point_size
, "%d", (int) pt
);
6529 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6530 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6534 /* Set pixel size. */
6535 sprintf (pixel_size
, "%d", pixel_value
);
6536 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6537 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6539 /* If font doesn't specify its resolution, use the
6540 resolution of the display. */
6541 if (font
->numeric
[XLFD_RESY
] == 0)
6544 sprintf (buffer
, "%d", (int) resy
);
6545 font
->fields
[XLFD_RESY
] = buffer
;
6546 font
->numeric
[XLFD_RESY
] = resy
;
6549 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6552 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6553 sprintf (buffer
, "%d", resx
);
6554 font
->fields
[XLFD_RESX
] = buffer
;
6555 font
->numeric
[XLFD_RESX
] = resx
;
6558 return build_font_name (font
);
6562 /* Value is non-zero if we are allowed to use scalable font FONT. We
6563 can't run a Lisp function here since this function may be called
6564 with input blocked. */
6567 may_use_scalable_font_p (font
)
6570 if (EQ (Vscalable_fonts_allowed
, Qt
))
6572 else if (CONSP (Vscalable_fonts_allowed
))
6574 Lisp_Object tail
, regexp
;
6576 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6578 regexp
= XCAR (tail
);
6579 if (STRINGP (regexp
)
6580 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6590 /* Return the name of the best matching font for face attributes ATTRS
6591 in the array of font_name structures FONTS which contains NFONTS
6592 elements. WIDTH_RATIO is a factor with which to multiply average
6593 widths if ATTRS specifies such a width.
6595 Value is a font name which is allocated from the heap. FONTS is
6596 freed by this function.
6598 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6599 indicate whether the resulting font should be drawn using overstrike
6600 to simulate bold-face. */
6603 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6606 struct font_name
*fonts
;
6609 int *needs_overstrike
;
6612 struct font_name
*best
;
6615 int exact_p
, avgwidth
;
6620 /* Make specified font attributes available in `specified',
6621 indexed by sort order. */
6622 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6624 int xlfd_idx
= font_sort_order
[i
];
6626 if (xlfd_idx
== XLFD_SWIDTH
)
6627 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6628 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6629 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6630 else if (xlfd_idx
== XLFD_WEIGHT
)
6631 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6632 else if (xlfd_idx
== XLFD_SLANT
)
6633 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6638 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6640 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6644 if (needs_overstrike
)
6645 *needs_overstrike
= 0;
6647 /* Start with the first non-scalable font in the list. */
6648 for (i
= 0; i
< nfonts
; ++i
)
6649 if (!font_scalable_p (fonts
+ i
))
6652 /* Find the best match among the non-scalable fonts. */
6657 for (i
= 1; i
< nfonts
; ++i
)
6658 if (!font_scalable_p (fonts
+ i
)
6659 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6663 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6671 /* Unless we found an exact match among non-scalable fonts, see if
6672 we can find a better match among scalable fonts. */
6675 /* A scalable font is better if
6677 1. its weight, slant, swidth attributes are better, or.
6679 2. the best non-scalable font doesn't have the required
6680 point size, and the scalable fonts weight, slant, swidth
6683 int non_scalable_has_exact_height_p
;
6685 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6686 non_scalable_has_exact_height_p
= 1;
6688 non_scalable_has_exact_height_p
= 0;
6690 for (i
= 0; i
< nfonts
; ++i
)
6691 if (font_scalable_p (fonts
+ i
))
6694 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6695 || (!non_scalable_has_exact_height_p
6696 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6698 non_scalable_has_exact_height_p
= 1;
6703 if (needs_overstrike
)
6705 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6706 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6708 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6710 /* We want a bold font, but didn't get one; try to use
6711 overstriking instead to simulate bold-face. However,
6712 don't overstrike an already-bold fontn unless the
6713 desired weight grossly exceeds the available weight. */
6714 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6715 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6717 *needs_overstrike
= 1;
6722 if (font_scalable_p (best
))
6723 font_name
= build_scalable_font_name (f
, best
, pt
);
6725 font_name
= build_font_name (best
);
6727 /* Free font_name structures. */
6728 free_font_names (fonts
, nfonts
);
6734 /* Get a list of matching fonts on frame F, considering FAMILY
6735 and alternative font families from Vface_alternative_font_registry_alist.
6737 FAMILY is the font family whose alternatives are considered.
6739 REGISTRY, if a string, specifies a font registry and encoding to
6740 match. A value of nil means include fonts of any registry and
6743 Return in *FONTS a pointer to a vector of font_name structures for
6744 the fonts matched. Value is the number of fonts found. */
6747 try_alternative_families (f
, family
, registry
, fonts
)
6749 Lisp_Object family
, registry
;
6750 struct font_name
**fonts
;
6755 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6758 /* Try alternative font families. */
6759 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6762 for (alter
= XCDR (alter
);
6763 CONSP (alter
) && nfonts
== 0;
6764 alter
= XCDR (alter
))
6766 if (STRINGP (XCAR (alter
)))
6767 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6771 /* Try all scalable fonts before giving up. */
6772 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6774 int count
= SPECPDL_INDEX ();
6775 specbind (Qscalable_fonts_allowed
, Qt
);
6776 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6777 unbind_to (count
, Qnil
);
6784 /* Get a list of matching fonts on frame F.
6786 PATTERN, if a string, specifies a font name pattern to match while
6787 ignoring FAMILY and REGISTRY.
6789 FAMILY, if a list, specifies a list of font families to try.
6791 REGISTRY, if a list, specifies a list of font registries and
6794 Return in *FONTS a pointer to a vector of font_name structures for
6795 the fonts matched. Value is the number of fonts found. */
6798 try_font_list (f
, pattern
, family
, registry
, fonts
)
6800 Lisp_Object pattern
, family
, registry
;
6801 struct font_name
**fonts
;
6805 if (STRINGP (pattern
))
6807 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
6808 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6810 int count
= SPECPDL_INDEX ();
6811 specbind (Qscalable_fonts_allowed
, Qt
);
6812 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
6813 unbind_to (count
, Qnil
);
6821 nfonts
= font_list (f
, Qnil
, Qnil
, registry
, fonts
);
6823 for (tail
= family
; ! nfonts
&& CONSP (tail
); tail
= XCDR (tail
))
6824 nfonts
= try_alternative_families (f
, XCAR (tail
), registry
, fonts
);
6826 /* Try font family of the default face or "fixed". */
6827 if (nfonts
== 0 && !NILP (family
))
6829 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6831 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6833 family
= build_string ("fixed");
6834 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6837 /* Try any family with the given registry. */
6838 if (nfonts
== 0 && !NILP (family
))
6839 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6846 /* Return the fontset id of the base fontset name or alias name given
6847 by the fontset attribute of ATTRS. Value is -1 if the fontset
6848 attribute of ATTRS doesn't name a fontset. */
6851 face_fontset (attrs
)
6856 name
= attrs
[LFACE_FONTSET_INDEX
];
6857 if (!STRINGP (name
))
6859 return fs_query_fontset (name
, 0);
6863 /* Choose a name of font to use on frame F to display characters with
6864 Lisp face attributes specified by ATTRS. The font name is
6865 determined by the font-related attributes in ATTRS and FONT-SPEC
6868 When we are choosing a font for ASCII characters, FONT-SPEC is
6869 always nil. Otherwise FONT-SPEC is a list
6870 [ FAMILY WEIGHT SLANT SWIDTH ADSTYLE REGISTRY ]
6871 or a string specifying a font name pattern.
6873 If NEEDS_OVERSTRIKE is not NULL, a boolean is returned in it to
6874 indicate whether the resulting font should be drawn using
6875 overstrike to simulate bold-face.
6877 Value is the font name which is allocated from the heap and must be
6878 freed by the caller. */
6881 choose_face_font (f
, attrs
, font_spec
, needs_overstrike
)
6884 Lisp_Object font_spec
;
6885 int *needs_overstrike
;
6887 Lisp_Object pattern
, family
, adstyle
, registry
;
6888 char *font_name
= NULL
;
6889 struct font_name
*fonts
;
6892 if (needs_overstrike
)
6893 *needs_overstrike
= 0;
6895 /* If we are choosing an ASCII font and a font name is explicitly
6896 specified in ATTRS, return it. */
6897 if (NILP (font_spec
) && STRINGP (attrs
[LFACE_FONT_INDEX
]))
6898 return xstrdup (SDATA (attrs
[LFACE_FONT_INDEX
]));
6900 if (NILP (attrs
[LFACE_FAMILY_INDEX
]))
6903 family
= Fcons (attrs
[LFACE_FAMILY_INDEX
], Qnil
);
6905 /* Decide FAMILY, ADSTYLE, and REGISTRY from FONT_SPEC. But,
6906 ADSTYLE is not used in the font selector for the moment. */
6907 if (VECTORP (font_spec
))
6910 if (STRINGP (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
)))
6911 family
= Fcons (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
), family
);
6912 adstyle
= AREF (font_spec
, FONT_SPEC_ADSTYLE_INDEX
);
6913 registry
= Fcons (AREF (font_spec
, FONT_SPEC_REGISTRY_INDEX
), Qnil
);
6915 else if (STRINGP (font_spec
))
6917 pattern
= font_spec
;
6924 /* We are choosing an ASCII font. By default, use the registry
6925 name "iso8859-1". But, if the registry name of the ASCII
6926 font specified in the fontset of ATTRS is not "iso8859-1"
6927 (e.g "iso10646-1"), use also that name with higher
6929 int fontset
= face_fontset (attrs
);
6932 struct font_name font
;
6936 registry
= Fcons (build_string ("iso8859-1"), Qnil
);
6938 ascii
= fontset_ascii (fontset
);
6939 len
= SBYTES (ascii
);
6941 || strcmp (SDATA (ascii
) + len
- 9, "iso8859-1"))
6943 font
.name
= LSTRDUPA (ascii
);
6944 /* Check if the name is in XLFD. */
6945 if (split_font_name (f
, &font
, 0))
6947 font
.fields
[XLFD_ENCODING
][-1] = '-';
6948 registry
= Fcons (build_string (font
.fields
[XLFD_REGISTRY
]),
6954 /* Get a list of fonts matching that pattern and choose the
6955 best match for the specified face attributes from it. */
6956 nfonts
= try_font_list (f
, pattern
, family
, registry
, &fonts
);
6957 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, NILP (font_spec
),
6962 #endif /* HAVE_WINDOW_SYSTEM */
6966 /***********************************************************************
6968 ***********************************************************************/
6970 /* Realize basic faces on frame F. Value is zero if frame parameters
6971 of F don't contain enough information needed to realize the default
6975 realize_basic_faces (f
)
6979 int count
= SPECPDL_INDEX ();
6981 /* Block input here so that we won't be surprised by an X expose
6982 event, for instance, without having the faces set up. */
6984 specbind (Qscalable_fonts_allowed
, Qt
);
6986 if (realize_default_face (f
))
6988 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6989 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6990 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6991 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6992 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6993 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6994 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6995 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6996 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6997 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6999 /* Reflect changes in the `menu' face in menu bars. */
7000 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
7002 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
7003 #ifdef USE_X_TOOLKIT
7004 x_update_menu_appearance (f
);
7011 unbind_to (count
, Qnil
);
7017 /* Realize the default face on frame F. If the face is not fully
7018 specified, make it fully-specified. Attributes of the default face
7019 that are not explicitly specified are taken from frame parameters. */
7022 realize_default_face (f
)
7025 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7027 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7028 Lisp_Object frame_font
;
7031 /* If the `default' face is not yet known, create it. */
7032 lface
= lface_from_face_name (f
, Qdefault
, 0);
7036 XSETFRAME (frame
, f
);
7037 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
7041 #ifdef HAVE_WINDOW_SYSTEM
7042 if (FRAME_WINDOW_P (f
))
7044 /* Set frame_font to the value of the `font' frame parameter. */
7045 frame_font
= Fassq (Qfont
, f
->param_alist
);
7046 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
7047 frame_font
= XCDR (frame_font
);
7048 set_lface_from_font_name (f
, lface
, frame_font
,
7049 f
->default_face_done_p
, 1);
7050 f
->default_face_done_p
= 1;
7052 #endif /* HAVE_WINDOW_SYSTEM */
7054 if (!FRAME_WINDOW_P (f
))
7056 LFACE_FAMILY (lface
) = build_string ("default");
7057 LFACE_SWIDTH (lface
) = Qnormal
;
7058 LFACE_HEIGHT (lface
) = make_number (1);
7059 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
7060 LFACE_WEIGHT (lface
) = Qnormal
;
7061 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
7062 LFACE_SLANT (lface
) = Qnormal
;
7063 LFACE_AVGWIDTH (lface
) = Qunspecified
;
7066 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
7067 LFACE_UNDERLINE (lface
) = Qnil
;
7069 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
7070 LFACE_OVERLINE (lface
) = Qnil
;
7072 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
7073 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
7075 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
7076 LFACE_BOX (lface
) = Qnil
;
7078 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
7079 LFACE_INVERSE (lface
) = Qnil
;
7081 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
7083 /* This function is called so early that colors are not yet
7084 set in the frame parameter list. */
7085 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7087 if (CONSP (color
) && STRINGP (XCDR (color
)))
7088 LFACE_FOREGROUND (lface
) = XCDR (color
);
7089 else if (FRAME_WINDOW_P (f
))
7091 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7092 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7097 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7099 /* This function is called so early that colors are not yet
7100 set in the frame parameter list. */
7101 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7102 if (CONSP (color
) && STRINGP (XCDR (color
)))
7103 LFACE_BACKGROUND (lface
) = XCDR (color
);
7104 else if (FRAME_WINDOW_P (f
))
7106 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7107 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7112 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7113 LFACE_STIPPLE (lface
) = Qnil
;
7115 /* Realize the face; it must be fully-specified now. */
7116 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7117 check_lface (lface
);
7118 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7119 face
= realize_face (c
, attrs
, DEFAULT_FACE_ID
);
7124 /* Realize basic faces other than the default face in face cache C.
7125 SYMBOL is the face name, ID is the face id the realized face must
7126 have. The default face must have been realized already. */
7129 realize_named_face (f
, symbol
, id
)
7134 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7135 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7136 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7137 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7138 struct face
*new_face
;
7140 /* The default face must exist and be fully specified. */
7141 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7142 check_lface_attrs (attrs
);
7143 xassert (lface_fully_specified_p (attrs
));
7145 /* If SYMBOL isn't know as a face, create it. */
7149 XSETFRAME (frame
, f
);
7150 lface
= Finternal_make_lisp_face (symbol
, frame
);
7153 /* Merge SYMBOL's face with the default face. */
7154 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7155 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7157 /* Realize the face. */
7158 new_face
= realize_face (c
, attrs
, id
);
7162 /* Realize the fully-specified face with attributes ATTRS in face
7163 cache CACHE for ASCII characters. If FORMER_FACE_ID is
7164 non-negative, it is an ID of face to remove before caching the new
7165 face. Value is a pointer to the newly created realized face. */
7167 static struct face
*
7168 realize_face (cache
, attrs
, former_face_id
)
7169 struct face_cache
*cache
;
7175 /* LFACE must be fully specified. */
7176 xassert (cache
!= NULL
);
7177 check_lface_attrs (attrs
);
7179 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7181 /* Remove the former face. */
7182 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7183 uncache_face (cache
, former_face
);
7184 free_realized_face (cache
->f
, former_face
);
7187 if (FRAME_WINDOW_P (cache
->f
))
7188 face
= realize_x_face (cache
, attrs
);
7189 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7190 face
= realize_tty_face (cache
, attrs
);
7194 /* Insert the new face. */
7195 cache_face (cache
, face
, lface_hash (attrs
));
7200 /* Realize the fully-specified face that has the same attributes as
7201 BASE_FACE except for the font on frame F. If FONT_ID is not
7202 negative, it is an ID number of an already opened font that should
7203 be used by the face. If FONT_ID is negative, the face has no font,
7204 i.e., characters are displayed by empty boxes. */
7206 static struct face
*
7207 realize_non_ascii_face (f
, font_id
, base_face
)
7210 struct face
*base_face
;
7212 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
7214 struct font_info
*font_info
;
7216 face
= (struct face
*) xmalloc (sizeof *face
);
7220 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7221 face
->colors_copied_bitwise_p
= 1;
7223 face
->font_info_id
= font_id
;
7226 font_info
= FONT_INFO_FROM_ID (f
, font_id
);
7227 face
->font
= font_info
->font
;
7228 face
->font_name
= font_info
->full_name
;
7233 face
->font_name
= NULL
;
7238 cache_face (cache
, face
, face
->hash
);
7244 /* Realize the fully-specified face with attributes ATTRS in face
7245 cache CACHE for ASCII characters. Do it for X frame CACHE->f. If
7246 the new face doesn't share font with the default face, a fontname
7247 is allocated from the heap and set in `font_name' of the new face,
7248 but it is not yet loaded here. Value is a pointer to the newly
7249 created realized face. */
7251 static struct face
*
7252 realize_x_face (cache
, attrs
)
7253 struct face_cache
*cache
;
7256 #ifdef HAVE_WINDOW_SYSTEM
7257 struct face
*face
, *default_face
;
7259 Lisp_Object stipple
, overline
, strike_through
, box
;
7261 xassert (FRAME_WINDOW_P (cache
->f
));
7263 /* Allocate a new realized face. */
7264 face
= make_realized_face (attrs
);
7265 face
->ascii_face
= face
;
7269 /* Determine the font to use. Most of the time, the font will be
7270 the same as the font of the default face, so try that first. */
7271 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7273 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7275 face
->font
= default_face
->font
;
7276 face
->font_info_id
= default_face
->font_info_id
;
7277 face
->font_name
= default_face
->font_name
;
7279 = make_fontset_for_ascii_face (f
, default_face
->fontset
, face
);
7283 /* If the face attribute ATTRS specifies a fontset, use it as
7284 the base of a new realized fontset. Otherwise, use the same
7285 base fontset as of the default face. The base determines
7286 registry and encoding of a font. It may also determine
7287 foundry and family. The other fields of font name pattern
7288 are constructed from ATTRS. */
7289 int fontset
= face_fontset (attrs
);
7291 /* If we are realizing the default face, ATTRS should specify a
7292 fontset. In other words, if FONTSET is -1, we are not
7293 realizing the default face, thus the default face should have
7294 already been realized. */
7296 fontset
= default_face
->fontset
;
7299 load_face_font (f
, face
);
7300 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
, face
);
7303 /* Load colors, and set remaining attributes. */
7305 load_face_colors (f
, face
, attrs
);
7308 box
= attrs
[LFACE_BOX_INDEX
];
7311 /* A simple box of line width 1 drawn in color given by
7313 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7315 face
->box
= FACE_SIMPLE_BOX
;
7316 face
->box_line_width
= 1;
7318 else if (INTEGERP (box
))
7320 /* Simple box of specified line width in foreground color of the
7322 xassert (XINT (box
) != 0);
7323 face
->box
= FACE_SIMPLE_BOX
;
7324 face
->box_line_width
= XINT (box
);
7325 face
->box_color
= face
->foreground
;
7326 face
->box_color_defaulted_p
= 1;
7328 else if (CONSP (box
))
7330 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7331 being one of `raised' or `sunken'. */
7332 face
->box
= FACE_SIMPLE_BOX
;
7333 face
->box_color
= face
->foreground
;
7334 face
->box_color_defaulted_p
= 1;
7335 face
->box_line_width
= 1;
7339 Lisp_Object keyword
, value
;
7341 keyword
= XCAR (box
);
7349 if (EQ (keyword
, QCline_width
))
7351 if (INTEGERP (value
) && XINT (value
) != 0)
7352 face
->box_line_width
= XINT (value
);
7354 else if (EQ (keyword
, QCcolor
))
7356 if (STRINGP (value
))
7358 face
->box_color
= load_color (f
, face
, value
,
7360 face
->use_box_color_for_shadows_p
= 1;
7363 else if (EQ (keyword
, QCstyle
))
7365 if (EQ (value
, Qreleased_button
))
7366 face
->box
= FACE_RAISED_BOX
;
7367 else if (EQ (value
, Qpressed_button
))
7368 face
->box
= FACE_SUNKEN_BOX
;
7373 /* Text underline, overline, strike-through. */
7375 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7377 /* Use default color (same as foreground color). */
7378 face
->underline_p
= 1;
7379 face
->underline_defaulted_p
= 1;
7380 face
->underline_color
= 0;
7382 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7384 /* Use specified color. */
7385 face
->underline_p
= 1;
7386 face
->underline_defaulted_p
= 0;
7387 face
->underline_color
7388 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7389 LFACE_UNDERLINE_INDEX
);
7391 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7393 face
->underline_p
= 0;
7394 face
->underline_defaulted_p
= 0;
7395 face
->underline_color
= 0;
7398 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7399 if (STRINGP (overline
))
7401 face
->overline_color
7402 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7403 LFACE_OVERLINE_INDEX
);
7404 face
->overline_p
= 1;
7406 else if (EQ (overline
, Qt
))
7408 face
->overline_color
= face
->foreground
;
7409 face
->overline_color_defaulted_p
= 1;
7410 face
->overline_p
= 1;
7413 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7414 if (STRINGP (strike_through
))
7416 face
->strike_through_color
7417 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7418 LFACE_STRIKE_THROUGH_INDEX
);
7419 face
->strike_through_p
= 1;
7421 else if (EQ (strike_through
, Qt
))
7423 face
->strike_through_color
= face
->foreground
;
7424 face
->strike_through_color_defaulted_p
= 1;
7425 face
->strike_through_p
= 1;
7428 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7429 if (!NILP (stipple
))
7430 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7433 #endif /* HAVE_WINDOW_SYSTEM */
7437 /* Map a specified color of face FACE on frame F to a tty color index.
7438 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7439 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7440 default foreground/background colors. */
7443 map_tty_color (f
, face
, idx
, defaulted
)
7446 enum lface_attribute_index idx
;
7449 Lisp_Object frame
, color
, def
;
7450 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7451 unsigned long default_pixel
, default_other_pixel
, pixel
;
7453 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7457 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7458 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7462 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7463 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7466 XSETFRAME (frame
, f
);
7467 color
= face
->lface
[idx
];
7471 && CONSP (Vtty_defined_color_alist
)
7472 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7475 /* Associations in tty-defined-color-alist are of the form
7476 (NAME INDEX R G B). We need the INDEX part. */
7477 pixel
= XINT (XCAR (XCDR (def
)));
7480 if (pixel
== default_pixel
&& STRINGP (color
))
7482 pixel
= load_color (f
, face
, color
, idx
);
7484 #if defined (MSDOS) || defined (WINDOWSNT)
7485 /* If the foreground of the default face is the default color,
7486 use the foreground color defined by the frame. */
7488 if (FRAME_MSDOS_P (f
))
7491 if (pixel
== default_pixel
7492 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7495 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7497 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7498 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7501 else if (pixel
== default_other_pixel
)
7504 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7506 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7507 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7513 #endif /* MSDOS or WINDOWSNT */
7517 face
->foreground
= pixel
;
7519 face
->background
= pixel
;
7523 /* Realize the fully-specified face with attributes ATTRS in face
7524 cache CACHE for ASCII characters. Do it for TTY frame CACHE->f.
7525 Value is a pointer to the newly created realized face. */
7527 static struct face
*
7528 realize_tty_face (cache
, attrs
)
7529 struct face_cache
*cache
;
7534 int face_colors_defaulted
= 0;
7535 struct frame
*f
= cache
->f
;
7537 /* Frame must be a termcap frame. */
7538 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7540 /* Allocate a new realized face. */
7541 face
= make_realized_face (attrs
);
7542 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7544 /* Map face attributes to TTY appearances. We map slant to
7545 dimmed text because we want italic text to appear differently
7546 and because dimmed text is probably used infrequently. */
7547 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7548 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7550 if (weight
> XLFD_WEIGHT_MEDIUM
)
7551 face
->tty_bold_p
= 1;
7552 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7553 face
->tty_dim_p
= 1;
7554 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7555 face
->tty_underline_p
= 1;
7556 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7557 face
->tty_reverse_p
= 1;
7559 /* Map color names to color indices. */
7560 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7561 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7563 /* Swap colors if face is inverse-video. If the colors are taken
7564 from the frame colors, they are already inverted, since the
7565 frame-creation function calls x-handle-reverse-video. */
7566 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7568 unsigned long tem
= face
->foreground
;
7569 face
->foreground
= face
->background
;
7570 face
->background
= tem
;
7573 if (tty_suppress_bold_inverse_default_colors_p
7575 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7576 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7577 face
->tty_bold_p
= 0;
7583 DEFUN ("tty-suppress-bold-inverse-default-colors",
7584 Ftty_suppress_bold_inverse_default_colors
,
7585 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7586 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7587 SUPPRESS non-nil means suppress it.
7588 This affects bold faces on TTYs whose foreground is the default background
7589 color of the display and whose background is the default foreground color.
7590 For such faces, the bold face attribute is ignored if this variable
7593 Lisp_Object suppress
;
7595 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7596 ++face_change_count
;
7602 /***********************************************************************
7604 ***********************************************************************/
7606 /* Return the ID of the face to use to display character CH with face
7607 property PROP on frame F in current_buffer. */
7610 compute_char_face (f
, ch
, prop
)
7617 if (NILP (current_buffer
->enable_multibyte_characters
))
7622 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7623 face_id
= FACE_FOR_CHAR (f
, face
, ch
, -1, Qnil
);
7627 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7628 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7629 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7630 merge_face_ref (f
, prop
, attrs
, 1, 0);
7631 face_id
= lookup_face (f
, attrs
);
7637 /* Return the face ID associated with buffer position POS for
7638 displaying ASCII characters. Return in *ENDPTR the position at
7639 which a different face is needed, as far as text properties and
7640 overlays are concerned. W is a window displaying current_buffer.
7642 REGION_BEG, REGION_END delimit the region, so it can be
7645 LIMIT is a position not to scan beyond. That is to limit the time
7646 this function can take.
7648 If MOUSE is non-zero, use the character's mouse-face, not its face.
7650 The face returned is suitable for displaying ASCII characters. */
7653 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7654 endptr
, limit
, mouse
)
7657 int region_beg
, region_end
;
7662 struct frame
*f
= XFRAME (w
->frame
);
7663 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7664 Lisp_Object prop
, position
;
7666 Lisp_Object
*overlay_vec
;
7669 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7670 Lisp_Object limit1
, end
;
7671 struct face
*default_face
;
7673 /* W must display the current buffer. We could write this function
7674 to use the frame and buffer of W, but right now it doesn't. */
7675 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7677 XSETFRAME (frame
, f
);
7678 XSETFASTINT (position
, pos
);
7681 if (pos
< region_beg
&& region_beg
< endpos
)
7682 endpos
= region_beg
;
7684 /* Get the `face' or `mouse_face' text property at POS, and
7685 determine the next position at which the property changes. */
7686 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7687 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7688 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7690 endpos
= XINT (end
);
7692 /* Look at properties from overlays. */
7696 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7697 if (next_overlay
< endpos
)
7698 endpos
= next_overlay
;
7703 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7705 /* Optimize common cases where we can use the default face. */
7708 && !(pos
>= region_beg
&& pos
< region_end
))
7709 return DEFAULT_FACE_ID
;
7711 /* Begin with attributes from the default face. */
7712 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7714 /* Merge in attributes specified via text properties. */
7716 merge_face_ref (f
, prop
, attrs
, 1, 0);
7718 /* Now merge the overlay data. */
7719 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7720 for (i
= 0; i
< noverlays
; i
++)
7725 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7727 merge_face_ref (f
, prop
, attrs
, 1, 0);
7729 oend
= OVERLAY_END (overlay_vec
[i
]);
7730 oendpos
= OVERLAY_POSITION (oend
);
7731 if (oendpos
< endpos
)
7735 /* If in the region, merge in the region face. */
7736 if (pos
>= region_beg
&& pos
< region_end
)
7738 merge_named_face (f
, Qregion
, attrs
, 0);
7740 if (region_end
< endpos
)
7741 endpos
= region_end
;
7746 /* Look up a realized face with the given face attributes,
7747 or realize a new one for ASCII characters. */
7748 return lookup_face (f
, attrs
);
7752 /* Compute the face at character position POS in Lisp string STRING on
7753 window W, for ASCII characters.
7755 If STRING is an overlay string, it comes from position BUFPOS in
7756 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7757 not an overlay string. W must display the current buffer.
7758 REGION_BEG and REGION_END give the start and end positions of the
7759 region; both are -1 if no region is visible.
7761 BASE_FACE_ID is the id of a face to merge with. For strings coming
7762 from overlays or the `display' property it is the face at BUFPOS.
7764 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7766 Set *ENDPTR to the next position where to check for faces in
7767 STRING; -1 if the face is constant from POS to the end of the
7770 Value is the id of the face to use. The face returned is suitable
7771 for displaying ASCII characters. */
7774 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7775 region_end
, endptr
, base_face_id
, mouse_p
)
7779 int region_beg
, region_end
;
7781 enum face_id base_face_id
;
7784 Lisp_Object prop
, position
, end
, limit
;
7785 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7786 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7787 struct face
*base_face
;
7788 int multibyte_p
= STRING_MULTIBYTE (string
);
7789 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7791 /* Get the value of the face property at the current position within
7792 STRING. Value is nil if there is no face property. */
7793 XSETFASTINT (position
, pos
);
7794 prop
= Fget_text_property (position
, prop_name
, string
);
7796 /* Get the next position at which to check for faces. Value of end
7797 is nil if face is constant all the way to the end of the string.
7798 Otherwise it is a string position where to check faces next.
7799 Limit is the maximum position up to which to check for property
7800 changes in Fnext_single_property_change. Strings are usually
7801 short, so set the limit to the end of the string. */
7802 XSETFASTINT (limit
, SCHARS (string
));
7803 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7805 *endptr
= XFASTINT (end
);
7809 base_face
= FACE_FROM_ID (f
, base_face_id
);
7810 xassert (base_face
);
7812 /* Optimize the default case that there is no face property and we
7813 are not in the region. */
7815 && (base_face_id
!= DEFAULT_FACE_ID
7816 /* BUFPOS <= 0 means STRING is not an overlay string, so
7817 that the region doesn't have to be taken into account. */
7819 || bufpos
< region_beg
7820 || bufpos
>= region_end
)
7822 /* We can't realize faces for different charsets differently
7823 if we don't have fonts, so we can stop here if not working
7824 on a window-system frame. */
7825 || !FRAME_WINDOW_P (f
)
7826 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7827 return base_face
->id
;
7829 /* Begin with attributes from the base face. */
7830 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7832 /* Merge in attributes specified via text properties. */
7834 merge_face_ref (f
, prop
, attrs
, 1, 0);
7836 /* If in the region, merge in the region face. */
7838 && bufpos
>= region_beg
7839 && bufpos
< region_end
)
7840 merge_named_face (f
, Qregion
, attrs
, 0);
7842 /* Look up a realized face with the given face attributes,
7843 or realize a new one for ASCII characters. */
7844 return lookup_face (f
, attrs
);
7849 /***********************************************************************
7851 ***********************************************************************/
7855 /* Print the contents of the realized face FACE to stderr. */
7858 dump_realized_face (face
)
7861 fprintf (stderr
, "ID: %d\n", face
->id
);
7862 #ifdef HAVE_X_WINDOWS
7863 fprintf (stderr
, "gc: %d\n", (int) face
->gc
);
7865 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7867 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7868 fprintf (stderr
, "background: 0x%lx (%s)\n",
7870 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7871 fprintf (stderr
, "font_name: %s (%s)\n",
7873 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7874 #ifdef HAVE_X_WINDOWS
7875 fprintf (stderr
, "font = %p\n", face
->font
);
7877 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7878 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7879 fprintf (stderr
, "underline: %d (%s)\n",
7881 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7882 fprintf (stderr
, "hash: %d\n", face
->hash
);
7886 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7894 fprintf (stderr
, "font selection order: ");
7895 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7896 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7897 fprintf (stderr
, "\n");
7899 fprintf (stderr
, "alternative fonts: ");
7900 debug_print (Vface_alternative_font_family_alist
);
7901 fprintf (stderr
, "\n");
7903 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7904 Fdump_face (make_number (i
));
7910 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7912 error ("Not a valid face");
7913 dump_realized_face (face
);
7920 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7921 0, 0, 0, doc
: /* */)
7924 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7925 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7926 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7930 #endif /* GLYPH_DEBUG != 0 */
7934 /***********************************************************************
7936 ***********************************************************************/
7941 Qface
= intern ("face");
7943 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7944 staticpro (&Qbitmap_spec_p
);
7945 Qframe_update_face_colors
= intern ("frame-update-face-colors");
7946 staticpro (&Qframe_update_face_colors
);
7948 /* Lisp face attribute keywords. */
7949 QCfamily
= intern (":family");
7950 staticpro (&QCfamily
);
7951 QCheight
= intern (":height");
7952 staticpro (&QCheight
);
7953 QCweight
= intern (":weight");
7954 staticpro (&QCweight
);
7955 QCslant
= intern (":slant");
7956 staticpro (&QCslant
);
7957 QCunderline
= intern (":underline");
7958 staticpro (&QCunderline
);
7959 QCinverse_video
= intern (":inverse-video");
7960 staticpro (&QCinverse_video
);
7961 QCreverse_video
= intern (":reverse-video");
7962 staticpro (&QCreverse_video
);
7963 QCforeground
= intern (":foreground");
7964 staticpro (&QCforeground
);
7965 QCbackground
= intern (":background");
7966 staticpro (&QCbackground
);
7967 QCstipple
= intern (":stipple");;
7968 staticpro (&QCstipple
);
7969 QCwidth
= intern (":width");
7970 staticpro (&QCwidth
);
7971 QCfont
= intern (":font");
7972 staticpro (&QCfont
);
7973 QCfontset
= intern (":fontset");
7974 staticpro (&QCfontset
);
7975 QCbold
= intern (":bold");
7976 staticpro (&QCbold
);
7977 QCitalic
= intern (":italic");
7978 staticpro (&QCitalic
);
7979 QCoverline
= intern (":overline");
7980 staticpro (&QCoverline
);
7981 QCstrike_through
= intern (":strike-through");
7982 staticpro (&QCstrike_through
);
7983 QCbox
= intern (":box");
7985 QCinherit
= intern (":inherit");
7986 staticpro (&QCinherit
);
7988 /* Symbols used for Lisp face attribute values. */
7989 QCcolor
= intern (":color");
7990 staticpro (&QCcolor
);
7991 QCline_width
= intern (":line-width");
7992 staticpro (&QCline_width
);
7993 QCstyle
= intern (":style");
7994 staticpro (&QCstyle
);
7995 Qreleased_button
= intern ("released-button");
7996 staticpro (&Qreleased_button
);
7997 Qpressed_button
= intern ("pressed-button");
7998 staticpro (&Qpressed_button
);
7999 Qnormal
= intern ("normal");
8000 staticpro (&Qnormal
);
8001 Qultra_light
= intern ("ultra-light");
8002 staticpro (&Qultra_light
);
8003 Qextra_light
= intern ("extra-light");
8004 staticpro (&Qextra_light
);
8005 Qlight
= intern ("light");
8006 staticpro (&Qlight
);
8007 Qsemi_light
= intern ("semi-light");
8008 staticpro (&Qsemi_light
);
8009 Qsemi_bold
= intern ("semi-bold");
8010 staticpro (&Qsemi_bold
);
8011 Qbold
= intern ("bold");
8013 Qextra_bold
= intern ("extra-bold");
8014 staticpro (&Qextra_bold
);
8015 Qultra_bold
= intern ("ultra-bold");
8016 staticpro (&Qultra_bold
);
8017 Qoblique
= intern ("oblique");
8018 staticpro (&Qoblique
);
8019 Qitalic
= intern ("italic");
8020 staticpro (&Qitalic
);
8021 Qreverse_oblique
= intern ("reverse-oblique");
8022 staticpro (&Qreverse_oblique
);
8023 Qreverse_italic
= intern ("reverse-italic");
8024 staticpro (&Qreverse_italic
);
8025 Qultra_condensed
= intern ("ultra-condensed");
8026 staticpro (&Qultra_condensed
);
8027 Qextra_condensed
= intern ("extra-condensed");
8028 staticpro (&Qextra_condensed
);
8029 Qcondensed
= intern ("condensed");
8030 staticpro (&Qcondensed
);
8031 Qsemi_condensed
= intern ("semi-condensed");
8032 staticpro (&Qsemi_condensed
);
8033 Qsemi_expanded
= intern ("semi-expanded");
8034 staticpro (&Qsemi_expanded
);
8035 Qexpanded
= intern ("expanded");
8036 staticpro (&Qexpanded
);
8037 Qextra_expanded
= intern ("extra-expanded");
8038 staticpro (&Qextra_expanded
);
8039 Qultra_expanded
= intern ("ultra-expanded");
8040 staticpro (&Qultra_expanded
);
8041 Qbackground_color
= intern ("background-color");
8042 staticpro (&Qbackground_color
);
8043 Qforeground_color
= intern ("foreground-color");
8044 staticpro (&Qforeground_color
);
8045 Qunspecified
= intern ("unspecified");
8046 staticpro (&Qunspecified
);
8048 Qface_alias
= intern ("face-alias");
8049 staticpro (&Qface_alias
);
8050 Qdefault
= intern ("default");
8051 staticpro (&Qdefault
);
8052 Qtool_bar
= intern ("tool-bar");
8053 staticpro (&Qtool_bar
);
8054 Qregion
= intern ("region");
8055 staticpro (&Qregion
);
8056 Qfringe
= intern ("fringe");
8057 staticpro (&Qfringe
);
8058 Qheader_line
= intern ("header-line");
8059 staticpro (&Qheader_line
);
8060 Qscroll_bar
= intern ("scroll-bar");
8061 staticpro (&Qscroll_bar
);
8062 Qmenu
= intern ("menu");
8064 Qcursor
= intern ("cursor");
8065 staticpro (&Qcursor
);
8066 Qborder
= intern ("border");
8067 staticpro (&Qborder
);
8068 Qmouse
= intern ("mouse");
8069 staticpro (&Qmouse
);
8070 Qmode_line_inactive
= intern ("mode-line-inactive");
8071 staticpro (&Qmode_line_inactive
);
8072 Qtty_color_desc
= intern ("tty-color-desc");
8073 staticpro (&Qtty_color_desc
);
8074 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8075 staticpro (&Qtty_color_standard_values
);
8076 Qtty_color_by_index
= intern ("tty-color-by-index");
8077 staticpro (&Qtty_color_by_index
);
8078 Qtty_color_alist
= intern ("tty-color-alist");
8079 staticpro (&Qtty_color_alist
);
8080 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8081 staticpro (&Qscalable_fonts_allowed
);
8083 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8084 staticpro (&Vparam_value_alist
);
8085 Vface_alternative_font_family_alist
= Qnil
;
8086 staticpro (&Vface_alternative_font_family_alist
);
8087 Vface_alternative_font_registry_alist
= Qnil
;
8088 staticpro (&Vface_alternative_font_registry_alist
);
8090 defsubr (&Sinternal_make_lisp_face
);
8091 defsubr (&Sinternal_lisp_face_p
);
8092 defsubr (&Sinternal_set_lisp_face_attribute
);
8093 #ifdef HAVE_WINDOW_SYSTEM
8094 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8096 defsubr (&Scolor_gray_p
);
8097 defsubr (&Scolor_supported_p
);
8098 defsubr (&Sface_attribute_relative_p
);
8099 defsubr (&Smerge_face_attribute
);
8100 defsubr (&Sinternal_get_lisp_face_attribute
);
8101 defsubr (&Sinternal_lisp_face_attribute_values
);
8102 defsubr (&Sinternal_lisp_face_equal_p
);
8103 defsubr (&Sinternal_lisp_face_empty_p
);
8104 defsubr (&Sinternal_copy_lisp_face
);
8105 defsubr (&Sinternal_merge_in_global_face
);
8106 defsubr (&Sface_font
);
8107 defsubr (&Sframe_face_alist
);
8108 defsubr (&Sdisplay_supports_face_attributes_p
);
8109 defsubr (&Scolor_distance
);
8110 defsubr (&Sinternal_set_font_selection_order
);
8111 defsubr (&Sinternal_set_alternative_font_family_alist
);
8112 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8113 defsubr (&Sface_attributes_as_vector
);
8115 defsubr (&Sdump_face
);
8116 defsubr (&Sshow_face_resources
);
8117 #endif /* GLYPH_DEBUG */
8118 defsubr (&Sclear_face_cache
);
8119 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8121 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8122 defsubr (&Sdump_colors
);
8125 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8126 doc
: /* *Limit for font matching.
8127 If an integer > 0, font matching functions won't load more than
8128 that number of fonts when searching for a matching font. */);
8129 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8131 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8132 doc
: /* List of global face definitions (for internal use only.) */);
8133 Vface_new_frame_defaults
= Qnil
;
8135 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8136 doc
: /* *Default stipple pattern used on monochrome displays.
8137 This stipple pattern is used on monochrome displays
8138 instead of shades of gray for a face background color.
8139 See `set-face-stipple' for possible values for this variable. */);
8140 Vface_default_stipple
= build_string ("gray3");
8142 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8143 doc
: /* An alist of defined terminal colors and their RGB values. */);
8144 Vtty_defined_color_alist
= Qnil
;
8146 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8147 doc
: /* Allowed scalable fonts.
8148 A value of nil means don't allow any scalable fonts.
8149 A value of t means allow any scalable font.
8150 Otherwise, value must be a list of regular expressions. A font may be
8151 scaled if its name matches a regular expression in the list.
8152 Note that if value is nil, a scalable font might still be used, if no
8153 other font of the appropriate family and registry is available. */);
8154 Vscalable_fonts_allowed
= Qnil
;
8156 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8157 doc
: /* List of ignored fonts.
8158 Each element is a regular expression that matches names of fonts to
8160 Vface_ignored_fonts
= Qnil
;
8162 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8163 doc
: /* Alist of fonts vs the rescaling factors.
8164 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8165 FONT-NAME-PATTERN is a regular expression matching a font name, and
8166 RESCALE-RATIO is a floating point number to specify how much larger
8167 \(or smaller) font we should use. For instance, if a face requests
8168 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8169 Vface_font_rescale_alist
= Qnil
;
8171 #ifdef HAVE_WINDOW_SYSTEM
8172 defsubr (&Sbitmap_spec_p
);
8173 defsubr (&Sx_list_fonts
);
8174 defsubr (&Sinternal_face_x_get_resource
);
8175 defsubr (&Sx_family_fonts
);
8176 defsubr (&Sx_font_family_list
);
8177 #endif /* HAVE_WINDOW_SYSTEM */
8180 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8181 (do not change this comment) */