Include errno.h, string.h, unistd.h. Don't declare errno, strerror.
[emacs.git] / src / fontset.c
blob4df99116f9a9af34d1e40427cb34051ba1cabb8b
1 /* Fontset handler.
2 Copyright (C) 1995, 1997, 2000 Electrotechnical Laboratory, JAPAN.
3 Licensed to the 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)
10 any later version.
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 /* #define FONTSET_DEBUG */
24 #include <config.h>
26 #ifdef FONTSET_DEBUG
27 #include <stdio.h>
28 #endif
30 #include "lisp.h"
31 #include "buffer.h"
32 #include "charset.h"
33 #include "ccl.h"
34 #include "frame.h"
35 #include "dispextern.h"
36 #include "fontset.h"
37 #include "window.h"
39 #ifdef FONTSET_DEBUG
40 #undef xassert
41 #define xassert(X) do {if (!(X)) abort ();} while (0)
42 #undef INLINE
43 #define INLINE
44 #endif
47 /* FONTSET
49 A fontset is a collection of font related information to give
50 similar appearance (style, size, etc) of characters. There are two
51 kinds of fontsets; base and realized. A base fontset is created by
52 new-fontset from Emacs Lisp explicitly. A realized fontset is
53 created implicitly when a face is realized for ASCII characters. A
54 face is also realized for multibyte characters based on an ASCII
55 face. All of the multibyte faces based on the same ASCII face
56 share the same realized fontset.
58 A fontset object is implemented by a char-table.
60 An element of a base fontset is:
61 (INDEX . FONTNAME) or
62 (INDEX . (FOUNDRY . REGISTRY ))
63 FONTNAME is a font name pattern for the corresponding character.
64 FOUNDRY and REGISTRY are respectively foundy and regisry fields of
65 a font name for the corresponding character. INDEX specifies for
66 which character (or generic character) the element is defined. It
67 may be different from an index to access this element. For
68 instance, if a fontset defines some font for all characters of
69 charset `japanese-jisx0208', INDEX is the generic character of this
70 charset. REGISTRY is the
72 An element of a realized fontset is FACE-ID which is a face to use
73 for displaying the correspnding character.
75 All single byte charaters (ASCII and 8bit-unibyte) share the same
76 element in a fontset. The element is stored in `defalt' slot of
77 the fontset. And this slot is never used as a default value of
78 multibyte characters. That means that the first 256 elements of a
79 fontset are always nil (as this is not efficient, we may implement
80 a fontset in a different way in the future).
82 To access or set each element, use macros FONTSET_REF and
83 FONTSET_SET respectively for efficiency.
85 A fontset has 3 extra slots.
87 The 1st slot is an ID number of the fontset.
89 The 2nd slot is a name of the fontset. This is nil for a realized
90 face.
92 The 3rd slot is a frame that the fontset belongs to. This is nil
93 for a default face.
95 A parent of a base fontset is nil. A parent of a realized fontset
96 is a base fontset.
98 All fontsets (except for the default fontset described below) are
99 recorded in Vfontset_table.
102 DEFAULT FONTSET
104 There's a special fontset named `default fontset' which defines a
105 default fontname that contains only REGISTRY field for each
106 character. When a base fontset doesn't specify a font for a
107 specific character, the corresponding value in the default fontset
108 is used. The format is the same as a base fontset.
110 The parent of realized fontsets created for faces that have no
111 fontset is the default fontset.
114 These structures are hidden from the other codes than this file.
115 The other codes handle fontsets only by their ID numbers. They
116 usually use variable name `fontset' for IDs. But, in this file, we
117 always use varialbe name `id' for IDs, and name `fontset' for the
118 actual fontset objects.
122 /********** VARIABLES and FUNCTION PROTOTYPES **********/
124 extern Lisp_Object Qfont;
125 Lisp_Object Qfontset;
127 /* Vector containing all fontsets. */
128 static Lisp_Object Vfontset_table;
130 /* Next possibly free fontset ID. Usually this keeps the mininum
131 fontset ID not yet used. */
132 static int next_fontset_id;
134 /* The default fontset. This gives default FAMILY and REGISTRY of
135 font for each characters. */
136 static Lisp_Object Vdefault_fontset;
138 Lisp_Object Vfont_encoding_alist;
139 Lisp_Object Vuse_default_ascent;
140 Lisp_Object Vignore_relative_composition;
141 Lisp_Object Valternate_fontname_alist;
142 Lisp_Object Vfontset_alias_alist;
143 Lisp_Object Vhighlight_wrong_size_font;
144 Lisp_Object Vclip_large_size_font;
145 Lisp_Object Vvertical_centering_font_regexp;
147 /* The following six are declarations of callback functions depending
148 on window system. See the comments in src/fontset.h for more
149 detail. */
151 /* Return a pointer to struct font_info of font FONT_IDX of frame F. */
152 struct font_info *(*get_font_info_func) P_ ((FRAME_PTR f, int font_idx));
154 /* Return a list of font names which matches PATTERN. See the document of
155 `x-list-fonts' for more detail. */
156 Lisp_Object (*list_fonts_func) P_ ((struct frame *f,
157 Lisp_Object pattern,
158 int size,
159 int maxnames));
161 /* Load a font named NAME for frame F and return a pointer to the
162 information of the loaded font. If loading is failed, return 0. */
163 struct font_info *(*load_font_func) P_ ((FRAME_PTR f, char *name, int));
165 /* Return a pointer to struct font_info of a font named NAME for frame F. */
166 struct font_info *(*query_font_func) P_ ((FRAME_PTR f, char *name));
168 /* Additional function for setting fontset or changing fontset
169 contents of frame F. */
170 void (*set_frame_fontset_func) P_ ((FRAME_PTR f, Lisp_Object arg,
171 Lisp_Object oldval));
173 /* To find a CCL program, fs_load_font calls this function.
174 The argument is a pointer to the struct font_info.
175 This function set the memer `encoder' of the structure. */
176 void (*find_ccl_program_func) P_ ((struct font_info *));
178 /* Check if any window system is used now. */
179 void (*check_window_system_func) P_ ((void));
182 /* Prototype declarations for static functions. */
183 static Lisp_Object fontset_ref P_ ((Lisp_Object, int));
184 static void fontset_set P_ ((Lisp_Object, int, Lisp_Object));
185 static Lisp_Object make_fontset P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
186 static int fontset_id_valid_p P_ ((int));
187 static Lisp_Object fontset_pattern_regexp P_ ((Lisp_Object));
188 static Lisp_Object font_family_registry P_ ((Lisp_Object));
191 /********** MACROS AND FUNCTIONS TO HANDLE FONTSET **********/
193 /* Macros for Lisp vector. */
194 #define AREF(V, IDX) XVECTOR (V)->contents[IDX]
195 #define ASIZE(V) XVECTOR (V)->size
197 /* Return the fontset with ID. No check of ID's validness. */
198 #define FONTSET_FROM_ID(id) AREF (Vfontset_table, id)
200 /* Macros to access extra, default, and parent slots, of fontset. */
201 #define FONTSET_ID(fontset) XCHAR_TABLE (fontset)->extras[0]
202 #define FONTSET_NAME(fontset) XCHAR_TABLE (fontset)->extras[1]
203 #define FONTSET_FRAME(fontset) XCHAR_TABLE (fontset)->extras[2]
204 #define FONTSET_ASCII(fontset) XCHAR_TABLE (fontset)->defalt
205 #define FONTSET_BASE(fontset) XCHAR_TABLE (fontset)->parent
207 #define BASE_FONTSET_P(fontset) NILP (FONTSET_BASE(fontset))
210 /* Return the element of FONTSET (char-table) at index C (character). */
212 #define FONTSET_REF(fontset, c) fontset_ref (fontset, c)
214 static INLINE Lisp_Object
215 fontset_ref (fontset, c)
216 Lisp_Object fontset;
217 int c;
219 int charset, c1, c2;
220 Lisp_Object elt, defalt;
221 int i;
223 if (SINGLE_BYTE_CHAR_P (c))
224 return FONTSET_ASCII (fontset);
226 SPLIT_CHAR (c, charset, c1, c2);
227 elt = XCHAR_TABLE (fontset)->contents[charset + 128];
228 if (!SUB_CHAR_TABLE_P (elt))
229 return elt;
230 defalt = XCHAR_TABLE (elt)->defalt;
231 if (c1 < 32
232 || (elt = XCHAR_TABLE (elt)->contents[c1],
233 NILP (elt)))
234 return defalt;
235 if (!SUB_CHAR_TABLE_P (elt))
236 return elt;
237 defalt = XCHAR_TABLE (elt)->defalt;
238 if (c2 < 32
239 || (elt = XCHAR_TABLE (elt)->contents[c2],
240 NILP (elt)))
241 return defalt;
242 return elt;
246 #define FONTSET_REF_VIA_BASE(fontset, c) fontset_ref_via_base (fontset, &c)
248 static INLINE Lisp_Object
249 fontset_ref_via_base (fontset, c)
250 Lisp_Object fontset;
251 int *c;
253 int charset, c1, c2;
254 Lisp_Object elt;
256 if (SINGLE_BYTE_CHAR_P (*c))
257 return FONTSET_ASCII (fontset);
259 elt = FONTSET_REF (FONTSET_BASE (fontset), *c);
260 if (NILP (elt))
261 return Qnil;
263 *c = XINT (XCAR (elt));
264 SPLIT_CHAR (*c, charset, c1, c2);
265 elt = XCHAR_TABLE (fontset)->contents[charset + 128];
266 if (c1 < 32)
267 return (SUB_CHAR_TABLE_P (elt) ? XCHAR_TABLE (elt)->defalt : elt);
268 if (!SUB_CHAR_TABLE_P (elt))
269 return Qnil;
270 elt = XCHAR_TABLE (elt)->contents[c1];
271 if (c2 < 32)
272 return (SUB_CHAR_TABLE_P (elt) ? XCHAR_TABLE (elt)->defalt : elt);
273 if (!SUB_CHAR_TABLE_P (elt))
274 return Qnil;
275 elt = XCHAR_TABLE (elt)->contents[c2];
276 return elt;
280 /* Store into the element of FONTSET at index C the value NEWETL. */
281 #define FONTSET_SET(fontset, c, newelt) fontset_set(fontset, c, newelt)
283 static void
284 fontset_set (fontset, c, newelt)
285 Lisp_Object fontset;
286 int c;
287 Lisp_Object newelt;
289 int charset, code[3];
290 Lisp_Object *elt, tmp;
291 int i, j;
293 if (SINGLE_BYTE_CHAR_P (c))
295 FONTSET_ASCII (fontset) = newelt;
296 return;
299 SPLIT_CHAR (c, charset, code[0], code[1]);
300 code[2] = 0; /* anchor */
301 elt = &XCHAR_TABLE (fontset)->contents[charset + 128];
302 for (i = 0; code[i] > 0; i++)
304 if (!SUB_CHAR_TABLE_P (*elt))
305 *elt = make_sub_char_table (*elt);
306 elt = &XCHAR_TABLE (*elt)->contents[code[i]];
308 if (SUB_CHAR_TABLE_P (*elt))
309 XCHAR_TABLE (*elt)->defalt = newelt;
310 else
311 *elt = newelt;
315 /* Return a newly created fontset with NAME. If BASE is nil, make a
316 base fontset. Otherwise make a realized fontset whose parent is
317 BASE. */
319 static Lisp_Object
320 make_fontset (frame, name, base)
321 Lisp_Object frame, name, base;
323 Lisp_Object fontset, elt, base_elt;
324 int size = ASIZE (Vfontset_table);
325 int id = next_fontset_id;
326 int i, j;
328 /* Find a free slot in Vfontset_table. Usually, next_fontset_id is
329 the next available fontset ID. So it is expected that this loop
330 terminates quickly. In addition, as the last element of
331 Vfotnset_table is always nil, we don't have to check the range of
332 id. */
333 while (!NILP (AREF (Vfontset_table, id))) id++;
335 if (id + 1 == size)
337 Lisp_Object tem;
338 int i;
340 tem = Fmake_vector (make_number (size + 8), Qnil);
341 for (i = 0; i < size; i++)
342 AREF (tem, i) = AREF (Vfontset_table, i);
343 Vfontset_table = tem;
346 if (NILP (base))
347 fontset = Fcopy_sequence (Vdefault_fontset);
348 else
349 fontset = Fmake_char_table (Qfontset, Qnil);
351 FONTSET_ID (fontset) = make_number (id);
352 FONTSET_NAME (fontset) = name;
353 FONTSET_FRAME (fontset) = frame;
354 FONTSET_BASE (fontset) = base;
356 AREF (Vfontset_table, id) = fontset;
357 next_fontset_id = id + 1;
358 return fontset;
362 /* Return 1 if ID is a valid fontset id, else return 0. */
364 static INLINE int
365 fontset_id_valid_p (id)
366 int id;
368 return (id >= 0 && id < ASIZE (Vfontset_table) - 1);
372 /* Extract `family' and `registry' string from FONTNAME and set in
373 *FAMILY and *REGISTRY respectively. Actually, `family' may also
374 contain `foundry', `registry' may also contain `encoding' of
375 FONTNAME. */
377 static Lisp_Object
378 font_family_registry (fontname)
379 Lisp_Object fontname;
381 Lisp_Object family, registry;
382 char *p = XSTRING (fontname)->data;
383 char *sep[15];
384 int i = 0;
386 while (*p && i < 15) if (*p++ == '-') sep[i++] = p;
387 if (i != 14)
388 return fontname;
390 family = make_unibyte_string (sep[0], sep[2] - 1 - sep[0]);
391 registry = make_unibyte_string (sep[12], p - sep[12]);
392 return Fcons (family, registry);
396 /********** INTERFACES TO xfaces.c and dispextern.h **********/
398 /* Return name of the fontset with ID. */
400 Lisp_Object
401 fontset_name (id)
402 int id;
404 Lisp_Object fontset;
405 fontset = FONTSET_FROM_ID (id);
406 return FONTSET_NAME (fontset);
410 /* Return ASCII font name of the fontset with ID. */
412 Lisp_Object
413 fontset_ascii (id)
414 int id;
416 Lisp_Object fontset, elt;
417 fontset= FONTSET_FROM_ID (id);
418 elt = FONTSET_ASCII (fontset);
419 return XCDR (elt);
423 /* Free fontset of FACE. Called from free_realized_face. */
425 void
426 free_face_fontset (f, face)
427 FRAME_PTR f;
428 struct face *face;
430 if (fontset_id_valid_p (face->fontset))
432 AREF (Vfontset_table, face->fontset) = Qnil;
433 if (face->fontset < next_fontset_id)
434 next_fontset_id = face->fontset;
439 /* Return 1 iff FACE is suitable for displaying character C.
440 Otherwise return 0. Called from the macro FACE_SUITABLE_FOR_CHAR_P
441 when C is not a single byte character.. */
444 face_suitable_for_char_p (face, c)
445 struct face *face;
446 int c;
448 Lisp_Object fontset, elt;
450 if (SINGLE_BYTE_CHAR_P (c))
451 return (face == face->ascii_face);
453 xassert (fontset_id_valid_p (face->fontset));
454 fontset = FONTSET_FROM_ID (face->fontset);
455 xassert (!BASE_FONTSET_P (fontset));
457 elt = FONTSET_REF_VIA_BASE (fontset, c);
458 return (!NILP (elt) && face->id == XFASTINT (elt));
462 /* Return ID of face suitable for displaying character C on frame F.
463 The selection of face is done based on the fontset of FACE. FACE
464 should already have been realized for ASCII characters. Called
465 from the macro FACE_FOR_CHAR when C is not a single byte character. */
468 face_for_char (f, face, c)
469 FRAME_PTR f;
470 struct face *face;
471 int c;
473 Lisp_Object fontset, elt;
474 int face_id;
476 xassert (fontset_id_valid_p (face->fontset));
477 fontset = FONTSET_FROM_ID (face->fontset);
478 xassert (!BASE_FONTSET_P (fontset));
480 elt = FONTSET_REF_VIA_BASE (fontset, c);
481 if (!NILP (elt))
482 return XINT (elt);
484 /* No face is recorded for C in the fontset of FACE. Make a new
485 realized face for C that has the same fontset. */
486 face_id = lookup_face (f, face->lface, c, face);
488 /* Record the face ID in FONTSET at the same index as the
489 information in the base fontset. */
490 FONTSET_SET (fontset, c, make_number (face_id));
491 return face_id;
495 /* Make a realized fontset for ASCII face FACE on frame F from the
496 base fontset BASE_FONTSET_ID. If BASE_FONTSET_ID is -1, use the
497 default fontset as the base. Value is the id of the new fontset.
498 Called from realize_x_face. */
501 make_fontset_for_ascii_face (f, base_fontset_id)
502 FRAME_PTR f;
503 int base_fontset_id;
505 Lisp_Object base_fontset, fontset, name, frame;
507 XSETFRAME (frame, f);
508 if (base_fontset_id >= 0)
510 base_fontset = FONTSET_FROM_ID (base_fontset_id);
511 if (!BASE_FONTSET_P (base_fontset))
512 base_fontset = FONTSET_BASE (base_fontset);
513 xassert (BASE_FONTSET_P (base_fontset));
515 else
516 base_fontset = Vdefault_fontset;
518 fontset = make_fontset (frame, Qnil, base_fontset);
519 return XINT (FONTSET_ID (fontset));
523 /* Return the font name pattern for C that is recorded in the fontset
524 with ID. A font is opened by that pattern to get the fullname. If
525 the fullname conform to XLFD, extract foundry-family field and
526 registry-encoding field, and return the cons of them. Otherwise
527 return the fullname. If ID is -1, or the fontset doesn't contain
528 information about C, get the registry and encoding of C from the
529 default fontset. Called from choose_face_font. */
531 Lisp_Object
532 fontset_font_pattern (f, id, c)
533 FRAME_PTR f;
534 int id, c;
536 Lisp_Object fontset, elt;
537 struct font_info *fontp;
538 Lisp_Object family_registry;
540 elt = Qnil;
541 if (fontset_id_valid_p (id))
543 fontset = FONTSET_FROM_ID (id);
544 xassert (!BASE_FONTSET_P (fontset));
545 fontset = FONTSET_BASE (fontset);
546 elt = FONTSET_REF (fontset, c);
548 else
549 elt = FONTSET_REF (Vdefault_fontset, c);
551 if (!CONSP (elt))
552 return Qnil;
553 if (CONSP (XCDR (elt)))
554 return XCDR (elt);
556 /* The fontset specifies only a font name pattern (not cons of
557 family and registry). Try to open a font by that pattern and get
558 a registry from the full name of the opened font. We ignore
559 family name here because it should be wild card in the fontset
560 specification. */
561 elt = XCDR (elt);
562 xassert (STRINGP (elt));
563 fontp = FS_LOAD_FONT (f, c, XSTRING (elt)->data, -1);
564 if (!fontp)
565 return Qnil;
567 family_registry = font_family_registry (build_string (fontp->full_name));
568 if (!CONSP (family_registry))
569 return family_registry;
570 XCAR (family_registry) = Qnil;
571 return family_registry;
575 /* Load a font named FONTNAME to display character C on frame F.
576 Return a pointer to the struct font_info of the loaded font. If
577 loading fails, return NULL. If FACE is non-zero and a fontset is
578 assigned to it, record FACE->id in the fontset for C. If FONTNAME
579 is NULL, the name is taken from the fontset of FACE or what
580 specified by ID. */
582 struct font_info *
583 fs_load_font (f, c, fontname, id, face)
584 FRAME_PTR f;
585 int c;
586 char *fontname;
587 int id;
588 struct face *face;
590 Lisp_Object fontset;
591 Lisp_Object list, elt;
592 int font_idx;
593 int size = 0;
594 struct font_info *fontp;
595 int charset = CHAR_CHARSET (c);
597 if (face)
598 id = face->fontset;
599 if (id < 0)
600 fontset = Qnil;
601 else
602 fontset = FONTSET_FROM_ID (id);
604 if (!NILP (fontset)
605 && !BASE_FONTSET_P (fontset))
607 elt = FONTSET_REF_VIA_BASE (fontset, c);
608 if (!NILP (elt))
610 /* A suitable face for C is already recorded, which means
611 that a proper font is already loaded. */
612 int face_id = XINT (elt);
614 xassert (face_id == face->id);
615 face = FACE_FROM_ID (f, face_id);
616 return (*get_font_info_func) (f, face->font_info_id);
619 if (!fontname && charset == CHARSET_ASCII)
621 elt = FONTSET_ASCII (fontset);
622 fontname = XSTRING (XCDR (elt))->data;
626 if (!fontname)
627 /* No way to get fontname. */
628 return 0;
630 fontp = (*load_font_func) (f, fontname, size);
631 if (!fontp)
632 return 0;
634 /* Fill in members (charset, vertical_centering, encoding, etc) of
635 font_info structure that are not set by (*load_font_func). */
636 fontp->charset = charset;
638 fontp->vertical_centering
639 = (STRINGP (Vvertical_centering_font_regexp)
640 && (fast_c_string_match_ignore_case
641 (Vvertical_centering_font_regexp, fontp->full_name) >= 0));
643 if (fontp->encoding[1] != FONT_ENCODING_NOT_DECIDED)
645 /* The font itself tells which code points to be used. Use this
646 encoding for all other charsets. */
647 int i;
649 fontp->encoding[0] = fontp->encoding[1];
650 for (i = MIN_CHARSET_OFFICIAL_DIMENSION1; i <= MAX_CHARSET; i++)
651 fontp->encoding[i] = fontp->encoding[1];
653 else
655 /* The font itself doesn't have information about encoding. */
656 int i;
658 fontname = fontp->full_name;
659 /* By default, encoding of ASCII chars is 0 (i.e. 0x00..0x7F),
660 others is 1 (i.e. 0x80..0xFF). */
661 fontp->encoding[0] = 0;
662 for (i = MIN_CHARSET_OFFICIAL_DIMENSION1; i <= MAX_CHARSET; i++)
663 fontp->encoding[i] = 1;
664 /* Then override them by a specification in Vfont_encoding_alist. */
665 for (list = Vfont_encoding_alist; CONSP (list); list = XCDR (list))
667 elt = XCAR (list);
668 if (CONSP (elt)
669 && STRINGP (XCAR (elt)) && CONSP (XCDR (elt))
670 && (fast_c_string_match_ignore_case (XCAR (elt), fontname)
671 >= 0))
673 Lisp_Object tmp;
675 for (tmp = XCDR (elt); CONSP (tmp); tmp = XCDR (tmp))
676 if (CONSP (XCAR (tmp))
677 && ((i = get_charset_id (XCAR (XCAR (tmp))))
678 >= 0)
679 && INTEGERP (XCDR (XCAR (tmp)))
680 && XFASTINT (XCDR (XCAR (tmp))) < 4)
681 fontp->encoding[i]
682 = XFASTINT (XCDR (XCAR (tmp)));
687 fontp->font_encoder = (struct ccl_program *) 0;
689 if (find_ccl_program_func)
690 (*find_ccl_program_func) (fontp);
692 /* If we loaded a font for a face that has fontset, record the face
693 ID in the fontset for C. */
694 if (face
695 && !NILP (fontset)
696 && !BASE_FONTSET_P (fontset))
697 FONTSET_SET (fontset, c, make_number (face->id));
698 return fontp;
702 /* Cache data used by fontset_pattern_regexp. The car part is a
703 pattern string containing at least one wild card, the cdr part is
704 the corresponding regular expression. */
705 static Lisp_Object Vcached_fontset_data;
707 #define CACHED_FONTSET_NAME (XSTRING (XCAR (Vcached_fontset_data))->data)
708 #define CACHED_FONTSET_REGEX (XCDR (Vcached_fontset_data))
710 /* If fontset name PATTERN contains any wild card, return regular
711 expression corresponding to PATTERN. */
713 static Lisp_Object
714 fontset_pattern_regexp (pattern)
715 Lisp_Object pattern;
717 if (!index (XSTRING (pattern)->data, '*')
718 && !index (XSTRING (pattern)->data, '?'))
719 /* PATTERN does not contain any wild cards. */
720 return Qnil;
722 if (!CONSP (Vcached_fontset_data)
723 || strcmp (XSTRING (pattern)->data, CACHED_FONTSET_NAME))
725 /* We must at first update the cached data. */
726 char *regex = (char *) alloca (XSTRING (pattern)->size * 2);
727 char *p0, *p1 = regex;
729 /* Convert "*" to ".*", "?" to ".". */
730 *p1++ = '^';
731 for (p0 = (char *) XSTRING (pattern)->data; *p0; p0++)
733 if (*p0 == '*')
735 *p1++ = '.';
736 *p1++ = '*';
738 else if (*p0 == '?')
739 *p1++ = '.';
740 else
741 *p1++ = *p0;
743 *p1++ = '$';
744 *p1++ = 0;
746 Vcached_fontset_data = Fcons (build_string (XSTRING (pattern)->data),
747 build_string (regex));
750 return CACHED_FONTSET_REGEX;
753 /* Return ID of the base fontset named NAME. If there's no such
754 fontset, return -1. */
757 fs_query_fontset (name, regexpp)
758 Lisp_Object name;
759 int regexpp;
761 Lisp_Object fontset, tem;
762 int i;
764 name = Fdowncase (name);
765 if (!regexpp)
767 tem = Frassoc (name, Vfontset_alias_alist);
768 if (CONSP (tem) && STRINGP (XCAR (tem)))
769 name = XCAR (tem);
770 else
772 tem = fontset_pattern_regexp (name);
773 if (STRINGP (tem))
775 name = tem;
776 regexpp = 1;
781 for (i = 0; i < ASIZE (Vfontset_table); i++)
783 Lisp_Object fontset;
784 unsigned char *this_name;
786 fontset = FONTSET_FROM_ID (i);
787 if (NILP (fontset)
788 || !BASE_FONTSET_P (fontset))
789 continue;
791 this_name = XSTRING (FONTSET_NAME (fontset))->data;
792 if (regexpp
793 ? fast_c_string_match_ignore_case (name, this_name) >= 0
794 : !strcmp (XSTRING (name)->data, this_name))
795 return i;
797 return -1;
801 DEFUN ("query-fontset", Fquery_fontset, Squery_fontset, 1, 2, 0,
802 "Return the name of a fontset that matches PATTERN.\n\
803 The value is nil if there is no matching fontset.\n\
804 PATTERN can contain `*' or `?' as a wildcard\n\
805 just as X font name matching algorithm allows.\n\
806 If REGEXPP is non-nil, PATTERN is a regular expression.")
807 (pattern, regexpp)
808 Lisp_Object pattern, regexpp;
810 Lisp_Object fontset;
811 int id;
813 (*check_window_system_func) ();
815 CHECK_STRING (pattern, 0);
817 if (XSTRING (pattern)->size == 0)
818 return Qnil;
820 id = fs_query_fontset (pattern, !NILP (regexpp));
821 if (id < 0)
822 return Qnil;
824 fontset = FONTSET_FROM_ID (id);
825 return FONTSET_NAME (fontset);
828 /* Return a list of base fontset names matching PATTERN on frame F.
829 If SIZE is not 0, it is the size (maximum bound width) of fontsets
830 to be listed. */
832 Lisp_Object
833 list_fontsets (f, pattern, size)
834 FRAME_PTR f;
835 Lisp_Object pattern;
836 int size;
838 Lisp_Object frame, regexp, val, tail;
839 int id;
841 XSETFRAME (frame, f);
843 regexp = fontset_pattern_regexp (pattern);
844 val = Qnil;
846 for (id = 0; id < ASIZE (Vfontset_table); id++)
848 Lisp_Object fontset;
849 unsigned char *name;
851 fontset = FONTSET_FROM_ID (id);
852 if (NILP (fontset)
853 || !BASE_FONTSET_P (fontset)
854 || !EQ (frame, FONTSET_FRAME (fontset)))
855 continue;
856 name = XSTRING (FONTSET_NAME (fontset))->data;
858 if (!NILP (regexp)
859 ? (fast_c_string_match_ignore_case (regexp, name) < 0)
860 : strcmp (XSTRING (pattern)->data, name))
861 continue;
863 if (size)
865 struct font_info *fontp;
866 fontp = FS_LOAD_FONT (f, 0, NULL, id);
867 if (!fontp || size != fontp->size)
868 continue;
870 val = Fcons (Fcopy_sequence (FONTSET_NAME (fontset)), val);
873 return val;
876 DEFUN ("new-fontset", Fnew_fontset, Snew_fontset, 2, 2, 0,
877 "Create a new fontset NAME that contains font information in FONTLIST.\n\
878 FONTLIST is an alist of charsets vs corresponding font name patterns.")
879 (name, fontlist)
880 Lisp_Object name, fontlist;
882 Lisp_Object fontset, elements, ascii_font;
883 Lisp_Object tem, tail, elt;
885 (*check_window_system_func) ();
887 CHECK_STRING (name, 0);
888 CHECK_LIST (fontlist, 1);
890 name = Fdowncase (name);
891 tem = Fquery_fontset (name, Qnil);
892 if (!NILP (tem))
893 error ("Fontset `%s' matches the existing fontset `%s'",
894 XSTRING (name)->data, XSTRING (tem)->data);
896 /* Check the validity of FONTLIST while creating a template for
897 fontset elements. */
898 elements = ascii_font = Qnil;
899 for (tail = fontlist; CONSP (tail); tail = XCDR (tail))
901 Lisp_Object family, registry;
902 int c, charset;
904 tem = XCAR (tail);
905 if (!CONSP (tem)
906 || (charset = get_charset_id (XCAR (tem))) < 0
907 || !STRINGP (XCDR (tem)))
908 error ("Elements of fontlist must be a cons of charset and font name");
910 tem = Fdowncase (XCDR (tem));
911 if (charset == CHARSET_ASCII)
912 ascii_font = tem;
913 else
915 c = MAKE_CHAR (charset, 0, 0);
916 elements = Fcons (Fcons (make_number (c), tem), elements);
920 if (NILP (ascii_font))
921 error ("No ASCII font in the fontlist");
923 fontset = make_fontset (Qnil, name, Qnil);
924 FONTSET_ASCII (fontset) = Fcons (make_number (0), ascii_font);
925 for (; CONSP (elements); elements = XCDR (elements))
927 elt = XCAR (elements);
928 tem = Fcons (XCAR (elt), font_family_registry (XCDR (elt)));
929 FONTSET_SET (fontset, XINT (XCAR (elt)), tem);
932 return Qnil;
936 /* Clear all elements of FONTSET for multibyte characters. */
938 static void
939 clear_fontset_elements (fontset)
940 Lisp_Object fontset;
942 int i;
944 for (i = CHAR_TABLE_SINGLE_BYTE_SLOTS; i < CHAR_TABLE_ORDINARY_SLOTS; i++)
945 XCHAR_TABLE (fontset)->contents[i] = Qnil;
949 /* Check validity of NAME as a fontset name and return the
950 corresponding fontset. If not valid, signal an error.
951 If NAME is t, return Vdefault_fontset. */
953 static Lisp_Object
954 check_fontset_name (name)
955 Lisp_Object name;
957 int id;
959 if (EQ (name, Qt))
960 return Vdefault_fontset;
962 CHECK_STRING (name, 0);
963 id = fs_query_fontset (name, 0);
964 if (id < 0)
965 error ("Fontset `%s' does not exist", XSTRING (name)->data);
966 return FONTSET_FROM_ID (id);
969 DEFUN ("set-fontset-font", Fset_fontset_font, Sset_fontset_font, 3, 4, 0,
970 "Modify fontset NAME to use FONTNAME for CHARACTER.\n\
972 CHARACTER may be a cons; (FROM . TO), where FROM and TO are\n\
973 non-generic characters. In that case, use FONTNAME\n\
974 for all characters in the range FROM and TO (inclusive).\n\
975 CHARACTER may be a charset. In that case, use FONTNAME\n\
976 for all character in the charsets.\n\
978 FONTNAME may be a cons; (FAMILY . REGISTRY), where FAMILY is a family\n\
979 name of a font, REGSITRY is a registry name of a font.")
980 (name, character, fontname, frame)
981 Lisp_Object name, character, fontname, frame;
983 Lisp_Object fontset, elt;
984 Lisp_Object realized;
985 int from, to;
986 int id;
987 Lisp_Object family, registry;
989 fontset = check_fontset_name (name);
991 if (CONSP (character))
993 /* CH should be (FROM . TO) where FROM and TO are non-generic
994 characters. */
995 CHECK_NUMBER (XCAR (character), 1);
996 CHECK_NUMBER (XCDR (character), 1);
997 from = XINT (XCAR (character));
998 to = XINT (XCDR (character));
999 if (!char_valid_p (from, 0) || !char_valid_p (to, 0))
1000 error ("Character range should be by non-generic characters.");
1001 if (!NILP (name)
1002 && (SINGLE_BYTE_CHAR_P (from) || SINGLE_BYTE_CHAR_P (to)))
1003 error ("Can't change font for a single byte character");
1005 else if (SYMBOLP (character))
1007 elt = Fget (character, Qcharset);
1008 if (!VECTORP (elt) || ASIZE (elt) < 1 || !NATNUMP (AREF (elt, 0)))
1009 error ("Invalid charset: %s", (XSYMBOL (character)->name)->data);
1010 from = MAKE_CHAR (XINT (AREF (elt, 0)), 0, 0);
1011 to = from;
1013 else
1015 CHECK_NUMBER (character, 1);
1016 from = XINT (character);
1017 to = from;
1019 if (!char_valid_p (from, 1))
1020 invalid_character (from);
1021 if (SINGLE_BYTE_CHAR_P (from))
1022 error ("Can't change font for a single byte character");
1023 if (from < to)
1025 if (!char_valid_p (to, 1))
1026 invalid_character (to);
1027 if (SINGLE_BYTE_CHAR_P (to))
1028 error ("Can't change font for a single byte character");
1031 if (STRINGP (fontname))
1033 fontname = Fdowncase (fontname);
1034 elt = Fcons (make_number (from), font_family_registry (fontname));
1036 else
1038 CHECK_CONS (fontname, 2);
1039 family = XCAR (fontname);
1040 registry = XCDR (fontname);
1041 if (!NILP (family))
1042 CHECK_STRING (family, 2);
1043 if (!NILP (registry))
1044 CHECK_STRING (registry, 2);
1045 elt = Fcons (make_number (from), Fcons (family, registry));
1048 /* The arg FRAME is kept for backward compatibility. We only check
1049 the validity. */
1050 if (!NILP (frame))
1051 CHECK_LIVE_FRAME (frame, 3);
1053 for (; from <= to; from++)
1054 FONTSET_SET (fontset, from, elt);
1055 Foptimize_char_table (fontset);
1057 /* If there's a realized fontset REALIZED whose parent is FONTSET,
1058 clear all the elements of REALIZED and free all multibyte faces
1059 whose fontset is REALIZED. This way, the specified character(s)
1060 are surely redisplayed by a correct font. */
1061 for (id = 0; id < ASIZE (Vfontset_table); id++)
1063 realized = AREF (Vfontset_table, id);
1064 if (!NILP (realized)
1065 && !BASE_FONTSET_P (realized)
1066 && EQ (FONTSET_BASE (realized), fontset))
1068 FRAME_PTR f = XFRAME (FONTSET_FRAME (realized));
1069 clear_fontset_elements (realized);
1070 free_realized_multibyte_face (f, id);
1074 return Qnil;
1077 DEFUN ("font-info", Ffont_info, Sfont_info, 1, 2, 0,
1078 "Return information about a font named NAME on frame FRAME.\n\
1079 If FRAME is omitted or nil, use the selected frame.\n\
1080 The returned value is a vector of OPENED-NAME, FULL-NAME, CHARSET, SIZE,\n\
1081 HEIGHT, BASELINE-OFFSET, RELATIVE-COMPOSE, and DEFAULT-ASCENT,\n\
1082 where\n\
1083 OPENED-NAME is the name used for opening the font,\n\
1084 FULL-NAME is the full name of the font,\n\
1085 SIZE is the maximum bound width of the font,\n\
1086 HEIGHT is the height of the font,\n\
1087 BASELINE-OFFSET is the upward offset pixels from ASCII baseline,\n\
1088 RELATIVE-COMPOSE and DEFAULT-ASCENT are the numbers controlling\n\
1089 how to compose characters.\n\
1090 If the named font is not yet loaded, return nil.")
1091 (name, frame)
1092 Lisp_Object name, frame;
1094 FRAME_PTR f;
1095 struct font_info *fontp;
1096 Lisp_Object info;
1098 (*check_window_system_func) ();
1100 CHECK_STRING (name, 0);
1101 name = Fdowncase (name);
1102 if (NILP (frame))
1103 frame = selected_frame;
1104 CHECK_LIVE_FRAME (frame, 1);
1105 f = XFRAME (frame);
1107 if (!query_font_func)
1108 error ("Font query function is not supported");
1110 fontp = (*query_font_func) (f, XSTRING (name)->data);
1111 if (!fontp)
1112 return Qnil;
1114 info = Fmake_vector (make_number (7), Qnil);
1116 XVECTOR (info)->contents[0] = build_string (fontp->name);
1117 XVECTOR (info)->contents[1] = build_string (fontp->full_name);
1118 XVECTOR (info)->contents[2] = make_number (fontp->size);
1119 XVECTOR (info)->contents[3] = make_number (fontp->height);
1120 XVECTOR (info)->contents[4] = make_number (fontp->baseline_offset);
1121 XVECTOR (info)->contents[5] = make_number (fontp->relative_compose);
1122 XVECTOR (info)->contents[6] = make_number (fontp->default_ascent);
1124 return info;
1128 /* Return the font name for the character at POSITION in the current
1129 buffer. This is computed from all the text properties and overlays
1130 that apply to POSITION. It returns nil in the following cases:
1132 (1) The window system doesn't have a font for the character (thus
1133 it is displayed by an empty box).
1135 (2) The character code is invalid.
1137 (3) The current buffer is not displayed in any window.
1139 In addition, the returned font name may not take into account of
1140 such redisplay engine hooks as what used in jit-lock-mode if
1141 POSITION is currently not visible. */
1144 DEFUN ("internal-char-font", Finternal_char_font, Sinternal_char_font, 1, 1, 0,
1145 "For internal use only.")
1146 (position)
1147 Lisp_Object position;
1149 int pos, pos_byte, dummy;
1150 int face_id;
1151 int c;
1152 Lisp_Object window;
1153 struct window *w;
1154 struct frame *f;
1155 struct face *face;
1157 CHECK_NUMBER_COERCE_MARKER (position, 0);
1158 pos = XINT (position);
1159 if (pos < BEGV || pos >= ZV)
1160 args_out_of_range_3 (position, make_number (BEGV), make_number (ZV));
1161 pos_byte = CHAR_TO_BYTE (pos);
1162 c = FETCH_CHAR (pos_byte);
1163 if (! CHAR_VALID_P (c, 0))
1164 return Qnil;
1165 window = Fget_buffer_window (Fcurrent_buffer (), Qt);
1166 if (NILP (window))
1167 return Qnil;
1168 w = XWINDOW (window);
1169 f = XFRAME (w->frame);
1170 face_id = face_at_buffer_position (w, pos, -1, -1, &dummy, pos + 100, 0);
1171 face_id = FACE_FOR_CHAR (f, FACE_FROM_ID (f, face_id), c);
1172 face = FACE_FROM_ID (f, face_id);
1173 return (face->font && face->font_name
1174 ? build_string (face->font_name)
1175 : Qnil);
1179 /* Called from Ffontset_info via map_char_table on each leaf of
1180 fontset. ARG is a list (LAST FONT-INFO ...), where LAST is `(last
1181 ARG)' and FONT-INFOs have this form:
1182 (CHAR FONT-SPEC) or ((FROM . TO) FONT-SPEC)
1183 The current leaf is indexed by CHARACTER and has value ELT. This
1184 function add the information of the current leaf to ARG by
1185 appending a new element or modifying the last element.. */
1187 static void
1188 accumulate_font_info (arg, character, elt)
1189 Lisp_Object arg, character, elt;
1191 Lisp_Object last, last_char, last_elt, tmp;
1193 if (!CONSP (elt))
1194 return;
1195 last = XCAR (arg);
1196 last_char = XCAR (XCAR (last));
1197 last_elt = XCAR (XCDR (XCAR (last)));
1198 elt = XCDR (elt);
1199 if (!NILP (Fequal (elt, last_elt)))
1201 int this_charset = CHAR_CHARSET (XINT (character));
1203 if (CONSP (last_char)) /* LAST_CHAR == (FROM . TO) */
1205 if (this_charset == CHAR_CHARSET (XINT (XCAR (last_char))))
1207 XCDR (last_char) = character;
1208 return;
1211 else
1213 if (this_charset == CHAR_CHARSET (XINT (last_char)))
1215 XCAR (XCAR (last)) = Fcons (last_char, character);
1216 return;
1220 XCDR (last) = Fcons (Fcons (character, Fcons (elt, Qnil)), Qnil);
1221 XCAR (arg) = XCDR (last);
1225 DEFUN ("fontset-info", Ffontset_info, Sfontset_info, 1, 2, 0,
1226 "Return information about a fontset named NAME on frame FRAME.\n\
1227 The value is a list:\n\
1228 \(FONTSET-NAME (CHARSET-OR-RANGE FONT-SPEC OPENED ...) ...),\n\
1229 where,\n\
1230 FONTSET-NAME is a full name of the fontset.\n\
1231 CHARSET-OR-RANGE is a charset, a character (may be a generic character)\n\
1232 or a cons of two characters specifying the range of characters.\n\
1233 FONT-SPEC is a fontname pattern string or a cons (FAMILY . REGISTRY),\n\
1234 where FAMILY is a `FAMILY' field of a XLFD font name,\n\
1235 REGISTRY is a `CHARSET_REGISTRY' field of a XLDF font name.\n\
1236 FAMILY may contain a `FOUNDARY' field at the head.\n\
1237 REGISTRY may contain a `CHARSET_ENCODING' field at the tail.\n\
1238 OPENEDs are names of fonts actually opened.\n\
1239 If FRAME is omitted, it defaults to the currently selected frame.")
1240 (name, frame)
1241 Lisp_Object name, frame;
1243 Lisp_Object fontset;
1244 FRAME_PTR f;
1245 Lisp_Object indices[3];
1246 Lisp_Object val, tail, elt;
1247 Lisp_Object *realized;
1248 int n_realized = 0;
1249 int i;
1251 (*check_window_system_func) ();
1253 fontset = check_fontset_name (name);
1255 if (NILP (frame))
1256 frame = selected_frame;
1257 CHECK_LIVE_FRAME (frame, 1);
1258 f = XFRAME (frame);
1260 /* Recodeq realized fontsets whose base is FONTSET in the table
1261 `realized'. */
1262 realized = (Lisp_Object *) alloca (sizeof (Lisp_Object)
1263 * ASIZE (Vfontset_table));
1264 for (i = 0; i < ASIZE (Vfontset_table); i++)
1266 elt = FONTSET_FROM_ID (i);
1267 if (!NILP (elt)
1268 && EQ (FONTSET_BASE (elt), fontset))
1269 realized[n_realized++] = elt;
1272 /* Accumulate information of the fontset in VAL. The format is
1273 (LAST FONT-INFO FONT-INFO ...), where FONT-INFO is (CHAR-OR-RANGE
1274 FONT-SPEC). See the comment for accumulate_font_info for the
1275 detail. */
1276 val = Fcons (Fcons (make_number (0),
1277 Fcons (XCDR (FONTSET_ASCII (fontset)), Qnil)),
1278 Qnil);
1279 val = Fcons (val, val);
1280 map_char_table (accumulate_font_info, Qnil, fontset, val, 0, indices);
1281 val = XCDR (val);
1283 /* For each FONT-INFO, if CHAR_OR_RANGE (car part) is a generic
1284 character for a charset, replace it wiht the charset symbol. If
1285 fonts are opened for FONT-SPEC, append the names of the fonts to
1286 FONT-SPEC. */
1287 for (tail = val; CONSP (tail); tail = XCDR (tail))
1289 int c;
1290 elt = XCAR (tail);
1291 if (INTEGERP (XCAR (elt)))
1293 int charset, c1, c2;
1294 c = XINT (XCAR (elt));
1295 SPLIT_CHAR (c, charset, c1, c2);
1296 if (c1 == 0)
1297 XCAR (elt) = CHARSET_SYMBOL (charset);
1299 else
1300 c = XINT (XCAR (XCAR (elt)));
1301 for (i = 0; i < n_realized; i++)
1303 Lisp_Object face_id, font;
1304 struct face *face;
1306 face_id = FONTSET_REF_VIA_BASE (realized[i], c);
1307 if (INTEGERP (face_id))
1309 face = FACE_FROM_ID (f, XINT (face_id));
1310 if (face->font && face->font_name)
1312 font = build_string (face->font_name);
1313 if (NILP (Fmember (font, XCDR (XCDR (elt)))))
1314 XCDR (XCDR (elt)) = Fcons (font, XCDR (XCDR (elt)));
1319 return Fcons (FONTSET_NAME (fontset), val);
1322 DEFUN ("fontset-font", Ffontset_font, Sfontset_font, 2, 2, 0,
1323 "Return a font name pattern for character CH in fontset NAME.\n\
1324 If NAME is t, find a font name pattern in the default fontset.")
1325 (name, ch)
1326 Lisp_Object name, ch;
1328 int c, id;
1329 Lisp_Object fontset, elt;
1331 fontset = check_fontset_name (name);
1333 CHECK_NUMBER (ch, 1);
1334 c = XINT (ch);
1335 if (!char_valid_p (c, 1))
1336 invalid_character (c);
1338 elt = FONTSET_REF (fontset, c);
1339 if (CONSP (elt))
1340 elt = XCDR (elt);
1342 return elt;
1346 DEFUN ("fontset-list", Ffontset_list, Sfontset_list, 0, 0, 0,
1347 "Return a list of all defined fontset names.")
1350 Lisp_Object fontset, list;
1351 int i;
1353 list = Qnil;
1354 for (i = 0; i < ASIZE (Vfontset_table); i++)
1356 fontset = FONTSET_FROM_ID (i);
1357 if (!NILP (fontset)
1358 && BASE_FONTSET_P (fontset))
1359 list = Fcons (FONTSET_NAME (fontset), list);
1362 return list;
1365 void
1366 syms_of_fontset ()
1368 int i;
1370 if (!load_font_func)
1371 /* Window system initializer should have set proper functions. */
1372 abort ();
1374 Qfontset = intern ("fontset");
1375 staticpro (&Qfontset);
1376 Fput (Qfontset, Qchar_table_extra_slots, make_number (3));
1378 Vcached_fontset_data = Qnil;
1379 staticpro (&Vcached_fontset_data);
1381 Vfontset_table = Fmake_vector (make_number (32), Qnil);
1382 staticpro (&Vfontset_table);
1384 Vdefault_fontset = Fmake_char_table (Qfontset, Qnil);
1385 staticpro (&Vdefault_fontset);
1386 FONTSET_ID (Vdefault_fontset) = make_number (0);
1387 FONTSET_NAME (Vdefault_fontset)
1388 = build_string ("-*-*-*-*-*-*-*-*-*-*-*-*-fontset-default");
1389 FONTSET_ASCII (Vdefault_fontset)
1390 = Fcons (make_number (0),
1391 build_string ("-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1"));
1392 AREF (Vfontset_table, 0) = Vdefault_fontset;
1393 next_fontset_id = 1;
1395 DEFVAR_LISP ("font-encoding-alist", &Vfont_encoding_alist,
1396 "Alist of fontname patterns vs corresponding encoding info.\n\
1397 Each element looks like (REGEXP . ENCODING-INFO),\n\
1398 where ENCODING-INFO is an alist of CHARSET vs ENCODING.\n\
1399 ENCODING is one of the following integer values:\n\
1400 0: code points 0x20..0x7F or 0x2020..0x7F7F are used,\n\
1401 1: code points 0xA0..0xFF or 0xA0A0..0xFFFF are used,\n\
1402 2: code points 0x20A0..0x7FFF are used,\n\
1403 3: code points 0xA020..0xFF7F are used.");
1404 Vfont_encoding_alist = Qnil;
1406 DEFVAR_LISP ("use-default-ascent", &Vuse_default_ascent,
1407 "Char table of characters whose ascent values should be ignored.\n\
1408 If an entry for a character is non-nil, the ascent value of the glyph\n\
1409 is assumed to be what specified by _MULE_DEFAULT_ASCENT property of a font.\n\
1411 This affects how a composite character which contains\n\
1412 such a character is displayed on screen.");
1413 Vuse_default_ascent = Qnil;
1415 DEFVAR_LISP ("ignore-relative-composition", &Vignore_relative_composition,
1416 "Char table of characters which is not composed relatively.\n\
1417 If an entry for a character is non-nil, a composition sequence\n\
1418 which contains that character is displayed so that\n\
1419 the glyph of that character is put without considering\n\
1420 an ascent and descent value of a previous character.");
1421 Vignore_relative_composition = Qnil;
1423 DEFVAR_LISP ("alternate-fontname-alist", &Valternate_fontname_alist,
1424 "Alist of fontname vs list of the alternate fontnames.\n\
1425 When a specified font name is not found, the corresponding\n\
1426 alternate fontnames (if any) are tried instead.");
1427 Valternate_fontname_alist = Qnil;
1429 DEFVAR_LISP ("fontset-alias-alist", &Vfontset_alias_alist,
1430 "Alist of fontset names vs the aliases.");
1431 Vfontset_alias_alist = Fcons (Fcons (FONTSET_NAME (Vdefault_fontset),
1432 build_string ("fontset-default")),
1433 Qnil);
1435 DEFVAR_LISP ("highlight-wrong-size-font", &Vhighlight_wrong_size_font,
1436 "*Non-nil means highlight characters shown in wrong size fonts somehow.\n\
1437 The way to highlight them depends on window system on which Emacs runs.\n\
1438 On X11, a rectangle is shown around each such character.");
1439 Vhighlight_wrong_size_font = Qnil;
1441 DEFVAR_LISP ("clip-large-size-font", &Vclip_large_size_font,
1442 "*Non-nil means characters shown in overlarge fonts are clipped.\n\
1443 The height of clipping area is the same as that of an ASCII character.\n\
1444 The width of the area is the same as that of an ASCII character,\n\
1445 or twice as wide, depending on the character set's column-width.\n\
1447 If the only font you have for a specific character set is too large,\n\
1448 and clipping these characters makes them hard to read,\n\
1449 you can set this variable to nil to display the characters without clipping.\n\
1450 The drawback is that you will get some garbage left on your screen.");
1451 Vclip_large_size_font = Qt;
1453 DEFVAR_LISP ("vertical-centering-font-regexp",
1454 &Vvertical_centering_font_regexp,
1455 "*Regexp matching font names that require vertical centering on display.\n\
1456 When a character is displayed with such fonts, the character is displayed\n\
1457 at the vertival center of lines.");
1458 Vvertical_centering_font_regexp = Qnil;
1460 defsubr (&Squery_fontset);
1461 defsubr (&Snew_fontset);
1462 defsubr (&Sset_fontset_font);
1463 defsubr (&Sfont_info);
1464 defsubr (&Sinternal_char_font);
1465 defsubr (&Sfontset_info);
1466 defsubr (&Sfontset_font);
1467 defsubr (&Sfontset_list);