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 #ifdef HAVE_WINDOW_SYSTEM
5001 if (!NILP (character
))
5003 CHECK_CHARACTER (character
);
5004 face_id
= FACE_FOR_CHAR (f
, face
, XINT (character
), -1, Qnil
);
5005 face
= FACE_FROM_ID (f
, face_id
);
5006 return (face
->font
&& face
->font_name
5007 ? build_string (face
->font_name
)
5011 return build_string (face
->font_name
);
5016 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
5017 all attributes are `equal'. Tries to be fast because this function
5018 is called quite often. */
5021 face_attr_equal_p (v1
, v2
)
5024 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5025 and the other is specified. */
5026 if (XTYPE (v1
) != XTYPE (v2
))
5035 if (SBYTES (v1
) != SBYTES (v2
))
5038 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5045 return !NILP (Fequal (v1
, v2
));
5050 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5051 all attributes are `equal'. Tries to be fast because this function
5052 is called quite often. */
5055 lface_equal_p (v1
, v2
)
5056 Lisp_Object
*v1
, *v2
;
5060 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5061 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5067 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5068 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5069 doc
: /* True if FACE1 and FACE2 are equal.
5070 If the optional argument FRAME is given, report on face FACE in that frame.
5071 If FRAME is t, report on the defaults for face FACE (for new frames).
5072 If FRAME is omitted or nil, use the selected frame. */)
5073 (face1
, face2
, frame
)
5074 Lisp_Object face1
, face2
, frame
;
5077 Lisp_Object lface1
, lface2
;
5079 lface1
= lface_from_face_name (NULL
, face1
, 1);
5080 lface2
= lface_from_face_name (NULL
, face2
, 1);
5081 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5082 XVECTOR (lface2
)->contents
);
5083 return equal_p
? Qt
: Qnil
;
5087 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5088 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5089 doc
: /* True if FACE has no attribute specified.
5090 If the optional argument FRAME is given, report on face FACE in that frame.
5091 If FRAME is t, report on the defaults for face FACE (for new frames).
5092 If FRAME is omitted or nil, use the selected frame. */)
5094 Lisp_Object face
, frame
;
5101 frame
= selected_frame
;
5102 CHECK_LIVE_FRAME (frame
);
5106 lface
= lface_from_face_name (NULL
, face
, 1);
5108 lface
= lface_from_face_name (f
, face
, 1);
5110 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5111 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5114 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5118 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5120 doc
: /* Return an alist of frame-local faces defined on FRAME.
5121 For internal use only. */)
5125 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5126 return f
->face_alist
;
5130 /* Return a hash code for Lisp string STRING with case ignored. Used
5131 below in computing a hash value for a Lisp face. */
5133 static INLINE
unsigned
5134 hash_string_case_insensitive (string
)
5137 const unsigned char *s
;
5139 xassert (STRINGP (string
));
5140 for (s
= SDATA (string
); *s
; ++s
)
5141 hash
= (hash
<< 1) ^ tolower (*s
);
5146 /* Return a hash code for face attribute vector V. */
5148 static INLINE
unsigned
5152 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5153 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5154 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5155 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5156 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5157 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5158 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5162 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5163 considering charsets/registries). They do if they specify the same
5164 family, point size, weight, width, slant, font, and fontset. Both
5165 LFACE1 and LFACE2 must be fully-specified. */
5168 lface_same_font_attributes_p (lface1
, lface2
)
5169 Lisp_Object
*lface1
, *lface2
;
5171 xassert (lface_fully_specified_p (lface1
)
5172 && lface_fully_specified_p (lface2
));
5173 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5174 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5175 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5176 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5177 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5178 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5179 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5180 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5181 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5182 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5183 && ! xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5184 SDATA (lface2
[LFACE_FONT_INDEX
]))))
5185 && (EQ (lface1
[LFACE_FONTSET_INDEX
], lface2
[LFACE_FONTSET_INDEX
])
5186 || (STRINGP (lface1
[LFACE_FONTSET_INDEX
])
5187 && STRINGP (lface2
[LFACE_FONTSET_INDEX
])
5188 && ! xstricmp (SDATA (lface1
[LFACE_FONTSET_INDEX
]),
5189 SDATA (lface2
[LFACE_FONTSET_INDEX
]))))
5195 /***********************************************************************
5197 ***********************************************************************/
5199 /* Allocate and return a new realized face for Lisp face attribute
5202 static struct face
*
5203 make_realized_face (attr
)
5206 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5207 bzero (face
, sizeof *face
);
5208 face
->ascii_face
= face
;
5209 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5214 /* Free realized face FACE, including its X resources. FACE may
5218 free_realized_face (f
, face
)
5224 #ifdef HAVE_WINDOW_SYSTEM
5225 if (FRAME_WINDOW_P (f
))
5227 /* Free fontset of FACE if it is ASCII face. */
5228 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5229 free_face_fontset (f
, face
);
5232 x_free_gc (f
, face
->gc
);
5236 free_face_colors (f
, face
);
5237 x_destroy_bitmap (f
, face
->stipple
);
5239 #endif /* HAVE_WINDOW_SYSTEM */
5246 /* Prepare face FACE for subsequent display on frame F. This
5247 allocated GCs if they haven't been allocated yet or have been freed
5248 by clearing the face cache. */
5251 prepare_face_for_display (f
, face
)
5255 #ifdef HAVE_WINDOW_SYSTEM
5256 xassert (FRAME_WINDOW_P (f
));
5261 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5263 xgcv
.foreground
= face
->foreground
;
5264 xgcv
.background
= face
->background
;
5265 #ifdef HAVE_X_WINDOWS
5266 xgcv
.graphics_exposures
= False
;
5268 /* The font of FACE may be null if we couldn't load it. */
5271 #ifdef HAVE_X_WINDOWS
5272 xgcv
.font
= face
->font
->fid
;
5275 xgcv
.font
= face
->font
;
5278 xgcv
.font
= face
->font
;
5284 #ifdef HAVE_X_WINDOWS
5287 xgcv
.fill_style
= FillOpaqueStippled
;
5288 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5289 mask
|= GCFillStyle
| GCStipple
;
5292 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5295 #endif /* HAVE_WINDOW_SYSTEM */
5299 /* Returns the `distance' between the colors X and Y. */
5302 color_distance (x
, y
)
5305 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5306 Quoting from that paper:
5308 This formula has results that are very close to L*u*v* (with the
5309 modified lightness curve) and, more importantly, it is a more even
5310 algorithm: it does not have a range of colours where it suddenly
5311 gives far from optimal results.
5313 See <http://www.compuphase.com/cmetric.htm> for more info. */
5315 long r
= (x
->red
- y
->red
) >> 8;
5316 long g
= (x
->green
- y
->green
) >> 8;
5317 long b
= (x
->blue
- y
->blue
) >> 8;
5318 long r_mean
= (x
->red
+ y
->red
) >> 9;
5321 (((512 + r_mean
) * r
* r
) >> 8)
5323 + (((767 - r_mean
) * b
* b
) >> 8);
5327 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5328 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5329 COLOR1 and COLOR2 may be either strings containing the color name,
5330 or lists of the form (RED GREEN BLUE).
5331 If FRAME is unspecified or nil, the current frame is used. */)
5332 (color1
, color2
, frame
)
5333 Lisp_Object color1
, color2
, frame
;
5336 XColor cdef1
, cdef2
;
5339 frame
= selected_frame
;
5340 CHECK_LIVE_FRAME (frame
);
5343 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5344 || !STRINGP (color1
)
5345 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5346 signal_error ("Invalid color", color1
);
5347 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5348 || !STRINGP (color2
)
5349 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5350 signal_error ("Invalid color", color2
);
5352 return make_number (color_distance (&cdef1
, &cdef2
));
5356 /***********************************************************************
5358 ***********************************************************************/
5360 /* Return a new face cache for frame F. */
5362 static struct face_cache
*
5366 struct face_cache
*c
;
5369 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5370 bzero (c
, sizeof *c
);
5371 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5372 c
->buckets
= (struct face
**) xmalloc (size
);
5373 bzero (c
->buckets
, size
);
5375 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5377 c
->menu_face_changed_p
= menu_face_changed_default
;
5382 /* Clear out all graphics contexts for all realized faces, except for
5383 the basic faces. This should be done from time to time just to avoid
5384 keeping too many graphics contexts that are no longer needed. */
5388 struct face_cache
*c
;
5390 if (c
&& FRAME_WINDOW_P (c
->f
))
5392 #ifdef HAVE_WINDOW_SYSTEM
5394 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5396 struct face
*face
= c
->faces_by_id
[i
];
5397 if (face
&& face
->gc
)
5399 x_free_gc (c
->f
, face
->gc
);
5403 #endif /* HAVE_WINDOW_SYSTEM */
5408 /* Free all realized faces in face cache C, including basic faces.
5409 C may be null. If faces are freed, make sure the frame's current
5410 matrix is marked invalid, so that a display caused by an expose
5411 event doesn't try to use faces we destroyed. */
5414 free_realized_faces (c
)
5415 struct face_cache
*c
;
5420 struct frame
*f
= c
->f
;
5422 /* We must block input here because we can't process X events
5423 safely while only some faces are freed, or when the frame's
5424 current matrix still references freed faces. */
5427 for (i
= 0; i
< c
->used
; ++i
)
5429 free_realized_face (f
, c
->faces_by_id
[i
]);
5430 c
->faces_by_id
[i
] = NULL
;
5434 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5435 bzero (c
->buckets
, size
);
5437 /* Must do a thorough redisplay the next time. Mark current
5438 matrices as invalid because they will reference faces freed
5439 above. This function is also called when a frame is
5440 destroyed. In this case, the root window of F is nil. */
5441 if (WINDOWP (f
->root_window
))
5443 clear_current_matrices (f
);
5444 ++windows_or_buffers_changed
;
5452 /* Free all realized faces that are using FONTSET on frame F. */
5455 free_realized_faces_for_fontset (f
, fontset
)
5459 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5463 /* We must block input here because we can't process X events safely
5464 while only some faces are freed, or when the frame's current
5465 matrix still references freed faces. */
5468 for (i
= 0; i
< cache
->used
; i
++)
5470 face
= cache
->faces_by_id
[i
];
5472 && face
->fontset
== fontset
)
5474 uncache_face (cache
, face
);
5475 free_realized_face (f
, face
);
5479 /* Must do a thorough redisplay the next time. Mark current
5480 matrices as invalid because they will reference faces freed
5481 above. This function is also called when a frame is destroyed.
5482 In this case, the root window of F is nil. */
5483 if (WINDOWP (f
->root_window
))
5485 clear_current_matrices (f
);
5486 ++windows_or_buffers_changed
;
5493 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5494 This is done after attributes of a named face have been changed,
5495 because we can't tell which realized faces depend on that face. */
5498 free_all_realized_faces (frame
)
5504 FOR_EACH_FRAME (rest
, frame
)
5505 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5508 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5512 /* Free face cache C and faces in it, including their X resources. */
5516 struct face_cache
*c
;
5520 free_realized_faces (c
);
5522 xfree (c
->faces_by_id
);
5528 /* Cache realized face FACE in face cache C. HASH is the hash value
5529 of FACE. If FACE is for ASCII characters (i.e. FACE->ascii_face ==
5530 FACE), insert the new face to the beginning of the collision list
5531 of the face hash table of C. Otherwise, add the new face to the
5532 end of the collision list. This way, lookup_face can quickly find
5533 that a requested face is not cached. */
5536 cache_face (c
, face
, hash
)
5537 struct face_cache
*c
;
5541 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5545 if (face
->ascii_face
!= face
)
5547 struct face
*last
= c
->buckets
[i
];
5558 c
->buckets
[i
] = face
;
5559 face
->prev
= face
->next
= NULL
;
5565 face
->next
= c
->buckets
[i
];
5567 face
->next
->prev
= face
;
5568 c
->buckets
[i
] = face
;
5571 /* Find a free slot in C->faces_by_id and use the index of the free
5572 slot as FACE->id. */
5573 for (i
= 0; i
< c
->used
; ++i
)
5574 if (c
->faces_by_id
[i
] == NULL
)
5578 /* Maybe enlarge C->faces_by_id. */
5581 if (c
->used
== c
->size
)
5584 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5585 if (new_size
== c
->size
)
5586 abort (); /* Alternatives? ++kfs */
5587 sz
= new_size
* sizeof *c
->faces_by_id
;
5588 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5595 /* Check that FACE got a unique id. */
5600 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5601 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5607 #endif /* GLYPH_DEBUG */
5609 c
->faces_by_id
[i
] = face
;
5613 /* Remove face FACE from cache C. */
5616 uncache_face (c
, face
)
5617 struct face_cache
*c
;
5620 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5623 face
->prev
->next
= face
->next
;
5625 c
->buckets
[i
] = face
->next
;
5628 face
->next
->prev
= face
->prev
;
5630 c
->faces_by_id
[face
->id
] = NULL
;
5631 if (face
->id
== c
->used
)
5636 /* Look up a realized face with face attributes ATTR in the face cache
5637 of frame F. The face will be used to display ASCII characters.
5638 Value is the ID of the face found. If no suitable face is found,
5639 realize a new one. */
5642 lookup_face (f
, attr
)
5646 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5651 xassert (cache
!= NULL
);
5652 check_lface_attrs (attr
);
5654 /* Look up ATTR in the face cache. */
5655 hash
= lface_hash (attr
);
5656 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5658 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5660 if (face
->ascii_face
!= face
)
5662 /* There's no more ASCII face. */
5666 if (face
->hash
== hash
5667 && lface_equal_p (face
->lface
, attr
))
5671 /* If not found, realize a new face. */
5673 face
= realize_face (cache
, attr
, -1);
5676 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5677 #endif /* GLYPH_DEBUG */
5683 /* Look up a realized face that has the same attributes as BASE_FACE
5684 except for the font in the face cache of frame F. If FONT_ID is
5685 not negative, it is an ID number of an already opened font that is
5686 used by the face. If FONT_ID is negative, the face has no font.
5687 Value is the ID of the face found. If no suitable face is found,
5688 realize a new one. */
5691 lookup_non_ascii_face (f
, font_id
, base_face
)
5694 struct face
*base_face
;
5696 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5701 xassert (cache
!= NULL
);
5702 base_face
= base_face
->ascii_face
;
5703 hash
= lface_hash (base_face
->lface
);
5704 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5706 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5708 if (face
->ascii_face
== face
)
5710 if (face
->ascii_face
== base_face
5711 && face
->font_info_id
== font_id
)
5715 /* If not found, realize a new face. */
5717 face
= realize_non_ascii_face (f
, font_id
, base_face
);
5720 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5721 #endif /* GLYPH_DEBUG */
5726 /* Return the face id of the realized face for named face SYMBOL on
5727 frame F suitable for displaying ASCII characters. Value is -1 if
5728 the face couldn't be determined, which might happen if the default
5729 face isn't realized and cannot be realized. */
5732 lookup_named_face (f
, symbol
)
5736 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5737 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5738 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5740 if (default_face
== NULL
)
5742 if (!realize_basic_faces (f
))
5744 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5747 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5748 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5749 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5751 return lookup_face (f
, attrs
);
5755 /* Return the ID of the realized ASCII face of Lisp face with ID
5756 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5759 ascii_face_of_lisp_face (f
, lface_id
)
5765 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5767 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5768 face_id
= lookup_named_face (f
, face_name
);
5777 /* Return a face for charset ASCII that is like the face with id
5778 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5779 STEPS < 0 means larger. Value is the id of the face. */
5782 smaller_face (f
, face_id
, steps
)
5786 #ifdef HAVE_WINDOW_SYSTEM
5788 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5789 int pt
, last_pt
, last_height
;
5792 struct face
*new_face
;
5794 /* If not called for an X frame, just return the original face. */
5795 if (FRAME_TERMCAP_P (f
))
5798 /* Try in increments of 1/2 pt. */
5799 delta
= steps
< 0 ? 5 : -5;
5800 steps
= abs (steps
);
5802 face
= FACE_FROM_ID (f
, face_id
);
5803 bcopy (face
->lface
, attrs
, sizeof attrs
);
5804 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5805 new_face_id
= face_id
;
5806 last_height
= FONT_HEIGHT (face
->font
);
5810 /* Give up if we cannot find a font within 10pt. */
5811 && abs (last_pt
- pt
) < 100)
5813 /* Look up a face for a slightly smaller/larger font. */
5815 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5816 new_face_id
= lookup_face (f
, attrs
);
5817 new_face
= FACE_FROM_ID (f
, new_face_id
);
5819 /* If height changes, count that as one step. */
5820 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5821 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5824 last_height
= FONT_HEIGHT (new_face
->font
);
5831 #else /* not HAVE_WINDOW_SYSTEM */
5835 #endif /* not HAVE_WINDOW_SYSTEM */
5839 /* Return a face for charset ASCII that is like the face with id
5840 FACE_ID on frame F, but has height HEIGHT. */
5843 face_with_height (f
, face_id
, height
)
5848 #ifdef HAVE_WINDOW_SYSTEM
5850 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5852 if (FRAME_TERMCAP_P (f
)
5856 face
= FACE_FROM_ID (f
, face_id
);
5857 bcopy (face
->lface
, attrs
, sizeof attrs
);
5858 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5859 face_id
= lookup_face (f
, attrs
);
5860 #endif /* HAVE_WINDOW_SYSTEM */
5866 /* Return the face id of the realized face for named face SYMBOL on
5867 frame F suitable for displaying ASCII characters, and use
5868 attributes of the face FACE_ID for attributes that aren't
5869 completely specified by SYMBOL. This is like lookup_named_face,
5870 except that the default attributes come from FACE_ID, not from the
5871 default face. FACE_ID is assumed to be already realized. */
5874 lookup_derived_face (f
, symbol
, face_id
)
5879 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5880 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5881 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5886 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5887 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5888 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5889 return lookup_face (f
, attrs
);
5892 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5893 Sface_attributes_as_vector
, 1, 1, 0,
5894 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5899 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5901 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5908 /***********************************************************************
5909 Face capability testing
5910 ***********************************************************************/
5913 /* If the distance (as returned by color_distance) between two colors is
5914 less than this, then they are considered the same, for determining
5915 whether a color is supported or not. The range of values is 0-65535. */
5917 #define TTY_SAME_COLOR_THRESHOLD 10000
5919 #ifdef HAVE_WINDOW_SYSTEM
5921 /* Return non-zero if all the face attributes in ATTRS are supported
5922 on the window-system frame F.
5924 The definition of `supported' is somewhat heuristic, but basically means
5925 that a face containing all the attributes in ATTRS, when merged with the
5926 default face for display, can be represented in a way that's
5928 \(1) different in appearance than the default face, and
5929 \(2) `close in spirit' to what the attributes specify, if not exact. */
5932 x_supports_face_attributes_p (f
, attrs
, def_face
)
5935 struct face
*def_face
;
5937 Lisp_Object
*def_attrs
= def_face
->lface
;
5939 /* Check that other specified attributes are different that the default
5941 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5942 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5943 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5944 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5945 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5946 def_attrs
[LFACE_INVERSE_INDEX
]))
5947 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5948 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5949 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5950 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5951 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5952 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5953 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5954 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5955 def_attrs
[LFACE_STIPPLE_INDEX
]))
5956 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5957 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5958 def_attrs
[LFACE_OVERLINE_INDEX
]))
5959 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5960 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5961 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5962 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5963 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5964 def_attrs
[LFACE_BOX_INDEX
])))
5967 /* Check font-related attributes, as those are the most commonly
5968 "unsupported" on a window-system (because of missing fonts). */
5969 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5970 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5971 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5972 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5973 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5974 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5978 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5980 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5982 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5984 face_id
= lookup_face (f
, merged_attrs
);
5985 face
= FACE_FROM_ID (f
, face_id
);
5988 signal_error ("cannot make face", 0);
5990 /* If the font is the same, then not supported. */
5991 if (face
->font
== def_face
->font
)
5995 /* Everything checks out, this face is supported. */
5999 #endif /* HAVE_WINDOW_SYSTEM */
6001 /* Return non-zero if all the face attributes in ATTRS are supported
6004 The definition of `supported' is somewhat heuristic, but basically means
6005 that a face containing all the attributes in ATTRS, when merged
6006 with the default face for display, can be represented in a way that's
6008 \(1) different in appearance than the default face, and
6009 \(2) `close in spirit' to what the attributes specify, if not exact.
6011 Point (2) implies that a `:weight black' attribute will be satisfied
6012 by any terminal that can display bold, and a `:foreground "yellow"' as
6013 long as the terminal can display a yellowish color, but `:slant italic'
6014 will _not_ be satisfied by the tty display code's automatic
6015 substitution of a `dim' face for italic. */
6018 tty_supports_face_attributes_p (f
, attrs
, def_face
)
6021 struct face
*def_face
;
6024 Lisp_Object val
, fg
, bg
;
6025 XColor fg_tty_color
, fg_std_color
;
6026 XColor bg_tty_color
, bg_std_color
;
6027 unsigned test_caps
= 0;
6028 Lisp_Object
*def_attrs
= def_face
->lface
;
6031 /* First check some easy-to-check stuff; ttys support none of the
6032 following attributes, so we can just return false if any are requested
6033 (even if `nominal' values are specified, we should still return false,
6034 as that will be the same value that the default face uses). We
6035 consider :slant unsupportable on ttys, even though the face code
6036 actually `fakes' them using a dim attribute if possible. This is
6037 because the faked result is too different from what the face
6039 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6040 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6041 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6042 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6043 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6044 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6045 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6046 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
6050 /* Test for terminal `capabilities' (non-color character attributes). */
6052 /* font weight (bold/dim) */
6053 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6056 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6058 if (weight
> XLFD_WEIGHT_MEDIUM
)
6060 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6061 return 0; /* same as default */
6062 test_caps
= TTY_CAP_BOLD
;
6064 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6066 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6067 return 0; /* same as default */
6068 test_caps
= TTY_CAP_DIM
;
6070 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6071 return 0; /* same as default */
6075 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6076 if (!UNSPECIFIEDP (val
))
6079 return 0; /* ttys can't use colored underlines */
6080 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6081 return 0; /* same as default */
6083 test_caps
|= TTY_CAP_UNDERLINE
;
6087 val
= attrs
[LFACE_INVERSE_INDEX
];
6088 if (!UNSPECIFIEDP (val
))
6090 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6091 return 0; /* same as default */
6093 test_caps
|= TTY_CAP_INVERSE
;
6097 /* Color testing. */
6099 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6100 we use them when calling `tty_capable_p' below, even if the face
6101 specifies no colors. */
6102 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6103 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6105 /* Check if foreground color is close enough. */
6106 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6109 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6111 if (face_attr_equal_p (fg
, def_fg
))
6112 return 0; /* same as default */
6113 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6114 return 0; /* not a valid color */
6115 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6116 > TTY_SAME_COLOR_THRESHOLD
)
6117 return 0; /* displayed color is too different */
6119 /* Make sure the color is really different than the default. */
6121 XColor def_fg_color
;
6122 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6123 && (color_distance (&fg_tty_color
, &def_fg_color
)
6124 <= TTY_SAME_COLOR_THRESHOLD
))
6129 /* Check if background color is close enough. */
6130 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6133 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6135 if (face_attr_equal_p (bg
, def_bg
))
6136 return 0; /* same as default */
6137 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6138 return 0; /* not a valid color */
6139 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6140 > TTY_SAME_COLOR_THRESHOLD
)
6141 return 0; /* displayed color is too different */
6143 /* Make sure the color is really different than the default. */
6145 XColor def_bg_color
;
6146 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6147 && (color_distance (&bg_tty_color
, &def_bg_color
)
6148 <= TTY_SAME_COLOR_THRESHOLD
))
6153 /* If both foreground and background are requested, see if the
6154 distance between them is OK. We just check to see if the distance
6155 between the tty's foreground and background is close enough to the
6156 distance between the standard foreground and background. */
6157 if (STRINGP (fg
) && STRINGP (bg
))
6160 = (color_distance (&fg_std_color
, &bg_std_color
)
6161 - color_distance (&fg_tty_color
, &bg_tty_color
));
6162 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6163 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6168 /* See if the capabilities we selected above are supported, with the
6170 if (test_caps
!= 0 &&
6171 ! tty_capable_p (f
, test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6175 /* Hmmm, everything checks out, this terminal must support this face. */
6180 DEFUN ("display-supports-face-attributes-p",
6181 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6183 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6184 The optional argument DISPLAY can be a display name, a frame, or
6185 nil (meaning the selected frame's display)
6187 The definition of `supported' is somewhat heuristic, but basically means
6188 that a face containing all the attributes in ATTRIBUTES, when merged
6189 with the default face for display, can be represented in a way that's
6191 \(1) different in appearance than the default face, and
6192 \(2) `close in spirit' to what the attributes specify, if not exact.
6194 Point (2) implies that a `:weight black' attribute will be satisfied by
6195 any display that can display bold, and a `:foreground \"yellow\"' as long
6196 as it can display a yellowish color, but `:slant italic' will _not_ be
6197 satisfied by the tty display code's automatic substitution of a `dim'
6198 face for italic. */)
6199 (attributes
, display
)
6200 Lisp_Object attributes
, display
;
6205 struct face
*def_face
;
6206 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6208 if (noninteractive
|| !initialized
)
6209 /* We may not be able to access low-level face information in batch
6210 mode, or before being dumped, and this function is not going to
6211 be very useful in those cases anyway, so just give up. */
6215 frame
= selected_frame
;
6216 else if (FRAMEP (display
))
6220 /* Find any frame on DISPLAY. */
6221 Lisp_Object fl_tail
;
6224 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6226 frame
= XCAR (fl_tail
);
6227 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6228 XFRAME (frame
)->param_alist
)),
6234 CHECK_LIVE_FRAME (frame
);
6237 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6238 attrs
[i
] = Qunspecified
;
6239 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6241 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6242 if (def_face
== NULL
)
6244 if (! realize_basic_faces (f
))
6245 signal_error ("Cannot realize default face", 0);
6246 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6249 /* Dispatch to the appropriate handler. */
6250 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6251 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6252 #ifdef HAVE_WINDOW_SYSTEM
6254 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6257 return supports
? Qt
: Qnil
;
6261 /***********************************************************************
6263 ***********************************************************************/
6265 DEFUN ("internal-set-font-selection-order",
6266 Finternal_set_font_selection_order
,
6267 Sinternal_set_font_selection_order
, 1, 1, 0,
6268 doc
: /* Set font selection order for face font selection to ORDER.
6269 ORDER must be a list of length 4 containing the symbols `:width',
6270 `:height', `:weight', and `:slant'. Face attributes appearing
6271 first in ORDER are matched first, e.g. if `:height' appears before
6272 `:weight' in ORDER, font selection first tries to find a font with
6273 a suitable height, and then tries to match the font weight.
6280 int indices
[DIM (font_sort_order
)];
6283 bzero (indices
, sizeof indices
);
6287 CONSP (list
) && i
< DIM (indices
);
6288 list
= XCDR (list
), ++i
)
6290 Lisp_Object attr
= XCAR (list
);
6293 if (EQ (attr
, QCwidth
))
6295 else if (EQ (attr
, QCheight
))
6296 xlfd
= XLFD_POINT_SIZE
;
6297 else if (EQ (attr
, QCweight
))
6299 else if (EQ (attr
, QCslant
))
6304 if (indices
[i
] != 0)
6309 if (!NILP (list
) || i
!= DIM (indices
))
6310 signal_error ("Invalid font sort order", order
);
6311 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6312 if (indices
[i
] == 0)
6313 signal_error ("Invalid font sort order", order
);
6315 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6317 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6318 free_all_realized_faces (Qnil
);
6325 DEFUN ("internal-set-alternative-font-family-alist",
6326 Finternal_set_alternative_font_family_alist
,
6327 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6328 doc
: /* Define alternative font families to try in face font selection.
6329 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6330 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6331 be found. Value is ALIST. */)
6336 Vface_alternative_font_family_alist
= alist
;
6337 free_all_realized_faces (Qnil
);
6342 DEFUN ("internal-set-alternative-font-registry-alist",
6343 Finternal_set_alternative_font_registry_alist
,
6344 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6345 doc
: /* Define alternative font registries to try in face font selection.
6346 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6347 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6348 be found. Value is ALIST. */)
6353 Vface_alternative_font_registry_alist
= alist
;
6354 free_all_realized_faces (Qnil
);
6359 #ifdef HAVE_WINDOW_SYSTEM
6361 /* Value is non-zero if FONT is the name of a scalable font. The
6362 X11R6 XLFD spec says that point size, pixel size, and average width
6363 are zero for scalable fonts. Intlfonts contain at least one
6364 scalable font ("*-muleindian-1") for which this isn't true, so we
6365 just test average width. */
6368 font_scalable_p (font
)
6369 struct font_name
*font
;
6371 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6372 return (*s
== '0' && *(s
+ 1) == '\0')
6374 /* Windows implementation of XLFD is slightly broken for backward
6375 compatibility with previous broken versions, so test for
6376 wildcards as well as 0. */
6383 /* Ignore the difference of font point size less than this value. */
6385 #define FONT_POINT_SIZE_QUANTUM 5
6387 /* Value is non-zero if FONT1 is a better match for font attributes
6388 VALUES than FONT2. VALUES is an array of face attribute values in
6389 font sort order. COMPARE_PT_P zero means don't compare point
6390 sizes. AVGWIDTH, if not zero, is a specified font average width
6394 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6396 struct font_name
*font1
, *font2
;
6397 int compare_pt_p
, avgwidth
;
6401 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6403 int xlfd_idx
= font_sort_order
[i
];
6405 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6409 if (xlfd_idx
== XLFD_POINT_SIZE
)
6411 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6412 / font1
->rescale_ratio
));
6413 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6414 / font2
->rescale_ratio
));
6415 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6420 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6421 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6424 if (delta1
> delta2
)
6426 else if (delta1
< delta2
)
6430 /* The difference may be equal because, e.g., the face
6431 specifies `italic' but we have only `regular' and
6432 `oblique'. Prefer `oblique' in this case. */
6433 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6434 && font1
->numeric
[xlfd_idx
] > values
[i
]
6435 && font2
->numeric
[xlfd_idx
] < values
[i
])
6443 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6444 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6445 if (delta1
> delta2
)
6447 else if (delta1
< delta2
)
6453 /* We prefer a real scalable font; i.e. not what autoscaled. */
6454 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6455 && font1
->numeric
[XLFD_RESY
] > 0);
6456 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6457 && font2
->numeric
[XLFD_RESY
] > 0);
6459 if (auto_scaled_1
!= auto_scaled_2
)
6460 return auto_scaled_2
;
6463 return font1
->registry_priority
< font2
->registry_priority
;
6467 /* Value is non-zero if FONT is an exact match for face attributes in
6468 SPECIFIED. SPECIFIED is an array of face attribute values in font
6469 sort order. AVGWIDTH, if non-zero, is an average width to compare
6473 exact_face_match_p (specified
, font
, avgwidth
)
6475 struct font_name
*font
;
6480 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6481 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6484 return (i
== DIM (font_sort_order
)
6486 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6490 /* Value is the name of a scaled font, generated from scalable font
6491 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6492 Value is allocated from heap. */
6495 build_scalable_font_name (f
, font
, specified_pt
)
6497 struct font_name
*font
;
6500 char pixel_size
[20];
6502 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6505 if (font
->numeric
[XLFD_PIXEL_SIZE
] != 0
6506 || font
->numeric
[XLFD_POINT_SIZE
] != 0)
6507 /* This is a scalable font but is requested for a specific size.
6508 We should not change that size. */
6509 return build_font_name (font
);
6511 /* If scalable font is for a specific resolution, compute
6512 the point size we must specify from the resolution of
6513 the display and the specified resolution of the font. */
6514 if (font
->numeric
[XLFD_RESY
] != 0)
6516 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6517 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
;
6522 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
;
6524 /* We may need a font of the different size. */
6525 pixel_value
*= font
->rescale_ratio
;
6527 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6528 font of the specified PIXEL_SIZE. */
6530 { /* Set point size of the font. */
6531 char point_size
[20];
6532 sprintf (point_size
, "%d", (int) pt
);
6533 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6534 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6538 /* Set pixel size. */
6539 sprintf (pixel_size
, "%d", pixel_value
);
6540 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6541 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6543 /* If font doesn't specify its resolution, use the
6544 resolution of the display. */
6545 if (font
->numeric
[XLFD_RESY
] == 0)
6548 sprintf (buffer
, "%d", (int) resy
);
6549 font
->fields
[XLFD_RESY
] = buffer
;
6550 font
->numeric
[XLFD_RESY
] = resy
;
6553 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6556 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6557 sprintf (buffer
, "%d", resx
);
6558 font
->fields
[XLFD_RESX
] = buffer
;
6559 font
->numeric
[XLFD_RESX
] = resx
;
6562 return build_font_name (font
);
6566 /* Value is non-zero if we are allowed to use scalable font FONT. We
6567 can't run a Lisp function here since this function may be called
6568 with input blocked. */
6571 may_use_scalable_font_p (font
)
6574 if (EQ (Vscalable_fonts_allowed
, Qt
))
6576 else if (CONSP (Vscalable_fonts_allowed
))
6578 Lisp_Object tail
, regexp
;
6580 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6582 regexp
= XCAR (tail
);
6583 if (STRINGP (regexp
)
6584 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6594 /* Return the name of the best matching font for face attributes ATTRS
6595 in the array of font_name structures FONTS which contains NFONTS
6596 elements. WIDTH_RATIO is a factor with which to multiply average
6597 widths if ATTRS specifies such a width.
6599 Value is a font name which is allocated from the heap. FONTS is
6600 freed by this function.
6602 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6603 indicate whether the resulting font should be drawn using overstrike
6604 to simulate bold-face. */
6607 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6610 struct font_name
*fonts
;
6613 int *needs_overstrike
;
6616 struct font_name
*best
;
6619 int exact_p
, avgwidth
;
6624 /* Make specified font attributes available in `specified',
6625 indexed by sort order. */
6626 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6628 int xlfd_idx
= font_sort_order
[i
];
6630 if (xlfd_idx
== XLFD_SWIDTH
)
6631 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6632 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6633 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6634 else if (xlfd_idx
== XLFD_WEIGHT
)
6635 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6636 else if (xlfd_idx
== XLFD_SLANT
)
6637 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6642 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6644 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6648 if (needs_overstrike
)
6649 *needs_overstrike
= 0;
6651 /* Start with the first non-scalable font in the list. */
6652 for (i
= 0; i
< nfonts
; ++i
)
6653 if (!font_scalable_p (fonts
+ i
))
6656 /* Find the best match among the non-scalable fonts. */
6661 for (i
= 1; i
< nfonts
; ++i
)
6662 if (!font_scalable_p (fonts
+ i
)
6663 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6667 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6675 /* Unless we found an exact match among non-scalable fonts, see if
6676 we can find a better match among scalable fonts. */
6679 /* A scalable font is better if
6681 1. its weight, slant, swidth attributes are better, or.
6683 2. the best non-scalable font doesn't have the required
6684 point size, and the scalable fonts weight, slant, swidth
6687 int non_scalable_has_exact_height_p
;
6689 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6690 non_scalable_has_exact_height_p
= 1;
6692 non_scalable_has_exact_height_p
= 0;
6694 for (i
= 0; i
< nfonts
; ++i
)
6695 if (font_scalable_p (fonts
+ i
))
6698 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6699 || (!non_scalable_has_exact_height_p
6700 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6702 non_scalable_has_exact_height_p
= 1;
6707 if (needs_overstrike
)
6709 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6710 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6712 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6714 /* We want a bold font, but didn't get one; try to use
6715 overstriking instead to simulate bold-face. However,
6716 don't overstrike an already-bold fontn unless the
6717 desired weight grossly exceeds the available weight. */
6718 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6719 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6721 *needs_overstrike
= 1;
6726 if (font_scalable_p (best
))
6727 font_name
= build_scalable_font_name (f
, best
, pt
);
6729 font_name
= build_font_name (best
);
6731 /* Free font_name structures. */
6732 free_font_names (fonts
, nfonts
);
6738 /* Get a list of matching fonts on frame F, considering FAMILY
6739 and alternative font families from Vface_alternative_font_registry_alist.
6741 FAMILY is the font family whose alternatives are considered.
6743 REGISTRY, if a string, specifies a font registry and encoding to
6744 match. A value of nil means include fonts of any registry and
6747 Return in *FONTS a pointer to a vector of font_name structures for
6748 the fonts matched. Value is the number of fonts found. */
6751 try_alternative_families (f
, family
, registry
, fonts
)
6753 Lisp_Object family
, registry
;
6754 struct font_name
**fonts
;
6759 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6762 /* Try alternative font families. */
6763 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6766 for (alter
= XCDR (alter
);
6767 CONSP (alter
) && nfonts
== 0;
6768 alter
= XCDR (alter
))
6770 if (STRINGP (XCAR (alter
)))
6771 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6775 /* Try all scalable fonts before giving up. */
6776 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6778 int count
= SPECPDL_INDEX ();
6779 specbind (Qscalable_fonts_allowed
, Qt
);
6780 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6781 unbind_to (count
, Qnil
);
6788 /* Get a list of matching fonts on frame F.
6790 PATTERN, if a string, specifies a font name pattern to match while
6791 ignoring FAMILY and REGISTRY.
6793 FAMILY, if a list, specifies a list of font families to try.
6795 REGISTRY, if a list, specifies a list of font registries and
6798 Return in *FONTS a pointer to a vector of font_name structures for
6799 the fonts matched. Value is the number of fonts found. */
6802 try_font_list (f
, pattern
, family
, registry
, fonts
)
6804 Lisp_Object pattern
, family
, registry
;
6805 struct font_name
**fonts
;
6809 if (STRINGP (pattern
))
6811 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
6812 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6814 int count
= SPECPDL_INDEX ();
6815 specbind (Qscalable_fonts_allowed
, Qt
);
6816 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
6817 unbind_to (count
, Qnil
);
6825 nfonts
= font_list (f
, Qnil
, Qnil
, registry
, fonts
);
6827 for (tail
= family
; ! nfonts
&& CONSP (tail
); tail
= XCDR (tail
))
6828 nfonts
= try_alternative_families (f
, XCAR (tail
), registry
, fonts
);
6830 /* Try font family of the default face or "fixed". */
6831 if (nfonts
== 0 && !NILP (family
))
6833 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6835 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6837 family
= build_string ("fixed");
6838 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6841 /* Try any family with the given registry. */
6842 if (nfonts
== 0 && !NILP (family
))
6843 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6850 /* Return the fontset id of the base fontset name or alias name given
6851 by the fontset attribute of ATTRS. Value is -1 if the fontset
6852 attribute of ATTRS doesn't name a fontset. */
6855 face_fontset (attrs
)
6860 name
= attrs
[LFACE_FONTSET_INDEX
];
6861 if (!STRINGP (name
))
6863 return fs_query_fontset (name
, 0);
6867 /* Choose a name of font to use on frame F to display characters with
6868 Lisp face attributes specified by ATTRS. The font name is
6869 determined by the font-related attributes in ATTRS and FONT-SPEC
6872 When we are choosing a font for ASCII characters, FONT-SPEC is
6873 always nil. Otherwise FONT-SPEC is a list
6874 [ FAMILY WEIGHT SLANT SWIDTH ADSTYLE REGISTRY ]
6875 or a string specifying a font name pattern.
6877 If NEEDS_OVERSTRIKE is not NULL, a boolean is returned in it to
6878 indicate whether the resulting font should be drawn using
6879 overstrike to simulate bold-face.
6881 Value is the font name which is allocated from the heap and must be
6882 freed by the caller. */
6885 choose_face_font (f
, attrs
, font_spec
, needs_overstrike
)
6888 Lisp_Object font_spec
;
6889 int *needs_overstrike
;
6891 Lisp_Object pattern
, family
, adstyle
, registry
;
6892 char *font_name
= NULL
;
6893 struct font_name
*fonts
;
6896 if (needs_overstrike
)
6897 *needs_overstrike
= 0;
6899 /* If we are choosing an ASCII font and a font name is explicitly
6900 specified in ATTRS, return it. */
6901 if (NILP (font_spec
) && STRINGP (attrs
[LFACE_FONT_INDEX
]))
6902 return xstrdup (SDATA (attrs
[LFACE_FONT_INDEX
]));
6904 if (NILP (attrs
[LFACE_FAMILY_INDEX
]))
6907 family
= Fcons (attrs
[LFACE_FAMILY_INDEX
], Qnil
);
6909 /* Decide FAMILY, ADSTYLE, and REGISTRY from FONT_SPEC. But,
6910 ADSTYLE is not used in the font selector for the moment. */
6911 if (VECTORP (font_spec
))
6914 if (STRINGP (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
)))
6915 family
= Fcons (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
), family
);
6916 adstyle
= AREF (font_spec
, FONT_SPEC_ADSTYLE_INDEX
);
6917 registry
= Fcons (AREF (font_spec
, FONT_SPEC_REGISTRY_INDEX
), Qnil
);
6919 else if (STRINGP (font_spec
))
6921 pattern
= font_spec
;
6928 /* We are choosing an ASCII font. By default, use the registry
6929 name "iso8859-1". But, if the registry name of the ASCII
6930 font specified in the fontset of ATTRS is not "iso8859-1"
6931 (e.g "iso10646-1"), use also that name with higher
6933 int fontset
= face_fontset (attrs
);
6936 struct font_name font
;
6940 registry
= Fcons (build_string ("iso8859-1"), Qnil
);
6942 ascii
= fontset_ascii (fontset
);
6943 len
= SBYTES (ascii
);
6945 || strcmp (SDATA (ascii
) + len
- 9, "iso8859-1"))
6947 font
.name
= LSTRDUPA (ascii
);
6948 /* Check if the name is in XLFD. */
6949 if (split_font_name (f
, &font
, 0))
6951 font
.fields
[XLFD_ENCODING
][-1] = '-';
6952 registry
= Fcons (build_string (font
.fields
[XLFD_REGISTRY
]),
6958 /* Get a list of fonts matching that pattern and choose the
6959 best match for the specified face attributes from it. */
6960 nfonts
= try_font_list (f
, pattern
, family
, registry
, &fonts
);
6961 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, NILP (font_spec
),
6966 #endif /* HAVE_WINDOW_SYSTEM */
6970 /***********************************************************************
6972 ***********************************************************************/
6974 /* Realize basic faces on frame F. Value is zero if frame parameters
6975 of F don't contain enough information needed to realize the default
6979 realize_basic_faces (f
)
6983 int count
= SPECPDL_INDEX ();
6985 /* Block input here so that we won't be surprised by an X expose
6986 event, for instance, without having the faces set up. */
6988 specbind (Qscalable_fonts_allowed
, Qt
);
6990 if (realize_default_face (f
))
6992 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6993 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6994 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6995 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6996 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6997 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6998 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6999 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
7000 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
7001 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
7003 /* Reflect changes in the `menu' face in menu bars. */
7004 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
7006 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
7007 #ifdef USE_X_TOOLKIT
7008 x_update_menu_appearance (f
);
7015 unbind_to (count
, Qnil
);
7021 /* Realize the default face on frame F. If the face is not fully
7022 specified, make it fully-specified. Attributes of the default face
7023 that are not explicitly specified are taken from frame parameters. */
7026 realize_default_face (f
)
7029 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7031 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7032 Lisp_Object frame_font
;
7035 /* If the `default' face is not yet known, create it. */
7036 lface
= lface_from_face_name (f
, Qdefault
, 0);
7040 XSETFRAME (frame
, f
);
7041 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
7045 #ifdef HAVE_WINDOW_SYSTEM
7046 if (FRAME_WINDOW_P (f
))
7048 /* Set frame_font to the value of the `font' frame parameter. */
7049 frame_font
= Fassq (Qfont
, f
->param_alist
);
7050 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
7051 frame_font
= XCDR (frame_font
);
7052 set_lface_from_font_name (f
, lface
, frame_font
,
7053 f
->default_face_done_p
, 1);
7054 f
->default_face_done_p
= 1;
7056 #endif /* HAVE_WINDOW_SYSTEM */
7058 if (!FRAME_WINDOW_P (f
))
7060 LFACE_FAMILY (lface
) = build_string ("default");
7061 LFACE_SWIDTH (lface
) = Qnormal
;
7062 LFACE_HEIGHT (lface
) = make_number (1);
7063 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
7064 LFACE_WEIGHT (lface
) = Qnormal
;
7065 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
7066 LFACE_SLANT (lface
) = Qnormal
;
7067 LFACE_AVGWIDTH (lface
) = Qunspecified
;
7070 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
7071 LFACE_UNDERLINE (lface
) = Qnil
;
7073 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
7074 LFACE_OVERLINE (lface
) = Qnil
;
7076 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
7077 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
7079 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
7080 LFACE_BOX (lface
) = Qnil
;
7082 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
7083 LFACE_INVERSE (lface
) = Qnil
;
7085 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
7087 /* This function is called so early that colors are not yet
7088 set in the frame parameter list. */
7089 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7091 if (CONSP (color
) && STRINGP (XCDR (color
)))
7092 LFACE_FOREGROUND (lface
) = XCDR (color
);
7093 else if (FRAME_WINDOW_P (f
))
7095 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7096 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7101 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7103 /* This function is called so early that colors are not yet
7104 set in the frame parameter list. */
7105 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7106 if (CONSP (color
) && STRINGP (XCDR (color
)))
7107 LFACE_BACKGROUND (lface
) = XCDR (color
);
7108 else if (FRAME_WINDOW_P (f
))
7110 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7111 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7116 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7117 LFACE_STIPPLE (lface
) = Qnil
;
7119 /* Realize the face; it must be fully-specified now. */
7120 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7121 check_lface (lface
);
7122 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7123 face
= realize_face (c
, attrs
, DEFAULT_FACE_ID
);
7128 /* Realize basic faces other than the default face in face cache C.
7129 SYMBOL is the face name, ID is the face id the realized face must
7130 have. The default face must have been realized already. */
7133 realize_named_face (f
, symbol
, id
)
7138 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7139 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7140 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7141 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7142 struct face
*new_face
;
7144 /* The default face must exist and be fully specified. */
7145 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7146 check_lface_attrs (attrs
);
7147 xassert (lface_fully_specified_p (attrs
));
7149 /* If SYMBOL isn't know as a face, create it. */
7153 XSETFRAME (frame
, f
);
7154 lface
= Finternal_make_lisp_face (symbol
, frame
);
7157 /* Merge SYMBOL's face with the default face. */
7158 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7159 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7161 /* Realize the face. */
7162 new_face
= realize_face (c
, attrs
, id
);
7166 /* Realize the fully-specified face with attributes ATTRS in face
7167 cache CACHE for ASCII characters. If FORMER_FACE_ID is
7168 non-negative, it is an ID of face to remove before caching the new
7169 face. Value is a pointer to the newly created realized face. */
7171 static struct face
*
7172 realize_face (cache
, attrs
, former_face_id
)
7173 struct face_cache
*cache
;
7179 /* LFACE must be fully specified. */
7180 xassert (cache
!= NULL
);
7181 check_lface_attrs (attrs
);
7183 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7185 /* Remove the former face. */
7186 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7187 uncache_face (cache
, former_face
);
7188 free_realized_face (cache
->f
, former_face
);
7191 if (FRAME_WINDOW_P (cache
->f
))
7192 face
= realize_x_face (cache
, attrs
);
7193 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7194 face
= realize_tty_face (cache
, attrs
);
7198 /* Insert the new face. */
7199 cache_face (cache
, face
, lface_hash (attrs
));
7204 /* Realize the fully-specified face that has the same attributes as
7205 BASE_FACE except for the font on frame F. If FONT_ID is not
7206 negative, it is an ID number of an already opened font that should
7207 be used by the face. If FONT_ID is negative, the face has no font,
7208 i.e., characters are displayed by empty boxes. */
7210 static struct face
*
7211 realize_non_ascii_face (f
, font_id
, base_face
)
7214 struct face
*base_face
;
7216 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
7218 struct font_info
*font_info
;
7220 face
= (struct face
*) xmalloc (sizeof *face
);
7224 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7225 face
->colors_copied_bitwise_p
= 1;
7227 face
->font_info_id
= font_id
;
7230 font_info
= FONT_INFO_FROM_ID (f
, font_id
);
7231 face
->font
= font_info
->font
;
7232 face
->font_name
= font_info
->full_name
;
7237 face
->font_name
= NULL
;
7242 cache_face (cache
, face
, face
->hash
);
7248 /* Realize the fully-specified face with attributes ATTRS in face
7249 cache CACHE for ASCII characters. Do it for X frame CACHE->f. If
7250 the new face doesn't share font with the default face, a fontname
7251 is allocated from the heap and set in `font_name' of the new face,
7252 but it is not yet loaded here. Value is a pointer to the newly
7253 created realized face. */
7255 static struct face
*
7256 realize_x_face (cache
, attrs
)
7257 struct face_cache
*cache
;
7260 #ifdef HAVE_WINDOW_SYSTEM
7261 struct face
*face
, *default_face
;
7263 Lisp_Object stipple
, overline
, strike_through
, box
;
7265 xassert (FRAME_WINDOW_P (cache
->f
));
7267 /* Allocate a new realized face. */
7268 face
= make_realized_face (attrs
);
7269 face
->ascii_face
= face
;
7273 /* Determine the font to use. Most of the time, the font will be
7274 the same as the font of the default face, so try that first. */
7275 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7277 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7279 face
->font
= default_face
->font
;
7280 face
->font_info_id
= default_face
->font_info_id
;
7281 face
->font_name
= default_face
->font_name
;
7283 = make_fontset_for_ascii_face (f
, default_face
->fontset
, face
);
7287 /* If the face attribute ATTRS specifies a fontset, use it as
7288 the base of a new realized fontset. Otherwise, use the same
7289 base fontset as of the default face. The base determines
7290 registry and encoding of a font. It may also determine
7291 foundry and family. The other fields of font name pattern
7292 are constructed from ATTRS. */
7293 int fontset
= face_fontset (attrs
);
7295 /* If we are realizing the default face, ATTRS should specify a
7296 fontset. In other words, if FONTSET is -1, we are not
7297 realizing the default face, thus the default face should have
7298 already been realized. */
7300 fontset
= default_face
->fontset
;
7303 load_face_font (f
, face
);
7304 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
, face
);
7307 /* Load colors, and set remaining attributes. */
7309 load_face_colors (f
, face
, attrs
);
7312 box
= attrs
[LFACE_BOX_INDEX
];
7315 /* A simple box of line width 1 drawn in color given by
7317 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7319 face
->box
= FACE_SIMPLE_BOX
;
7320 face
->box_line_width
= 1;
7322 else if (INTEGERP (box
))
7324 /* Simple box of specified line width in foreground color of the
7326 xassert (XINT (box
) != 0);
7327 face
->box
= FACE_SIMPLE_BOX
;
7328 face
->box_line_width
= XINT (box
);
7329 face
->box_color
= face
->foreground
;
7330 face
->box_color_defaulted_p
= 1;
7332 else if (CONSP (box
))
7334 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7335 being one of `raised' or `sunken'. */
7336 face
->box
= FACE_SIMPLE_BOX
;
7337 face
->box_color
= face
->foreground
;
7338 face
->box_color_defaulted_p
= 1;
7339 face
->box_line_width
= 1;
7343 Lisp_Object keyword
, value
;
7345 keyword
= XCAR (box
);
7353 if (EQ (keyword
, QCline_width
))
7355 if (INTEGERP (value
) && XINT (value
) != 0)
7356 face
->box_line_width
= XINT (value
);
7358 else if (EQ (keyword
, QCcolor
))
7360 if (STRINGP (value
))
7362 face
->box_color
= load_color (f
, face
, value
,
7364 face
->use_box_color_for_shadows_p
= 1;
7367 else if (EQ (keyword
, QCstyle
))
7369 if (EQ (value
, Qreleased_button
))
7370 face
->box
= FACE_RAISED_BOX
;
7371 else if (EQ (value
, Qpressed_button
))
7372 face
->box
= FACE_SUNKEN_BOX
;
7377 /* Text underline, overline, strike-through. */
7379 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7381 /* Use default color (same as foreground color). */
7382 face
->underline_p
= 1;
7383 face
->underline_defaulted_p
= 1;
7384 face
->underline_color
= 0;
7386 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7388 /* Use specified color. */
7389 face
->underline_p
= 1;
7390 face
->underline_defaulted_p
= 0;
7391 face
->underline_color
7392 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7393 LFACE_UNDERLINE_INDEX
);
7395 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7397 face
->underline_p
= 0;
7398 face
->underline_defaulted_p
= 0;
7399 face
->underline_color
= 0;
7402 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7403 if (STRINGP (overline
))
7405 face
->overline_color
7406 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7407 LFACE_OVERLINE_INDEX
);
7408 face
->overline_p
= 1;
7410 else if (EQ (overline
, Qt
))
7412 face
->overline_color
= face
->foreground
;
7413 face
->overline_color_defaulted_p
= 1;
7414 face
->overline_p
= 1;
7417 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7418 if (STRINGP (strike_through
))
7420 face
->strike_through_color
7421 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7422 LFACE_STRIKE_THROUGH_INDEX
);
7423 face
->strike_through_p
= 1;
7425 else if (EQ (strike_through
, Qt
))
7427 face
->strike_through_color
= face
->foreground
;
7428 face
->strike_through_color_defaulted_p
= 1;
7429 face
->strike_through_p
= 1;
7432 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7433 if (!NILP (stipple
))
7434 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7437 #endif /* HAVE_WINDOW_SYSTEM */
7441 /* Map a specified color of face FACE on frame F to a tty color index.
7442 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7443 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7444 default foreground/background colors. */
7447 map_tty_color (f
, face
, idx
, defaulted
)
7450 enum lface_attribute_index idx
;
7453 Lisp_Object frame
, color
, def
;
7454 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7455 unsigned long default_pixel
, default_other_pixel
, pixel
;
7457 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7461 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7462 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7466 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7467 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7470 XSETFRAME (frame
, f
);
7471 color
= face
->lface
[idx
];
7475 && CONSP (Vtty_defined_color_alist
)
7476 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7479 /* Associations in tty-defined-color-alist are of the form
7480 (NAME INDEX R G B). We need the INDEX part. */
7481 pixel
= XINT (XCAR (XCDR (def
)));
7484 if (pixel
== default_pixel
&& STRINGP (color
))
7486 pixel
= load_color (f
, face
, color
, idx
);
7488 #if defined (MSDOS) || defined (WINDOWSNT)
7489 /* If the foreground of the default face is the default color,
7490 use the foreground color defined by the frame. */
7492 if (FRAME_MSDOS_P (f
))
7495 if (pixel
== default_pixel
7496 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7499 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7501 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7502 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7505 else if (pixel
== default_other_pixel
)
7508 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7510 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7511 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7517 #endif /* MSDOS or WINDOWSNT */
7521 face
->foreground
= pixel
;
7523 face
->background
= pixel
;
7527 /* Realize the fully-specified face with attributes ATTRS in face
7528 cache CACHE for ASCII characters. Do it for TTY frame CACHE->f.
7529 Value is a pointer to the newly created realized face. */
7531 static struct face
*
7532 realize_tty_face (cache
, attrs
)
7533 struct face_cache
*cache
;
7538 int face_colors_defaulted
= 0;
7539 struct frame
*f
= cache
->f
;
7541 /* Frame must be a termcap frame. */
7542 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7544 /* Allocate a new realized face. */
7545 face
= make_realized_face (attrs
);
7546 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7548 /* Map face attributes to TTY appearances. We map slant to
7549 dimmed text because we want italic text to appear differently
7550 and because dimmed text is probably used infrequently. */
7551 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7552 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7554 if (weight
> XLFD_WEIGHT_MEDIUM
)
7555 face
->tty_bold_p
= 1;
7556 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7557 face
->tty_dim_p
= 1;
7558 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7559 face
->tty_underline_p
= 1;
7560 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7561 face
->tty_reverse_p
= 1;
7563 /* Map color names to color indices. */
7564 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7565 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7567 /* Swap colors if face is inverse-video. If the colors are taken
7568 from the frame colors, they are already inverted, since the
7569 frame-creation function calls x-handle-reverse-video. */
7570 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7572 unsigned long tem
= face
->foreground
;
7573 face
->foreground
= face
->background
;
7574 face
->background
= tem
;
7577 if (tty_suppress_bold_inverse_default_colors_p
7579 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7580 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7581 face
->tty_bold_p
= 0;
7587 DEFUN ("tty-suppress-bold-inverse-default-colors",
7588 Ftty_suppress_bold_inverse_default_colors
,
7589 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7590 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7591 SUPPRESS non-nil means suppress it.
7592 This affects bold faces on TTYs whose foreground is the default background
7593 color of the display and whose background is the default foreground color.
7594 For such faces, the bold face attribute is ignored if this variable
7597 Lisp_Object suppress
;
7599 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7600 ++face_change_count
;
7606 /***********************************************************************
7608 ***********************************************************************/
7610 /* Return the ID of the face to use to display character CH with face
7611 property PROP on frame F in current_buffer. */
7614 compute_char_face (f
, ch
, prop
)
7621 if (NILP (current_buffer
->enable_multibyte_characters
))
7626 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7627 face_id
= FACE_FOR_CHAR (f
, face
, ch
, -1, Qnil
);
7631 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7632 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7633 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7634 merge_face_ref (f
, prop
, attrs
, 1, 0);
7635 face_id
= lookup_face (f
, attrs
);
7641 /* Return the face ID associated with buffer position POS for
7642 displaying ASCII characters. Return in *ENDPTR the position at
7643 which a different face is needed, as far as text properties and
7644 overlays are concerned. W is a window displaying current_buffer.
7646 REGION_BEG, REGION_END delimit the region, so it can be
7649 LIMIT is a position not to scan beyond. That is to limit the time
7650 this function can take.
7652 If MOUSE is non-zero, use the character's mouse-face, not its face.
7654 The face returned is suitable for displaying ASCII characters. */
7657 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7658 endptr
, limit
, mouse
)
7661 int region_beg
, region_end
;
7666 struct frame
*f
= XFRAME (w
->frame
);
7667 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7668 Lisp_Object prop
, position
;
7670 Lisp_Object
*overlay_vec
;
7673 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7674 Lisp_Object limit1
, end
;
7675 struct face
*default_face
;
7677 /* W must display the current buffer. We could write this function
7678 to use the frame and buffer of W, but right now it doesn't. */
7679 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7681 XSETFRAME (frame
, f
);
7682 XSETFASTINT (position
, pos
);
7685 if (pos
< region_beg
&& region_beg
< endpos
)
7686 endpos
= region_beg
;
7688 /* Get the `face' or `mouse_face' text property at POS, and
7689 determine the next position at which the property changes. */
7690 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7691 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7692 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7694 endpos
= XINT (end
);
7696 /* Look at properties from overlays. */
7700 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7701 if (next_overlay
< endpos
)
7702 endpos
= next_overlay
;
7707 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7709 /* Optimize common cases where we can use the default face. */
7712 && !(pos
>= region_beg
&& pos
< region_end
))
7713 return DEFAULT_FACE_ID
;
7715 /* Begin with attributes from the default face. */
7716 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7718 /* Merge in attributes specified via text properties. */
7720 merge_face_ref (f
, prop
, attrs
, 1, 0);
7722 /* Now merge the overlay data. */
7723 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7724 for (i
= 0; i
< noverlays
; i
++)
7729 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7731 merge_face_ref (f
, prop
, attrs
, 1, 0);
7733 oend
= OVERLAY_END (overlay_vec
[i
]);
7734 oendpos
= OVERLAY_POSITION (oend
);
7735 if (oendpos
< endpos
)
7739 /* If in the region, merge in the region face. */
7740 if (pos
>= region_beg
&& pos
< region_end
)
7742 merge_named_face (f
, Qregion
, attrs
, 0);
7744 if (region_end
< endpos
)
7745 endpos
= region_end
;
7750 /* Look up a realized face with the given face attributes,
7751 or realize a new one for ASCII characters. */
7752 return lookup_face (f
, attrs
);
7756 /* Compute the face at character position POS in Lisp string STRING on
7757 window W, for ASCII characters.
7759 If STRING is an overlay string, it comes from position BUFPOS in
7760 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7761 not an overlay string. W must display the current buffer.
7762 REGION_BEG and REGION_END give the start and end positions of the
7763 region; both are -1 if no region is visible.
7765 BASE_FACE_ID is the id of a face to merge with. For strings coming
7766 from overlays or the `display' property it is the face at BUFPOS.
7768 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7770 Set *ENDPTR to the next position where to check for faces in
7771 STRING; -1 if the face is constant from POS to the end of the
7774 Value is the id of the face to use. The face returned is suitable
7775 for displaying ASCII characters. */
7778 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7779 region_end
, endptr
, base_face_id
, mouse_p
)
7783 int region_beg
, region_end
;
7785 enum face_id base_face_id
;
7788 Lisp_Object prop
, position
, end
, limit
;
7789 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7790 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7791 struct face
*base_face
;
7792 int multibyte_p
= STRING_MULTIBYTE (string
);
7793 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7795 /* Get the value of the face property at the current position within
7796 STRING. Value is nil if there is no face property. */
7797 XSETFASTINT (position
, pos
);
7798 prop
= Fget_text_property (position
, prop_name
, string
);
7800 /* Get the next position at which to check for faces. Value of end
7801 is nil if face is constant all the way to the end of the string.
7802 Otherwise it is a string position where to check faces next.
7803 Limit is the maximum position up to which to check for property
7804 changes in Fnext_single_property_change. Strings are usually
7805 short, so set the limit to the end of the string. */
7806 XSETFASTINT (limit
, SCHARS (string
));
7807 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7809 *endptr
= XFASTINT (end
);
7813 base_face
= FACE_FROM_ID (f
, base_face_id
);
7814 xassert (base_face
);
7816 /* Optimize the default case that there is no face property and we
7817 are not in the region. */
7819 && (base_face_id
!= DEFAULT_FACE_ID
7820 /* BUFPOS <= 0 means STRING is not an overlay string, so
7821 that the region doesn't have to be taken into account. */
7823 || bufpos
< region_beg
7824 || bufpos
>= region_end
)
7826 /* We can't realize faces for different charsets differently
7827 if we don't have fonts, so we can stop here if not working
7828 on a window-system frame. */
7829 || !FRAME_WINDOW_P (f
)
7830 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7831 return base_face
->id
;
7833 /* Begin with attributes from the base face. */
7834 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7836 /* Merge in attributes specified via text properties. */
7838 merge_face_ref (f
, prop
, attrs
, 1, 0);
7840 /* If in the region, merge in the region face. */
7842 && bufpos
>= region_beg
7843 && bufpos
< region_end
)
7844 merge_named_face (f
, Qregion
, attrs
, 0);
7846 /* Look up a realized face with the given face attributes,
7847 or realize a new one for ASCII characters. */
7848 return lookup_face (f
, attrs
);
7853 /***********************************************************************
7855 ***********************************************************************/
7859 /* Print the contents of the realized face FACE to stderr. */
7862 dump_realized_face (face
)
7865 fprintf (stderr
, "ID: %d\n", face
->id
);
7866 #ifdef HAVE_X_WINDOWS
7867 fprintf (stderr
, "gc: %d\n", (int) face
->gc
);
7869 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7871 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7872 fprintf (stderr
, "background: 0x%lx (%s)\n",
7874 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7875 fprintf (stderr
, "font_name: %s (%s)\n",
7877 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7878 #ifdef HAVE_X_WINDOWS
7879 fprintf (stderr
, "font = %p\n", face
->font
);
7881 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7882 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7883 fprintf (stderr
, "underline: %d (%s)\n",
7885 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7886 fprintf (stderr
, "hash: %d\n", face
->hash
);
7890 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7898 fprintf (stderr
, "font selection order: ");
7899 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7900 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7901 fprintf (stderr
, "\n");
7903 fprintf (stderr
, "alternative fonts: ");
7904 debug_print (Vface_alternative_font_family_alist
);
7905 fprintf (stderr
, "\n");
7907 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7908 Fdump_face (make_number (i
));
7914 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7916 error ("Not a valid face");
7917 dump_realized_face (face
);
7924 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7925 0, 0, 0, doc
: /* */)
7928 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7929 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7930 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7934 #endif /* GLYPH_DEBUG != 0 */
7938 /***********************************************************************
7940 ***********************************************************************/
7945 Qface
= intern ("face");
7947 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7948 staticpro (&Qbitmap_spec_p
);
7949 Qframe_update_face_colors
= intern ("frame-update-face-colors");
7950 staticpro (&Qframe_update_face_colors
);
7952 /* Lisp face attribute keywords. */
7953 QCfamily
= intern (":family");
7954 staticpro (&QCfamily
);
7955 QCheight
= intern (":height");
7956 staticpro (&QCheight
);
7957 QCweight
= intern (":weight");
7958 staticpro (&QCweight
);
7959 QCslant
= intern (":slant");
7960 staticpro (&QCslant
);
7961 QCunderline
= intern (":underline");
7962 staticpro (&QCunderline
);
7963 QCinverse_video
= intern (":inverse-video");
7964 staticpro (&QCinverse_video
);
7965 QCreverse_video
= intern (":reverse-video");
7966 staticpro (&QCreverse_video
);
7967 QCforeground
= intern (":foreground");
7968 staticpro (&QCforeground
);
7969 QCbackground
= intern (":background");
7970 staticpro (&QCbackground
);
7971 QCstipple
= intern (":stipple");;
7972 staticpro (&QCstipple
);
7973 QCwidth
= intern (":width");
7974 staticpro (&QCwidth
);
7975 QCfont
= intern (":font");
7976 staticpro (&QCfont
);
7977 QCfontset
= intern (":fontset");
7978 staticpro (&QCfontset
);
7979 QCbold
= intern (":bold");
7980 staticpro (&QCbold
);
7981 QCitalic
= intern (":italic");
7982 staticpro (&QCitalic
);
7983 QCoverline
= intern (":overline");
7984 staticpro (&QCoverline
);
7985 QCstrike_through
= intern (":strike-through");
7986 staticpro (&QCstrike_through
);
7987 QCbox
= intern (":box");
7989 QCinherit
= intern (":inherit");
7990 staticpro (&QCinherit
);
7992 /* Symbols used for Lisp face attribute values. */
7993 QCcolor
= intern (":color");
7994 staticpro (&QCcolor
);
7995 QCline_width
= intern (":line-width");
7996 staticpro (&QCline_width
);
7997 QCstyle
= intern (":style");
7998 staticpro (&QCstyle
);
7999 Qreleased_button
= intern ("released-button");
8000 staticpro (&Qreleased_button
);
8001 Qpressed_button
= intern ("pressed-button");
8002 staticpro (&Qpressed_button
);
8003 Qnormal
= intern ("normal");
8004 staticpro (&Qnormal
);
8005 Qultra_light
= intern ("ultra-light");
8006 staticpro (&Qultra_light
);
8007 Qextra_light
= intern ("extra-light");
8008 staticpro (&Qextra_light
);
8009 Qlight
= intern ("light");
8010 staticpro (&Qlight
);
8011 Qsemi_light
= intern ("semi-light");
8012 staticpro (&Qsemi_light
);
8013 Qsemi_bold
= intern ("semi-bold");
8014 staticpro (&Qsemi_bold
);
8015 Qbold
= intern ("bold");
8017 Qextra_bold
= intern ("extra-bold");
8018 staticpro (&Qextra_bold
);
8019 Qultra_bold
= intern ("ultra-bold");
8020 staticpro (&Qultra_bold
);
8021 Qoblique
= intern ("oblique");
8022 staticpro (&Qoblique
);
8023 Qitalic
= intern ("italic");
8024 staticpro (&Qitalic
);
8025 Qreverse_oblique
= intern ("reverse-oblique");
8026 staticpro (&Qreverse_oblique
);
8027 Qreverse_italic
= intern ("reverse-italic");
8028 staticpro (&Qreverse_italic
);
8029 Qultra_condensed
= intern ("ultra-condensed");
8030 staticpro (&Qultra_condensed
);
8031 Qextra_condensed
= intern ("extra-condensed");
8032 staticpro (&Qextra_condensed
);
8033 Qcondensed
= intern ("condensed");
8034 staticpro (&Qcondensed
);
8035 Qsemi_condensed
= intern ("semi-condensed");
8036 staticpro (&Qsemi_condensed
);
8037 Qsemi_expanded
= intern ("semi-expanded");
8038 staticpro (&Qsemi_expanded
);
8039 Qexpanded
= intern ("expanded");
8040 staticpro (&Qexpanded
);
8041 Qextra_expanded
= intern ("extra-expanded");
8042 staticpro (&Qextra_expanded
);
8043 Qultra_expanded
= intern ("ultra-expanded");
8044 staticpro (&Qultra_expanded
);
8045 Qbackground_color
= intern ("background-color");
8046 staticpro (&Qbackground_color
);
8047 Qforeground_color
= intern ("foreground-color");
8048 staticpro (&Qforeground_color
);
8049 Qunspecified
= intern ("unspecified");
8050 staticpro (&Qunspecified
);
8052 Qface_alias
= intern ("face-alias");
8053 staticpro (&Qface_alias
);
8054 Qdefault
= intern ("default");
8055 staticpro (&Qdefault
);
8056 Qtool_bar
= intern ("tool-bar");
8057 staticpro (&Qtool_bar
);
8058 Qregion
= intern ("region");
8059 staticpro (&Qregion
);
8060 Qfringe
= intern ("fringe");
8061 staticpro (&Qfringe
);
8062 Qheader_line
= intern ("header-line");
8063 staticpro (&Qheader_line
);
8064 Qscroll_bar
= intern ("scroll-bar");
8065 staticpro (&Qscroll_bar
);
8066 Qmenu
= intern ("menu");
8068 Qcursor
= intern ("cursor");
8069 staticpro (&Qcursor
);
8070 Qborder
= intern ("border");
8071 staticpro (&Qborder
);
8072 Qmouse
= intern ("mouse");
8073 staticpro (&Qmouse
);
8074 Qmode_line_inactive
= intern ("mode-line-inactive");
8075 staticpro (&Qmode_line_inactive
);
8076 Qtty_color_desc
= intern ("tty-color-desc");
8077 staticpro (&Qtty_color_desc
);
8078 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8079 staticpro (&Qtty_color_standard_values
);
8080 Qtty_color_by_index
= intern ("tty-color-by-index");
8081 staticpro (&Qtty_color_by_index
);
8082 Qtty_color_alist
= intern ("tty-color-alist");
8083 staticpro (&Qtty_color_alist
);
8084 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8085 staticpro (&Qscalable_fonts_allowed
);
8087 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8088 staticpro (&Vparam_value_alist
);
8089 Vface_alternative_font_family_alist
= Qnil
;
8090 staticpro (&Vface_alternative_font_family_alist
);
8091 Vface_alternative_font_registry_alist
= Qnil
;
8092 staticpro (&Vface_alternative_font_registry_alist
);
8094 defsubr (&Sinternal_make_lisp_face
);
8095 defsubr (&Sinternal_lisp_face_p
);
8096 defsubr (&Sinternal_set_lisp_face_attribute
);
8097 #ifdef HAVE_WINDOW_SYSTEM
8098 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8100 defsubr (&Scolor_gray_p
);
8101 defsubr (&Scolor_supported_p
);
8102 defsubr (&Sface_attribute_relative_p
);
8103 defsubr (&Smerge_face_attribute
);
8104 defsubr (&Sinternal_get_lisp_face_attribute
);
8105 defsubr (&Sinternal_lisp_face_attribute_values
);
8106 defsubr (&Sinternal_lisp_face_equal_p
);
8107 defsubr (&Sinternal_lisp_face_empty_p
);
8108 defsubr (&Sinternal_copy_lisp_face
);
8109 defsubr (&Sinternal_merge_in_global_face
);
8110 defsubr (&Sface_font
);
8111 defsubr (&Sframe_face_alist
);
8112 defsubr (&Sdisplay_supports_face_attributes_p
);
8113 defsubr (&Scolor_distance
);
8114 defsubr (&Sinternal_set_font_selection_order
);
8115 defsubr (&Sinternal_set_alternative_font_family_alist
);
8116 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8117 defsubr (&Sface_attributes_as_vector
);
8119 defsubr (&Sdump_face
);
8120 defsubr (&Sshow_face_resources
);
8121 #endif /* GLYPH_DEBUG */
8122 defsubr (&Sclear_face_cache
);
8123 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8125 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8126 defsubr (&Sdump_colors
);
8129 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8130 doc
: /* *Limit for font matching.
8131 If an integer > 0, font matching functions won't load more than
8132 that number of fonts when searching for a matching font. */);
8133 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8135 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8136 doc
: /* List of global face definitions (for internal use only.) */);
8137 Vface_new_frame_defaults
= Qnil
;
8139 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8140 doc
: /* *Default stipple pattern used on monochrome displays.
8141 This stipple pattern is used on monochrome displays
8142 instead of shades of gray for a face background color.
8143 See `set-face-stipple' for possible values for this variable. */);
8144 Vface_default_stipple
= build_string ("gray3");
8146 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8147 doc
: /* An alist of defined terminal colors and their RGB values. */);
8148 Vtty_defined_color_alist
= Qnil
;
8150 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8151 doc
: /* Allowed scalable fonts.
8152 A value of nil means don't allow any scalable fonts.
8153 A value of t means allow any scalable font.
8154 Otherwise, value must be a list of regular expressions. A font may be
8155 scaled if its name matches a regular expression in the list.
8156 Note that if value is nil, a scalable font might still be used, if no
8157 other font of the appropriate family and registry is available. */);
8158 Vscalable_fonts_allowed
= Qnil
;
8160 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8161 doc
: /* List of ignored fonts.
8162 Each element is a regular expression that matches names of fonts to
8164 Vface_ignored_fonts
= Qnil
;
8166 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8167 doc
: /* Alist of fonts vs the rescaling factors.
8168 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8169 FONT-NAME-PATTERN is a regular expression matching a font name, and
8170 RESCALE-RATIO is a floating point number to specify how much larger
8171 \(or smaller) font we should use. For instance, if a face requests
8172 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8173 Vface_font_rescale_alist
= Qnil
;
8175 #ifdef HAVE_WINDOW_SYSTEM
8176 defsubr (&Sbitmap_spec_p
);
8177 defsubr (&Sx_list_fonts
);
8178 defsubr (&Sinternal_face_x_get_resource
);
8179 defsubr (&Sx_family_fonts
);
8180 defsubr (&Sx_font_family_list
);
8181 #endif /* HAVE_WINDOW_SYSTEM */
8184 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8185 (do not change this comment) */