Add font logging to list and match functions.
[emacs.git] / src / fontset.c
blobe81f6e16c76cd0e904eb4d2b238078e86cd2ce07
1 /* Fontset handler.
2 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
3 Free Software Foundation, Inc.
4 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
5 2005, 2006, 2007, 2008
6 National Institute of Advanced Industrial Science and Technology (AIST)
7 Registration Number H14PRO021
8 Copyright (C) 2003, 2006
9 National Institute of Advanced Industrial Science and Technology (AIST)
10 Registration Number H13PRO009
12 This file is part of GNU Emacs.
14 GNU Emacs is free software: you can redistribute it and/or modify
15 it under the terms of the GNU General Public License as published by
16 the Free Software Foundation, either version 3 of the License, or
17 (at your option) any later version.
19 GNU Emacs is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 GNU General Public License for more details.
24 You should have received a copy of the GNU General Public License
25 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
27 /* #define FONTSET_DEBUG */
29 #include <config.h>
31 #ifdef FONTSET_DEBUG
32 #include <stdio.h>
33 #endif
35 #include "lisp.h"
36 #include "blockinput.h"
37 #include "buffer.h"
38 #include "character.h"
39 #include "charset.h"
40 #include "ccl.h"
41 #include "keyboard.h"
42 #include "frame.h"
43 #include "dispextern.h"
44 #include "intervals.h"
45 #include "fontset.h"
46 #include "window.h"
47 #ifdef HAVE_X_WINDOWS
48 #include "xterm.h"
49 #endif
50 #ifdef WINDOWSNT
51 #include "w32term.h"
52 #endif
53 #ifdef MAC_OS
54 #include "macterm.h"
55 #endif
56 #include "termhooks.h"
58 #include "font.h"
60 #undef xassert
61 #ifdef FONTSET_DEBUG
62 #define xassert(X) do {if (!(X)) abort ();} while (0)
63 #undef INLINE
64 #define INLINE
65 #else /* not FONTSET_DEBUG */
66 #define xassert(X) (void) 0
67 #endif /* not FONTSET_DEBUG */
69 EXFUN (Fclear_face_cache, 1);
71 /* FONTSET
73 A fontset is a collection of font related information to give
74 similar appearance (style, etc) of characters. A fontset has two
75 roles. One is to use for the frame parameter `font' as if it is an
76 ASCII font. In that case, Emacs uses the font specified for
77 `ascii' script for the frame's default font.
79 Another role, the more important one, is to provide information
80 about which font to use for each non-ASCII character.
82 There are two kinds of fontsets; base and realized. A base fontset
83 is created by `new-fontset' from Emacs Lisp explicitly. A realized
84 fontset is created implicitly when a face is realized for ASCII
85 characters. A face is also realized for non-ASCII characters based
86 on an ASCII face. All of non-ASCII faces based on the same ASCII
87 face share the same realized fontset.
89 A fontset object is implemented by a char-table whose default value
90 and parent are always nil.
92 An element of a base fontset is a vector of FONT-DEFs which itself
93 is a vector [ FONT-SPEC ENCODING REPERTORY ].
95 An element of a realized fontset is nil, t, or a vector of this form:
97 [ CHARSET-ORDERED-LIST-TICK PREFERRED-RFONT-DEF
98 RFONT-DEF0 RFONT-DEF1 ... ]
100 RFONT-DEFn (i.e. Realized FONT-DEF) has this form:
102 [ FACE-ID FONT-DEF FONT-OBJECT SORTING-SCORE ]
104 RFONT-DEFn are automatically reordered by the current charset
105 priority list.
107 The value nil means that we have not yet generated the above vector
108 from the base of the fontset.
110 The value t means that no font is available for the corresponding
111 range of characters.
114 A fontset has 9 extra slots.
116 The 1st slot: the ID number of the fontset
118 The 2nd slot:
119 base: the name of the fontset
120 realized: nil
122 The 3rd slot:
123 base: nil
124 realized: the base fontset
126 The 4th slot:
127 base: nil
128 realized: the frame that the fontset belongs to
130 The 5th slot:
131 base: the font name for ASCII characters
132 realized: nil
134 The 6th slot:
135 base: nil
136 realized: the ID number of a face to use for characters that
137 has no font in a realized fontset.
139 The 7th slot:
140 base: nil
141 realized: Alist of font index vs the corresponding repertory
142 char-table.
144 The 8th slot:
145 base: nil
146 realized: If the base is not the default fontset, a fontset
147 realized from the default fontset, else nil.
149 The 9th slot:
150 base: Same as element value (but for fallback fonts).
151 realized: Likewise.
153 All fontsets are recorded in the vector Vfontset_table.
156 DEFAULT FONTSET
158 There's a special base fontset named `default fontset' which
159 defines the default font specifications. When a base fontset
160 doesn't specify a font for a specific character, the corresponding
161 value in the default fontset is used.
163 The parent of a realized fontset created for such a face that has
164 no fontset is the default fontset.
167 These structures are hidden from the other codes than this file.
168 The other codes handle fontsets only by their ID numbers. They
169 usually use the variable name `fontset' for IDs. But, in this
170 file, we always use varialbe name `id' for IDs, and name `fontset'
171 for an actual fontset object, i.e., char-table.
175 /********** VARIABLES and FUNCTION PROTOTYPES **********/
177 extern Lisp_Object Qfont;
178 static Lisp_Object Qfontset;
179 static Lisp_Object Qfontset_info;
180 static Lisp_Object Qprepend, Qappend;
181 static Lisp_Object Qlatin;
183 /* Vector containing all fontsets. */
184 static Lisp_Object Vfontset_table;
186 /* Next possibly free fontset ID. Usually this keeps the minimum
187 fontset ID not yet used. */
188 static int next_fontset_id;
190 /* The default fontset. This gives default FAMILY and REGISTRY of
191 font for each character. */
192 static Lisp_Object Vdefault_fontset;
194 Lisp_Object Vfont_encoding_charset_alist;
195 Lisp_Object Vuse_default_ascent;
196 Lisp_Object Vignore_relative_composition;
197 Lisp_Object Valternate_fontname_alist;
198 Lisp_Object Vfontset_alias_alist;
199 Lisp_Object Vvertical_centering_font_regexp;
200 Lisp_Object Votf_script_alist;
202 /* Check if any window system is used now. */
203 void (*check_window_system_func) P_ ((void));
206 /* Prototype declarations for static functions. */
207 static Lisp_Object fontset_add P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
208 Lisp_Object));
209 static Lisp_Object fontset_find_font P_ ((Lisp_Object, int, struct face *,
210 int, int));
211 static void reorder_font_vector P_ ((Lisp_Object, Lisp_Object));
212 static Lisp_Object fontset_font P_ ((Lisp_Object, int, struct face *, int));
213 static Lisp_Object make_fontset P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
214 static Lisp_Object fontset_pattern_regexp P_ ((Lisp_Object));
215 static void accumulate_script_ranges P_ ((Lisp_Object, Lisp_Object,
216 Lisp_Object));
217 Lisp_Object find_font_encoding P_ ((Lisp_Object));
219 static void set_fontset_font P_ ((Lisp_Object, Lisp_Object));
221 #ifdef FONTSET_DEBUG
223 /* Return 1 if ID is a valid fontset id, else return 0. */
225 static int
226 fontset_id_valid_p (id)
227 int id;
229 return (id >= 0 && id < ASIZE (Vfontset_table) - 1);
232 #endif
236 /********** MACROS AND FUNCTIONS TO HANDLE FONTSET **********/
238 /* Return the fontset with ID. No check of ID's validness. */
239 #define FONTSET_FROM_ID(id) AREF (Vfontset_table, id)
241 /* Macros to access special values of FONTSET. */
242 #define FONTSET_ID(fontset) XCHAR_TABLE (fontset)->extras[0]
244 /* Macros to access special values of (base) FONTSET. */
245 #define FONTSET_NAME(fontset) XCHAR_TABLE (fontset)->extras[1]
246 #define FONTSET_ASCII(fontset) XCHAR_TABLE (fontset)->extras[4]
247 #define FONTSET_SPEC(fontset) XCHAR_TABLE (fontset)->extras[5]
249 /* Macros to access special values of (realized) FONTSET. */
250 #define FONTSET_BASE(fontset) XCHAR_TABLE (fontset)->extras[2]
251 #define FONTSET_FRAME(fontset) XCHAR_TABLE (fontset)->extras[3]
252 #define FONTSET_OBJLIST(fontset) XCHAR_TABLE (fontset)->extras[4]
253 #define FONTSET_NOFONT_FACE(fontset) XCHAR_TABLE (fontset)->extras[5]
254 #define FONTSET_REPERTORY(fontset) XCHAR_TABLE (fontset)->extras[6]
255 #define FONTSET_DEFAULT(fontset) XCHAR_TABLE (fontset)->extras[7]
257 /* For both base and realized fontset. */
258 #define FONTSET_FALLBACK(fontset) XCHAR_TABLE (fontset)->extras[8]
260 #define BASE_FONTSET_P(fontset) (NILP (FONTSET_BASE (fontset)))
263 /* Macros for FONT-DEF and RFONT-DEF of fontset. */
264 #define FONT_DEF_NEW(font_def, font_spec, encoding, repertory) \
265 do { \
266 (font_def) = Fmake_vector (make_number (3), (font_spec)); \
267 ASET ((font_def), 1, encoding); \
268 ASET ((font_def), 2, repertory); \
269 } while (0)
271 #define FONT_DEF_SPEC(font_def) AREF (font_def, 0)
272 #define FONT_DEF_ENCODING(font_def) AREF (font_def, 1)
273 #define FONT_DEF_REPERTORY(font_def) AREF (font_def, 2)
275 #define RFONT_DEF_FACE(rfont_def) AREF (rfont_def, 0)
276 #define RFONT_DEF_SET_FACE(rfont_def, face_id) \
277 ASET ((rfont_def), 0, make_number (face_id))
278 #define RFONT_DEF_FONT_DEF(rfont_def) AREF (rfont_def, 1)
279 #define RFONT_DEF_SPEC(rfont_def) FONT_DEF_SPEC (AREF (rfont_def, 1))
280 #define RFONT_DEF_REPERTORY(rfont_def) FONT_DEF_REPERTORY (AREF (rfont_def, 1))
281 #define RFONT_DEF_OBJECT(rfont_def) AREF (rfont_def, 2)
282 #define RFONT_DEF_SET_OBJECT(rfont_def, object) \
283 ASET ((rfont_def), 2, (object))
284 #define RFONT_DEF_SCORE(rfont_def) XINT (AREF (rfont_def, 3))
285 #define RFONT_DEF_SET_SCORE(rfont_def, score) \
286 ASET ((rfont_def), 3, make_number (score))
287 #define RFONT_DEF_NEW(rfont_def, font_def) \
288 do { \
289 (rfont_def) = Fmake_vector (make_number (4), Qnil); \
290 ASET ((rfont_def), 1, (font_def)); \
291 RFONT_DEF_SET_SCORE ((rfont_def), 0); \
292 } while (0)
295 /* Return the element of FONTSET for the character C. If FONTSET is a
296 base fontset other then the default fontset and FONTSET doesn't
297 contain information for C, return the information in the default
298 fontset. */
300 #define FONTSET_REF(fontset, c) \
301 (EQ (fontset, Vdefault_fontset) \
302 ? CHAR_TABLE_REF (fontset, c) \
303 : fontset_ref ((fontset), (c)))
305 static Lisp_Object
306 fontset_ref (fontset, c)
307 Lisp_Object fontset;
308 int c;
310 Lisp_Object elt;
312 elt = CHAR_TABLE_REF (fontset, c);
313 if (NILP (elt) && ! EQ (fontset, Vdefault_fontset)
314 /* Don't check Vdefault_fontset for a realized fontset. */
315 && NILP (FONTSET_BASE (fontset)))
316 elt = CHAR_TABLE_REF (Vdefault_fontset, c);
317 return elt;
320 /* Set elements of FONTSET for characters in RANGE to the value ELT.
321 RANGE is a cons (FROM . TO), where FROM and TO are character codes
322 specifying a range. */
324 #define FONTSET_SET(fontset, range, elt) \
325 Fset_char_table_range ((fontset), (range), (elt))
328 /* Modify the elements of FONTSET for characters in RANGE by replacing
329 with ELT or adding ELT. RANGE is a cons (FROM . TO), where FROM
330 and TO are character codes specifying a range. If ADD is nil,
331 replace with ELT, if ADD is `prepend', prepend ELT, otherwise,
332 append ELT. */
334 #define FONTSET_ADD(fontset, range, elt, add) \
335 (NILP (add) \
336 ? (NILP (range) \
337 ? (FONTSET_FALLBACK (fontset) = Fmake_vector (make_number (1), (elt))) \
338 : Fset_char_table_range ((fontset), (range), \
339 Fmake_vector (make_number (1), (elt)))) \
340 : fontset_add ((fontset), (range), (elt), (add)))
342 static Lisp_Object
343 fontset_add (fontset, range, elt, add)
344 Lisp_Object fontset, range, elt, add;
346 Lisp_Object args[2];
347 int idx = (EQ (add, Qappend) ? 0 : 1);
349 args[1 - idx] = Fmake_vector (make_number (1), elt);
351 if (CONSP (range))
353 int from = XINT (XCAR (range));
354 int to = XINT (XCDR (range));
355 int from1, to1;
357 do {
358 args[idx] = char_table_ref_and_range (fontset, from, &from1, &to1);
359 if (to < to1)
360 to1 = to;
361 char_table_set_range (fontset, from, to1,
362 NILP (args[idx]) ? args[1 - idx]
363 : Fvconcat (2, args));
364 from = to1 + 1;
365 } while (from < to);
367 else
369 args[idx] = FONTSET_FALLBACK (fontset);
370 FONTSET_FALLBACK (fontset)
371 = NILP (args[idx]) ? args[1 - idx] : Fvconcat (2, args);
373 return Qnil;
376 static int
377 fontset_compare_rfontdef (val1, val2)
378 const void *val1, *val2;
380 return (RFONT_DEF_SCORE (*(Lisp_Object *) val2)
381 - RFONT_DEF_SCORE (*(Lisp_Object *) val1));
384 /* Update FONT-GROUP which has this form:
385 [ CHARSET-ORDERED-LIST-TICK PREFERRED-RFONT-DEF
386 RFONT-DEF0 RFONT-DEF1 ... ]
387 Reorder RFONT-DEFs according to the current language, and update
388 CHARSET-ORDERED-LIST-TICK.
390 If PREFERRED_FAMILY is not nil, that family has the higher priority
391 if the encoding charsets or languages in font-specs are the same. */
393 extern Lisp_Object Fassoc_string ();
395 static void
396 reorder_font_vector (font_group, preferred_family)
397 Lisp_Object font_group;
398 Lisp_Object preferred_family;
400 int size;
401 int i;
402 int score_changed = 0;
404 size = ASIZE (font_group);
405 /* Exclude the tailing nil elements from the reordering. */
406 while (NILP (AREF (font_group, size - 1))) size--;
407 size -= 2;
409 for (i = 0; i < size; i++)
411 Lisp_Object rfont_def = AREF (font_group, i + 2);
412 Lisp_Object font_def = RFONT_DEF_FONT_DEF (rfont_def);
413 Lisp_Object font_spec = FONT_DEF_SPEC (font_def);
414 Lisp_Object lang = Ffont_get (font_spec, QClang);
415 Lisp_Object family = AREF (font_spec, FONT_FAMILY_INDEX);
416 Lisp_Object repertory = FONT_DEF_REPERTORY (font_def);
417 int score = 0;
419 if (! NILP (repertory))
421 Lisp_Object tail;
423 for (score = 0xFFFF, tail = Vcharset_ordered_list;
424 ! EQ (tail, Vcharset_non_preferred_head) && CONSP (tail);
425 score--, tail = XCDR (tail))
426 if (EQ (repertory, XCAR (tail)))
427 break;
428 if (EQ (tail, Vcharset_non_preferred_head))
429 score = 0;
431 else if (! NILP (lang))
433 if (EQ (lang, Vcurrent_iso639_language))
434 score = 0xFFFF;
435 else if (CONSP (Vcurrent_iso639_language))
436 score = ! NILP (Fmemq (lang, Vcurrent_iso639_language));
439 if (! NILP (preferred_family) && ! NILP (family))
441 if (fast_string_match_ignore_case (preferred_family,
442 SYMBOL_NAME (family)) < 0)
443 score |= 0x10000;
445 if (RFONT_DEF_SCORE (rfont_def) != score)
447 RFONT_DEF_SET_SCORE (rfont_def, score);
448 score_changed = 1;
452 if (score_changed)
453 qsort (XVECTOR (font_group)->contents + 2, size, sizeof (Lisp_Object),
454 fontset_compare_rfontdef);
456 ASET (font_group, 0, make_number (charset_ordered_list_tick));
459 /* Return RFONT-DEF (vector) in the realized fontset FONTSET for the
460 character C. If no font is found, return Qnil if there's a
461 possibility that the default fontset or the fallback font groups
462 have a proper font, and return Qt if not.
464 If a font is found but is not yet opened, open it (if FACE is not
465 NULL) or return Qnil (if FACE is NULL).
467 ID is a charset-id that must be preferred, or -1 meaning no
468 preference.
470 If FALLBACK is nonzero, search only fallback fonts. */
472 static Lisp_Object
473 fontset_find_font (fontset, c, face, id, fallback)
474 Lisp_Object fontset;
475 int c;
476 struct face *face;
477 int id, fallback;
479 Lisp_Object base_fontset, elt, vec;
480 int i, from, to;
481 FRAME_PTR f = XFRAME (FONTSET_FRAME (fontset));
483 base_fontset = FONTSET_BASE (fontset);
484 if (! fallback)
485 vec = CHAR_TABLE_REF (fontset, c);
486 else
487 vec = FONTSET_FALLBACK (fontset);
489 if (NILP (vec))
491 Lisp_Object range;
493 /* We have not yet decided a font for C. */
494 if (! face)
495 return Qnil;
496 if (! fallback)
498 elt = char_table_ref_and_range (base_fontset, c, &from, &to);
499 range = Fcons (make_number (from), make_number (to));
501 else
503 elt = FONTSET_FALLBACK (base_fontset);
505 if (NILP (elt))
507 /* This fontset doesn't specify any font for C. */
508 vec = make_number (0);
510 else if (ASIZE (elt) == 1 && NILP (AREF (elt, 0)))
512 /* Explicitly specified no font. */
513 vec = Qt;
515 else
517 /* Build a font-group vector [ -1 nil RFONT-DEF0 RFONT-DEF1 ... ],
518 where the first -1 is to force reordering of RFONT-DEFs. */
519 int size = ASIZE (elt);
520 int j;
522 vec = Fmake_vector (make_number (size + 2), Qnil);
523 ASET (vec, 0, make_number (-1));
524 for (i = j = 0; i < size; i++)
525 if (! NILP (AREF (elt, i)))
527 Lisp_Object rfont_def;
529 RFONT_DEF_NEW (rfont_def, AREF (elt, i));
530 ASET (vec, j + 2, rfont_def);
531 j++;
534 /* Then store it in the fontset. */
535 if (! fallback)
536 FONTSET_SET (fontset, range, vec);
537 else
538 FONTSET_FALLBACK (fontset) = vec;
541 if (! VECTORP (vec))
542 return (EQ (vec, Qt) ? Qt : Qnil);
544 if (ASIZE (vec) > 4 /* multiple RFONT-DEFs */
545 && XINT (AREF (vec, 0)) != charset_ordered_list_tick)
546 /* We have just created VEC,
547 or the charset priorities were changed. */
548 reorder_font_vector (vec, face->lface[LFACE_FAMILY_INDEX]);
549 i = 2;
550 if (id >= 0)
552 elt = AREF (vec, 1);
553 if (! NILP (elt)
554 && EQ (make_number (id), RFONT_DEF_REPERTORY (elt)))
555 i = 1;
556 else
558 for (; i < ASIZE (vec); i++)
560 elt = AREF (vec, i);
561 if (! NILP (elt)
562 && EQ (make_number (id), RFONT_DEF_REPERTORY (elt)))
563 break;
565 if (i < ASIZE (vec))
567 ASET (vec, 1, elt);
568 i = 1;
570 else
572 ASET (vec, 1, Qnil);
573 i = 2;
578 /* Find the first available font in the vector of RFONT-DEF. */
579 for (; i < ASIZE (vec); i++)
581 Lisp_Object font_entity, font_object;
583 elt = AREF (vec, i);
584 if (NILP (elt))
585 /* This is the sign of not to try fallback fonts. */
586 return Qt;
587 if (id >= 0 && i > 1 && EQ (AREF (vec, 1), elt))
588 /* This is already checked. */
589 continue;
590 if (INTEGERP (RFONT_DEF_FACE (elt))
591 && XINT (AREF (elt, 1)) < 0)
592 /* We couldn't open this font last time. */
593 continue;
595 font_object = RFONT_DEF_OBJECT (elt);
596 if (NILP (font_object))
598 Lisp_Object font_def = RFONT_DEF_FONT_DEF (elt);
600 if (! face)
601 /* We have not yet opened the font. */
602 return Qnil;
603 font_entity = font_find_for_lface (f, face->lface,
604 FONT_DEF_SPEC (font_def), -1);
605 if (NILP (font_entity))
607 /* Record that no font matches the spec. */
608 RFONT_DEF_SET_FACE (elt, -1);
609 continue;
611 font_object = font_open_for_lface (f, font_entity, face->lface,
612 FONT_DEF_SPEC (font_def));
613 if (NILP (font_object))
615 /* Record that the font is unsable. */
616 RFONT_DEF_SET_FACE (elt, -1);
617 continue;
619 RFONT_DEF_SET_OBJECT (elt, font_object);
622 if (font_has_char (f, font_object, c))
623 return elt;
625 #if 0
626 /* The following code makes Emacs to find a font for C by fairly
627 exhausitive search. But, that takes long time especially for
628 X font backend. */
630 /* Try to find the different font maching with the current spec
631 and support C. */
632 font_def = RFONT_DEF_FONT_DEF (elt);
633 for (i++; i < ASIZE (vec); i++)
635 if (! EQ (RFONT_DEF_FONT_DEF (AREF (vec, i)), font_def))
636 break;
637 if (font_has_char (f, RFONT_DEF_OBJECT (AREF (vec, i)), c))
638 return AREF (vec, i);
640 /* Find an font-entity that support C. */
641 font_entity = font_find_for_lface (f, face->lface,
642 FONT_DEF_SPEC (font_def), c);
643 if (! NILP (font_entity))
645 Lisp_Object rfont_def, new_vec;
646 int j;
648 font_object = font_open_for_lface (f, font_entity, face->lface,
649 Qnil);
650 RFONT_DEF_NEW (rfont_def, font_def);
651 RFONT_DEF_SET_OBJECT (rfont_def, font_object);
652 RFONT_DEF_SET_SCORE (rfont_def, RFONT_DEF_SCORE (elt));
653 new_vec = Fmake_vector (make_number (ASIZE (vec) + 1), Qnil);
654 for (j = 0; j < i; j++)
655 ASET (new_vec, j, AREF (vec, j));
656 ASET (new_vec, j, rfont_def);
657 for (j++; j < ASIZE (new_vec); j++)
658 ASET (new_vec, j, AREF (vec, j - 1));
659 vec = new_vec;
660 return rfont_def;
662 i--;
663 #endif /* 0 */
666 FONTSET_SET (fontset, make_number (c), make_number (0));
667 return Qnil;
671 static Lisp_Object
672 fontset_font (fontset, c, face, id)
673 Lisp_Object fontset;
674 int c;
675 struct face *face;
676 int id;
678 Lisp_Object rfont_def;
679 Lisp_Object base_fontset;
681 /* Try a font-group for C. */
682 rfont_def = fontset_find_font (fontset, c, face, id, 0);
683 if (VECTORP (rfont_def))
684 return rfont_def;
685 if (EQ (rfont_def, Qt))
686 return Qnil;
687 /* Try a fallback font-group. */
688 rfont_def = fontset_find_font (fontset, c, face, id, 1);
689 if (VECTORP (rfont_def))
690 return rfont_def;
691 if (EQ (rfont_def, Qt))
692 return Qnil;
694 base_fontset = FONTSET_BASE (fontset);
695 if (EQ (base_fontset, Vdefault_fontset))
696 return Qnil;
698 /* Try a font-group for C of the default fontset. */
699 if (NILP (FONTSET_DEFAULT (fontset)))
700 FONTSET_DEFAULT (fontset)
701 = make_fontset (FONTSET_FRAME (fontset), Qnil, Vdefault_fontset);
702 rfont_def = fontset_find_font (FONTSET_DEFAULT (fontset), c, face, id, 0);
703 if (VECTORP (rfont_def))
704 return rfont_def;
705 /* Try a fallback font-group of the default fontset . */
706 rfont_def = fontset_find_font (FONTSET_DEFAULT (fontset), c, face, id, 1);
707 if (! VECTORP (rfont_def))
708 /* Remeber that we have no font for C. */
709 FONTSET_SET (fontset, make_number (c), Qt);
711 return rfont_def;
714 /* Return a newly created fontset with NAME. If BASE is nil, make a
715 base fontset. Otherwise make a realized fontset whose base is
716 BASE. */
718 static Lisp_Object
719 make_fontset (frame, name, base)
720 Lisp_Object frame, name, base;
722 Lisp_Object fontset;
723 int size = ASIZE (Vfontset_table);
724 int id = next_fontset_id;
726 /* Find a free slot in Vfontset_table. Usually, next_fontset_id is
727 the next available fontset ID. So it is expected that this loop
728 terminates quickly. In addition, as the last element of
729 Vfontset_table is always nil, we don't have to check the range of
730 id. */
731 while (!NILP (AREF (Vfontset_table, id))) id++;
733 if (id + 1 == size)
734 Vfontset_table = larger_vector (Vfontset_table, size + 32, Qnil);
736 fontset = Fmake_char_table (Qfontset, Qnil);
738 FONTSET_ID (fontset) = make_number (id);
739 if (NILP (base))
741 FONTSET_NAME (fontset) = name;
743 else
745 FONTSET_NAME (fontset) = Qnil;
746 FONTSET_FRAME (fontset) = frame;
747 FONTSET_BASE (fontset) = base;
750 ASET (Vfontset_table, id, fontset);
751 next_fontset_id = id + 1;
752 return fontset;
756 /* Set the ASCII font of the default fontset to FONTNAME if that is
757 not yet set. */
758 void
759 set_default_ascii_font (fontname)
760 Lisp_Object fontname;
762 if (! STRINGP (FONTSET_ASCII (Vdefault_fontset)))
764 int id = fs_query_fontset (fontname, 2);
766 if (id >= 0)
767 fontname = FONTSET_ASCII (FONTSET_FROM_ID (id));
768 FONTSET_ASCII (Vdefault_fontset)= fontname;
773 /********** INTERFACES TO xfaces.c, xfns.c, and dispextern.h **********/
775 /* Return the name of the fontset who has ID. */
777 Lisp_Object
778 fontset_name (id)
779 int id;
781 Lisp_Object fontset;
783 fontset = FONTSET_FROM_ID (id);
784 return FONTSET_NAME (fontset);
788 /* Return the ASCII font name of the fontset who has ID. */
790 Lisp_Object
791 fontset_ascii (id)
792 int id;
794 Lisp_Object fontset, elt;
796 fontset= FONTSET_FROM_ID (id);
797 elt = FONTSET_ASCII (fontset);
798 if (CONSP (elt))
799 elt = XCAR (elt);
800 return elt;
803 void
804 free_realized_fontset (f, fontset)
805 FRAME_PTR f;
806 Lisp_Object fontset;
808 Lisp_Object tail;
810 return;
811 for (tail = FONTSET_OBJLIST (fontset); CONSP (tail); tail = XCDR (tail))
813 xassert (FONT_OBJECT_P (XCAR (tail)));
814 font_close_object (f, XCAR (tail));
818 /* Free fontset of FACE defined on frame F. Called from
819 free_realized_face. */
821 void
822 free_face_fontset (f, face)
823 FRAME_PTR f;
824 struct face *face;
826 Lisp_Object fontset;
828 fontset = FONTSET_FROM_ID (face->fontset);
829 if (NILP (fontset))
830 return;
831 xassert (! BASE_FONTSET_P (fontset));
832 xassert (f == XFRAME (FONTSET_FRAME (fontset)));
833 free_realized_fontset (f, fontset);
834 ASET (Vfontset_table, face->fontset, Qnil);
835 if (face->fontset < next_fontset_id)
836 next_fontset_id = face->fontset;
837 if (! NILP (FONTSET_DEFAULT (fontset)))
839 int id = XINT (FONTSET_ID (FONTSET_DEFAULT (fontset)));
841 fontset = AREF (Vfontset_table, id);
842 xassert (!NILP (fontset) && ! BASE_FONTSET_P (fontset));
843 xassert (f == XFRAME (FONTSET_FRAME (fontset)));
844 free_realized_fontset (f, fontset);
845 ASET (Vfontset_table, id, Qnil);
846 if (id < next_fontset_id)
847 next_fontset_id = face->fontset;
849 face->fontset = -1;
853 /* Return 1 if FACE is suitable for displaying character C.
854 Otherwise return 0. Called from the macro FACE_SUITABLE_FOR_CHAR_P
855 when C is not an ASCII character. */
858 face_suitable_for_char_p (face, c)
859 struct face *face;
860 int c;
862 Lisp_Object fontset, rfont_def;
864 fontset = FONTSET_FROM_ID (face->fontset);
865 rfont_def = fontset_font (fontset, c, NULL, -1);
866 return (VECTORP (rfont_def)
867 && INTEGERP (RFONT_DEF_FACE (rfont_def))
868 && face->id == XINT (RFONT_DEF_FACE (rfont_def)));
872 /* Return ID of face suitable for displaying character C on frame F.
873 FACE must be reazlied for ASCII characters in advance. Called from
874 the macro FACE_FOR_CHAR. */
877 face_for_char (f, face, c, pos, object)
878 FRAME_PTR f;
879 struct face *face;
880 int c, pos;
881 Lisp_Object object;
883 Lisp_Object fontset, rfont_def;
884 int face_id;
885 int id;
887 if (ASCII_CHAR_P (c))
888 return face->ascii_face->id;
890 xassert (fontset_id_valid_p (face->fontset));
891 fontset = FONTSET_FROM_ID (face->fontset);
892 xassert (!BASE_FONTSET_P (fontset));
893 if (pos < 0)
894 id = -1;
895 else
897 Lisp_Object charset;
899 charset = Fget_char_property (make_number (pos), Qcharset, object);
900 if (NILP (charset))
901 id = -1;
902 else if (CHARSETP (charset))
904 Lisp_Object val;
906 val = assoc_no_quit (charset, Vfont_encoding_charset_alist);
907 if (CONSP (val) && CHARSETP (XCDR (val)))
908 charset = XCDR (val);
909 id = XINT (CHARSET_SYMBOL_ID (charset));
912 if (id < 0)
914 struct font *font = face->ascii_face->font;
916 if (font && font->driver->encode_char (font, c) != FONT_INVALID_CODE)
917 return face->ascii_face->id;
918 font = face->font;
919 if (font && font->driver->encode_char (font, c) != FONT_INVALID_CODE)
920 return face->id;
923 rfont_def = fontset_font (fontset, c, face, id);
924 if (VECTORP (rfont_def))
926 if (INTEGERP (RFONT_DEF_FACE (rfont_def)))
927 face_id = XINT (RFONT_DEF_FACE (rfont_def));
928 else
930 Lisp_Object font_object;
932 font_object = RFONT_DEF_OBJECT (rfont_def);
933 face_id = face_for_font (f, font_object, face);
934 RFONT_DEF_SET_FACE (rfont_def, face_id);
937 else
939 if (INTEGERP (FONTSET_NOFONT_FACE (fontset)))
940 face_id = XINT (FONTSET_NOFONT_FACE (fontset));
941 else
943 face_id = face_for_font (f, Qnil, face);
944 FONTSET_NOFONT_FACE (fontset) = make_number (face_id);
947 xassert (face_id >= 0);
948 return face_id;
952 /* Make a realized fontset for ASCII face FACE on frame F from the
953 base fontset BASE_FONTSET_ID. If BASE_FONTSET_ID is -1, use the
954 default fontset as the base. Value is the id of the new fontset.
955 Called from realize_x_face. */
958 make_fontset_for_ascii_face (f, base_fontset_id, face)
959 FRAME_PTR f;
960 int base_fontset_id;
961 struct face *face;
963 Lisp_Object base_fontset, fontset, frame;
965 XSETFRAME (frame, f);
966 if (base_fontset_id >= 0)
968 base_fontset = FONTSET_FROM_ID (base_fontset_id);
969 if (!BASE_FONTSET_P (base_fontset))
970 base_fontset = FONTSET_BASE (base_fontset);
971 if (! BASE_FONTSET_P (base_fontset))
972 abort ();
974 else
975 base_fontset = Vdefault_fontset;
977 fontset = make_fontset (frame, Qnil, base_fontset);
978 return XINT (FONTSET_ID (fontset));
983 /* Cache data used by fontset_pattern_regexp. The car part is a
984 pattern string containing at least one wild card, the cdr part is
985 the corresponding regular expression. */
986 static Lisp_Object Vcached_fontset_data;
988 #define CACHED_FONTSET_NAME ((char *) SDATA (XCAR (Vcached_fontset_data)))
989 #define CACHED_FONTSET_REGEX (XCDR (Vcached_fontset_data))
991 /* If fontset name PATTERN contains any wild card, return regular
992 expression corresponding to PATTERN. */
994 static Lisp_Object
995 fontset_pattern_regexp (pattern)
996 Lisp_Object pattern;
998 if (!index ((char *) SDATA (pattern), '*')
999 && !index ((char *) SDATA (pattern), '?'))
1000 /* PATTERN does not contain any wild cards. */
1001 return Qnil;
1003 if (!CONSP (Vcached_fontset_data)
1004 || strcmp ((char *) SDATA (pattern), CACHED_FONTSET_NAME))
1006 /* We must at first update the cached data. */
1007 unsigned char *regex, *p0, *p1;
1008 int ndashes = 0, nstars = 0, nescs = 0;
1010 for (p0 = SDATA (pattern); *p0; p0++)
1012 if (*p0 == '-')
1013 ndashes++;
1014 else if (*p0 == '*')
1015 nstars++;
1016 else if (*p0 == '['
1017 || *p0 == '.' || *p0 == '\\'
1018 || *p0 == '+' || *p0 == '^'
1019 || *p0 == '$')
1020 nescs++;
1023 /* If PATTERN is not full XLFD we conert "*" to ".*". Otherwise
1024 we convert "*" to "[^-]*" which is much faster in regular
1025 expression matching. */
1026 if (ndashes < 14)
1027 p1 = regex = (unsigned char *) alloca (SBYTES (pattern) + 2 * nstars + 2 * nescs + 1);
1028 else
1029 p1 = regex = (unsigned char *) alloca (SBYTES (pattern) + 5 * nstars + 2 * nescs + 1);
1031 *p1++ = '^';
1032 for (p0 = SDATA (pattern); *p0; p0++)
1034 if (*p0 == '*')
1036 if (ndashes < 14)
1037 *p1++ = '.';
1038 else
1039 *p1++ = '[', *p1++ = '^', *p1++ = '-', *p1++ = ']';
1040 *p1++ = '*';
1042 else if (*p0 == '?')
1043 *p1++ = '.';
1044 else if (*p0 == '['
1045 || *p0 == '.' || *p0 == '\\'
1046 || *p0 == '+' || *p0 == '^'
1047 || *p0 == '$')
1048 *p1++ = '\\', *p1++ = *p0;
1049 else
1050 *p1++ = *p0;
1052 *p1++ = '$';
1053 *p1++ = 0;
1055 Vcached_fontset_data = Fcons (build_string ((char *) SDATA (pattern)),
1056 build_string ((char *) regex));
1059 return CACHED_FONTSET_REGEX;
1062 /* Return ID of the base fontset named NAME. If there's no such
1063 fontset, return -1. NAME_PATTERN specifies how to treat NAME as this:
1064 0: pattern containing '*' and '?' as wildcards
1065 1: regular expression
1066 2: literal fontset name
1070 fs_query_fontset (name, name_pattern)
1071 Lisp_Object name;
1072 int name_pattern;
1074 Lisp_Object tem;
1075 int i;
1077 name = Fdowncase (name);
1078 if (name_pattern != 1)
1080 tem = Frassoc (name, Vfontset_alias_alist);
1081 if (NILP (tem))
1082 tem = Fassoc (name, Vfontset_alias_alist);
1083 if (CONSP (tem) && STRINGP (XCAR (tem)))
1084 name = XCAR (tem);
1085 else if (name_pattern == 0)
1087 tem = fontset_pattern_regexp (name);
1088 if (STRINGP (tem))
1090 name = tem;
1091 name_pattern = 1;
1096 for (i = 0; i < ASIZE (Vfontset_table); i++)
1098 Lisp_Object fontset, this_name;
1100 fontset = FONTSET_FROM_ID (i);
1101 if (NILP (fontset)
1102 || !BASE_FONTSET_P (fontset))
1103 continue;
1105 this_name = FONTSET_NAME (fontset);
1106 if (name_pattern == 1
1107 ? fast_string_match_ignore_case (name, this_name) >= 0
1108 : !xstrcasecmp (SDATA (name), SDATA (this_name)))
1109 return i;
1111 return -1;
1115 DEFUN ("query-fontset", Fquery_fontset, Squery_fontset, 1, 2, 0,
1116 doc: /* Return the name of a fontset that matches PATTERN.
1117 The value is nil if there is no matching fontset.
1118 PATTERN can contain `*' or `?' as a wildcard
1119 just as X font name matching algorithm allows.
1120 If REGEXPP is non-nil, PATTERN is a regular expression. */)
1121 (pattern, regexpp)
1122 Lisp_Object pattern, regexpp;
1124 Lisp_Object fontset;
1125 int id;
1127 (*check_window_system_func) ();
1129 CHECK_STRING (pattern);
1131 if (SCHARS (pattern) == 0)
1132 return Qnil;
1134 id = fs_query_fontset (pattern, !NILP (regexpp));
1135 if (id < 0)
1136 return Qnil;
1138 fontset = FONTSET_FROM_ID (id);
1139 return FONTSET_NAME (fontset);
1142 /* Return a list of base fontset names matching PATTERN on frame F. */
1144 Lisp_Object
1145 list_fontsets (f, pattern, size)
1146 FRAME_PTR f;
1147 Lisp_Object pattern;
1148 int size;
1150 Lisp_Object frame, regexp, val;
1151 int id;
1153 XSETFRAME (frame, f);
1155 regexp = fontset_pattern_regexp (pattern);
1156 val = Qnil;
1158 for (id = 0; id < ASIZE (Vfontset_table); id++)
1160 Lisp_Object fontset, name;
1162 fontset = FONTSET_FROM_ID (id);
1163 if (NILP (fontset)
1164 || !BASE_FONTSET_P (fontset)
1165 || !EQ (frame, FONTSET_FRAME (fontset)))
1166 continue;
1167 name = FONTSET_NAME (fontset);
1169 if (STRINGP (regexp)
1170 ? (fast_string_match (regexp, name) < 0)
1171 : strcmp ((char *) SDATA (pattern), (char *) SDATA (name)))
1172 continue;
1174 val = Fcons (Fcopy_sequence (FONTSET_NAME (fontset)), val);
1177 return val;
1181 /* Free all realized fontsets whose base fontset is BASE. */
1183 static void
1184 free_realized_fontsets (base)
1185 Lisp_Object base;
1187 int id;
1189 #if 0
1190 /* For the moment, this doesn't work because free_realized_face
1191 doesn't remove FACE from a cache. Until we find a solution, we
1192 suppress this code, and simply use Fclear_face_cache even though
1193 that is not efficient. */
1194 BLOCK_INPUT;
1195 for (id = 0; id < ASIZE (Vfontset_table); id++)
1197 Lisp_Object this = AREF (Vfontset_table, id);
1199 if (EQ (FONTSET_BASE (this), base))
1201 Lisp_Object tail;
1203 for (tail = FONTSET_FACE_ALIST (this); CONSP (tail);
1204 tail = XCDR (tail))
1206 FRAME_PTR f = XFRAME (FONTSET_FRAME (this));
1207 int face_id = XINT (XCDR (XCAR (tail)));
1208 struct face *face = FACE_FROM_ID (f, face_id);
1210 /* Face THIS itself is also freed by the following call. */
1211 free_realized_face (f, face);
1215 UNBLOCK_INPUT;
1216 #else /* not 0 */
1217 /* But, we don't have to call Fclear_face_cache if no fontset has
1218 been realized from BASE. */
1219 for (id = 0; id < ASIZE (Vfontset_table); id++)
1221 Lisp_Object this = AREF (Vfontset_table, id);
1223 if (CHAR_TABLE_P (this) && EQ (FONTSET_BASE (this), base))
1225 Fclear_face_cache (Qt);
1226 break;
1229 #endif /* not 0 */
1233 /* Check validity of NAME as a fontset name and return the
1234 corresponding fontset. If not valid, signal an error.
1235 If NAME is t, return Vdefault_fontset. */
1237 static Lisp_Object
1238 check_fontset_name (name)
1239 Lisp_Object name;
1241 int id;
1243 if (EQ (name, Qt))
1244 return Vdefault_fontset;
1246 CHECK_STRING (name);
1247 /* First try NAME as literal. */
1248 id = fs_query_fontset (name, 2);
1249 if (id < 0)
1250 /* For backward compatibility, try again NAME as pattern. */
1251 id = fs_query_fontset (name, 0);
1252 if (id < 0)
1253 error ("Fontset `%s' does not exist", SDATA (name));
1254 return FONTSET_FROM_ID (id);
1257 static void
1258 accumulate_script_ranges (arg, range, val)
1259 Lisp_Object arg, range, val;
1261 if (EQ (XCAR (arg), val))
1263 if (CONSP (range))
1264 XSETCDR (arg, Fcons (Fcons (XCAR (range), XCDR (range)), XCDR (arg)));
1265 else
1266 XSETCDR (arg, Fcons (Fcons (range, range), XCDR (arg)));
1271 /* Return an ASCII font name generated from fontset name NAME and
1272 font-spec ASCII_SPEC. NAME is a string conforming to XLFD. */
1274 static INLINE Lisp_Object
1275 generate_ascii_font_name (name, ascii_spec)
1276 Lisp_Object name, ascii_spec;
1278 Lisp_Object font_spec = Ffont_spec (0, NULL);
1279 int i;
1280 char xlfd[256];
1282 if (font_parse_xlfd ((char *) SDATA (name), font_spec) < 0)
1283 error ("Not an XLFD font name: %s", SDATA (name));
1284 for (i = FONT_FOUNDRY_INDEX; i < FONT_EXTRA_INDEX; i++)
1285 if (! NILP (AREF (ascii_spec, i)))
1286 ASET (font_spec, i, AREF (ascii_spec, i));
1287 i = font_unparse_xlfd (font_spec, 0, xlfd, 256);
1288 if (i < 0)
1289 error ("Not an XLFD font name: %s", SDATA (name));
1290 return make_unibyte_string (xlfd, i);
1293 /* Variables referred in set_fontset_font. They are set before
1294 map_charset_chars is called in Fset_fontset_font. */
1295 static Lisp_Object font_def_arg, add_arg;
1296 static int from_arg, to_arg;
1298 /* Callback function for map_charset_chars in Fset_fontset_font. In
1299 FONTSET, set font_def_arg in a fashion specified by add_arg for
1300 characters in RANGE while ignoring the range between from_arg and
1301 to_arg. */
1303 static void
1304 set_fontset_font (fontset, range)
1305 Lisp_Object fontset, range;
1307 if (from_arg < to_arg)
1309 int from = XINT (XCAR (range)), to = XINT (XCDR (range));
1311 if (from < from_arg)
1313 if (to > to_arg)
1315 Lisp_Object range2;
1317 range2 = Fcons (make_number (to_arg), XCDR (range));
1318 FONTSET_ADD (fontset, range, font_def_arg, add_arg);
1319 to = to_arg;
1321 if (to > from_arg)
1322 range = Fcons (XCAR (range), make_number (from_arg));
1324 else if (to <= to_arg)
1325 return;
1326 else
1328 if (from < to_arg)
1329 range = Fcons (make_number (to_arg), XCDR (range));
1332 FONTSET_ADD (fontset, range, font_def_arg, add_arg);
1335 extern Lisp_Object QCfamily, QCregistry;
1337 DEFUN ("set-fontset-font", Fset_fontset_font, Sset_fontset_font, 3, 5, 0,
1338 doc: /*
1339 Modify fontset NAME to use FONT-SPEC for TARGET characters.
1341 TARGET may be a cons; (FROM . TO), where FROM and TO are characters.
1342 In that case, use FONT-SPEC for all characters in the range FROM and
1343 TO (inclusive).
1345 TARGET may be a script name symbol. In that case, use FONT-SPEC for
1346 all characters that belong to the script.
1348 TARGET may be a charset. In that case, use FONT-SPEC for all
1349 characters in the charset.
1351 TARGET may be nil. In that case, use FONT-SPEC for any characters for
1352 that no FONT-SPEC is specified.
1354 FONT-SPEC may one of these:
1355 * A font-spec object made by the function `font-spec' (which see).
1356 * A cons (FAMILY . REGISTRY), where FAMILY is a font family name and
1357 REGISTRY is a font registry name. FAMILY may contain foundry
1358 name, and REGISTRY may contain encoding name.
1359 * A font name string.
1360 * nil, which explicitly specifies that there's no font for TARGET.
1362 Optional 4th argument FRAME, if non-nil, is a frame. This argument is
1363 kept for backward compatibility and has no meaning.
1365 Optional 5th argument ADD, if non-nil, specifies how to add FONT-SPEC
1366 to the font specifications for TARGET previously set. If it is
1367 `prepend', FONT-SPEC is prepended. If it is `append', FONT-SPEC is
1368 appended. By default, FONT-SPEC overrides the previous settings. */)
1369 (name, target, font_spec, frame, add)
1370 Lisp_Object name, target, font_spec, frame, add;
1372 Lisp_Object fontset;
1373 Lisp_Object font_def, registry, family;
1374 Lisp_Object range_list;
1375 struct charset *charset = NULL;
1377 fontset = check_fontset_name (name);
1379 /* The arg FRAME is kept for backward compatibility. We only check
1380 the validity. */
1381 if (!NILP (frame))
1382 CHECK_LIVE_FRAME (frame);
1384 if (CONSP (font_spec))
1386 Lisp_Object spec = Ffont_spec (0, NULL);
1388 font_parse_family_registry (XCAR (font_spec), XCDR (font_spec), spec);
1389 font_spec = spec;
1391 else if (STRINGP (font_spec))
1393 Lisp_Object args[2];
1394 extern Lisp_Object QCname;
1396 args[0] = QCname;
1397 args[1] = font_spec;
1398 font_spec = Ffont_spec (2, args);
1400 else if (! NILP (font_spec) && ! FONT_SPEC_P (font_spec))
1401 Fsignal (Qfont, list2 (build_string ("Invalid font-spec"), font_spec));
1403 if (! NILP (font_spec))
1405 Lisp_Object encoding, repertory;
1407 family = AREF (font_spec, FONT_FAMILY_INDEX);
1408 if (! NILP (family) )
1409 family = SYMBOL_NAME (family);
1410 registry = AREF (font_spec, FONT_REGISTRY_INDEX);
1411 if (! NILP (registry))
1412 registry = Fdowncase (SYMBOL_NAME (registry));
1413 encoding = find_font_encoding (concat3 (family, build_string ("-"),
1414 registry));
1415 if (NILP (encoding))
1416 encoding = Qascii;
1418 if (SYMBOLP (encoding))
1420 CHECK_CHARSET (encoding);
1421 encoding = repertory = CHARSET_SYMBOL_ID (encoding);
1423 else
1425 repertory = XCDR (encoding);
1426 encoding = XCAR (encoding);
1427 CHECK_CHARSET (encoding);
1428 encoding = CHARSET_SYMBOL_ID (encoding);
1429 if (! NILP (repertory) && SYMBOLP (repertory))
1431 CHECK_CHARSET (repertory);
1432 repertory = CHARSET_SYMBOL_ID (repertory);
1435 FONT_DEF_NEW (font_def, font_spec, encoding, repertory);
1437 else
1438 font_def = Qnil;
1440 if (CHARACTERP (target))
1441 range_list = Fcons (Fcons (target, target), Qnil);
1442 else if (CONSP (target))
1444 Lisp_Object from, to;
1446 from = Fcar (target);
1447 to = Fcdr (target);
1448 CHECK_CHARACTER (from);
1449 CHECK_CHARACTER (to);
1450 range_list = Fcons (target, Qnil);
1452 else if (SYMBOLP (target) && !NILP (target))
1454 Lisp_Object script_list;
1455 Lisp_Object val;
1457 range_list = Qnil;
1458 script_list = XCHAR_TABLE (Vchar_script_table)->extras[0];
1459 if (! NILP (Fmemq (target, script_list)))
1461 val = Fcons (target, Qnil);
1462 map_char_table (accumulate_script_ranges, Qnil, Vchar_script_table,
1463 val);
1464 range_list = XCDR (val);
1465 if (EQ (target, Qlatin) && NILP (FONTSET_ASCII (fontset)))
1467 if (VECTORP (font_spec))
1468 val = generate_ascii_font_name (FONTSET_NAME (fontset),
1469 font_spec);
1470 else
1471 val = font_spec;
1472 FONTSET_ASCII (fontset) = val;
1475 if (CHARSETP (target))
1477 if (EQ (target, Qascii) && NILP (FONTSET_ASCII (fontset)))
1479 if (VECTORP (font_spec))
1480 font_spec = generate_ascii_font_name (FONTSET_NAME (fontset),
1481 font_spec);
1482 FONTSET_ASCII (fontset) = font_spec;
1483 range_list = Fcons (Fcons (make_number (0), make_number (127)),
1484 Qnil);
1486 else
1488 CHECK_CHARSET_GET_CHARSET (target, charset);
1491 else if (NILP (range_list))
1492 error ("Invalid script or charset name: %s",
1493 SDATA (SYMBOL_NAME (target)));
1495 else if (NILP (target))
1496 range_list = Fcons (Qnil, Qnil);
1497 else
1498 error ("Invalid target for setting a font");
1501 if (charset)
1503 font_def_arg = font_def;
1504 add_arg = add;
1505 if (NILP (range_list))
1506 from_arg = to_arg = 0;
1507 else
1508 from_arg = XINT (XCAR (XCAR (range_list))),
1509 to_arg = XINT (XCDR (XCAR (range_list)));
1511 map_charset_chars (set_fontset_font, Qnil, fontset, charset,
1512 CHARSET_MIN_CODE (charset),
1513 CHARSET_MAX_CODE (charset));
1515 for (; CONSP (range_list); range_list = XCDR (range_list))
1516 FONTSET_ADD (fontset, XCAR (range_list), font_def, add);
1518 /* Free all realized fontsets whose base is FONTSET. This way, the
1519 specified character(s) are surely redisplayed by a correct
1520 font. */
1521 free_realized_fontsets (fontset);
1523 return Qnil;
1527 DEFUN ("new-fontset", Fnew_fontset, Snew_fontset, 2, 2, 0,
1528 doc: /* Create a new fontset NAME from font information in FONTLIST.
1530 FONTLIST is an alist of scripts vs the corresponding font specification list.
1531 Each element of FONTLIST has the form (SCRIPT FONT-SPEC ...), where a
1532 character of SCRIPT is displayed by a font that matches one of
1533 FONT-SPEC.
1535 SCRIPT is a symbol that appears in the first extra slot of the
1536 char-table `char-script-table'.
1538 FONT-SPEC is a vector, a cons, or a string. See the documentation of
1539 `set-fontset-font' for the meaning. */)
1540 (name, fontlist)
1541 Lisp_Object name, fontlist;
1543 Lisp_Object fontset;
1544 int id;
1546 CHECK_STRING (name);
1547 CHECK_LIST (fontlist);
1549 name = Fdowncase (name);
1550 id = fs_query_fontset (name, 0);
1551 if (id < 0)
1553 Lisp_Object font_spec = Ffont_spec (0, NULL);
1554 Lisp_Object short_name;
1555 char xlfd[256];
1556 int len;
1558 if (font_parse_xlfd ((char *) SDATA (name), font_spec) < 0)
1559 error ("Fontset name must be in XLFD format");
1560 short_name = AREF (font_spec, FONT_REGISTRY_INDEX);
1561 if (strncmp ((char *) SDATA (SYMBOL_NAME (short_name)), "fontset-", 8)
1562 || SBYTES (SYMBOL_NAME (short_name)) < 9)
1563 error ("Registry field of fontset name must be \"fontset-*\"");
1564 Vfontset_alias_alist = Fcons (Fcons (name, SYMBOL_NAME (short_name)),
1565 Vfontset_alias_alist);
1566 ASET (font_spec, FONT_REGISTRY_INDEX, Qiso8859_1);
1567 fontset = make_fontset (Qnil, name, Qnil);
1568 len = font_unparse_xlfd (font_spec, 0, xlfd, 256);
1569 if (len < 0)
1570 error ("Invalid fontset name (perhaps too long): %s", SDATA (name));
1571 FONTSET_ASCII (fontset) = make_unibyte_string (xlfd, len);
1573 else
1575 fontset = FONTSET_FROM_ID (id);;
1576 free_realized_fontsets (fontset);
1577 Fset_char_table_range (fontset, Qt, Qnil);
1580 for (; ! NILP (fontlist); fontlist = Fcdr (fontlist))
1582 Lisp_Object elt, script;
1584 elt = Fcar (fontlist);
1585 script = Fcar (elt);
1586 elt = Fcdr (elt);
1587 if (CONSP (elt) && (NILP (XCDR (elt)) || CONSP (XCDR (elt))))
1588 for (; CONSP (elt); elt = XCDR (elt))
1589 Fset_fontset_font (name, script, XCAR (elt), Qnil, Qappend);
1590 else
1591 Fset_fontset_font (name, script, elt, Qnil, Qappend);
1593 return name;
1597 /* Alist of automatically created fontsets. Each element is a cons
1598 (FONT-SPEC . FONTSET-ID). */
1599 static Lisp_Object auto_fontset_alist;
1602 fontset_from_font (font_object)
1603 Lisp_Object font_object;
1605 Lisp_Object font_name = font_get_name (font_object);
1606 Lisp_Object font_spec = Fcopy_font_spec (font_object);
1607 Lisp_Object fontset_spec, alias, name, fontset;
1608 Lisp_Object val;
1609 int i;
1611 val = assoc_no_quit (font_spec, auto_fontset_alist);
1612 if (CONSP (val))
1613 return XINT (FONTSET_ID (XCDR (val)));
1614 if (NILP (auto_fontset_alist))
1615 alias = intern ("fontset-startup");
1616 else
1618 char temp[32];
1619 int len = XINT (Flength (auto_fontset_alist));
1621 sprintf (temp, "fontset-auto%d", len);
1622 alias = intern (temp);
1624 fontset_spec = Fcopy_font_spec (font_spec);
1625 ASET (fontset_spec, FONT_REGISTRY_INDEX, alias);
1626 name = Ffont_xlfd_name (fontset_spec, Qnil);
1627 if (NILP (name))
1628 abort ();
1629 fontset = make_fontset (Qnil, name, Qnil);
1630 Vfontset_alias_alist = Fcons (Fcons (name, SYMBOL_NAME (alias)),
1631 Vfontset_alias_alist);
1632 alias = Fdowncase (AREF (font_object, FONT_NAME_INDEX));
1633 Vfontset_alias_alist = Fcons (Fcons (name, alias), Vfontset_alias_alist);
1634 auto_fontset_alist = Fcons (Fcons (font_spec, fontset), auto_fontset_alist);
1635 FONTSET_ASCII (fontset) = font_name;
1636 ASET (font_spec, FONT_FOUNDRY_INDEX, Qnil);
1637 ASET (font_spec, FONT_ADSTYLE_INDEX, Qnil);
1638 for (i = FONT_WEIGHT_INDEX; i < FONT_EXTRA_INDEX; i++)
1639 ASET (font_spec, i, Qnil);
1640 Fset_fontset_font (name, Qlatin, font_spec, Qnil, Qnil);
1641 font_spec = Fcopy_font_spec (font_spec);
1642 ASET (font_spec, FONT_REGISTRY_INDEX, Qiso10646_1);
1643 Fset_fontset_font (name, Qnil, font_spec, Qnil, Qnil);
1644 return XINT (FONTSET_ID (fontset));
1647 /* Return a cons (FONT-NAME . GLYPH-CODE).
1648 FONT-NAME is the font name for the character at POSITION in the current
1649 buffer. This is computed from all the text properties and overlays
1650 that apply to POSITION. POSTION may be nil, in which case,
1651 FONT-NAME is the font name for display the character CH with the
1652 default face.
1654 GLYPH-CODE is the glyph code in the font to use for the character.
1656 If the 2nd optional arg CH is non-nil, it is a character to check
1657 the font instead of the character at POSITION.
1659 It returns nil in the following cases:
1661 (1) The window system doesn't have a font for the character (thus
1662 it is displayed by an empty box).
1664 (2) The character code is invalid.
1666 (3) If POSITION is not nil, and the current buffer is not displayed
1667 in any window.
1669 In addition, the returned font name may not take into account of
1670 such redisplay engine hooks as what used in jit-lock-mode if
1671 POSITION is currently not visible. */
1674 DEFUN ("internal-char-font", Finternal_char_font, Sinternal_char_font, 1, 2, 0,
1675 doc: /* For internal use only. */)
1676 (position, ch)
1677 Lisp_Object position, ch;
1679 EMACS_INT pos, pos_byte, dummy;
1680 int face_id;
1681 int c;
1682 struct frame *f;
1683 struct face *face;
1684 int cs_id;
1686 if (NILP (position))
1688 CHECK_CHARACTER (ch);
1689 c = XINT (ch);
1690 f = XFRAME (selected_frame);
1691 face_id = lookup_basic_face (f, DEFAULT_FACE_ID);
1692 pos = -1;
1693 cs_id = -1;
1695 else
1697 Lisp_Object window, charset;
1698 struct window *w;
1700 CHECK_NUMBER_COERCE_MARKER (position);
1701 pos = XINT (position);
1702 if (pos < BEGV || pos >= ZV)
1703 args_out_of_range_3 (position, make_number (BEGV), make_number (ZV));
1704 pos_byte = CHAR_TO_BYTE (pos);
1705 if (NILP (ch))
1706 c = FETCH_CHAR (pos_byte);
1707 else
1709 CHECK_NATNUM (ch);
1710 c = XINT (ch);
1712 window = Fget_buffer_window (Fcurrent_buffer (), Qnil);
1713 if (NILP (window))
1714 return Qnil;
1715 w = XWINDOW (window);
1716 f = XFRAME (w->frame);
1717 face_id = face_at_buffer_position (w, pos, -1, -1, &dummy, pos + 100, 0);
1718 charset = Fget_char_property (position, Qcharset, Qnil);
1719 if (CHARSETP (charset))
1720 cs_id = XINT (CHARSET_SYMBOL_ID (charset));
1721 else
1722 cs_id = -1;
1724 if (! CHAR_VALID_P (c, 0))
1725 return Qnil;
1726 face_id = FACE_FOR_CHAR (f, FACE_FROM_ID (f, face_id), c, pos, Qnil);
1727 face = FACE_FROM_ID (f, face_id);
1728 if (face->font)
1730 struct font *font = face->font;
1731 unsigned code = font->driver->encode_char (font, c);
1732 Lisp_Object fontname = font->props[FONT_NAME_INDEX];
1733 /* Assignment to EMACS_INT stops GCC whining about limited range
1734 of data type. */
1735 EMACS_INT cod = code;
1737 if (code == FONT_INVALID_CODE)
1738 return Qnil;
1739 if (cod <= MOST_POSITIVE_FIXNUM)
1740 return Fcons (fontname, make_number (code));
1741 return Fcons (fontname, Fcons (make_number (code >> 16),
1742 make_number (code & 0xFFFF)));
1744 return Qnil;
1748 DEFUN ("fontset-info", Ffontset_info, Sfontset_info, 1, 2, 0,
1749 doc: /* Return information about a fontset FONTSET on frame FRAME.
1750 The value is a char-table whose elements have this form:
1752 ((FONT-PATTERN OPENED-FONT ...) ...)
1754 FONT-PATTERN is a vector:
1756 [ FAMILY WEIGHT SLANT SWIDTH ADSTYLE REGISTRY ]
1758 or a string of font name pattern.
1760 OPENED-FONT is a name of a font actually opened.
1762 The char-table has one extra slot. The value is a char-table
1763 containing the information about the derived fonts from the default
1764 fontset. The format is the same as above. */)
1765 (fontset, frame)
1766 Lisp_Object fontset, frame;
1768 FRAME_PTR f;
1769 Lisp_Object *realized[2], fontsets[2], tables[2];
1770 Lisp_Object val, elt;
1771 int c, i, j, k;
1773 (*check_window_system_func) ();
1775 fontset = check_fontset_name (fontset);
1777 if (NILP (frame))
1778 frame = selected_frame;
1779 CHECK_LIVE_FRAME (frame);
1780 f = XFRAME (frame);
1782 /* Recode fontsets realized on FRAME from the base fontset FONTSET
1783 in the table `realized'. */
1784 realized[0] = (Lisp_Object *) alloca (sizeof (Lisp_Object)
1785 * ASIZE (Vfontset_table));
1786 for (i = j = 0; i < ASIZE (Vfontset_table); i++)
1788 elt = FONTSET_FROM_ID (i);
1789 if (!NILP (elt)
1790 && EQ (FONTSET_BASE (elt), fontset)
1791 && EQ (FONTSET_FRAME (elt), frame))
1792 realized[0][j++] = elt;
1794 realized[0][j] = Qnil;
1796 realized[1] = (Lisp_Object *) alloca (sizeof (Lisp_Object)
1797 * ASIZE (Vfontset_table));
1798 for (i = j = 0; ! NILP (realized[0][i]); i++)
1800 elt = FONTSET_DEFAULT (realized[0][i]);
1801 if (! NILP (elt))
1802 realized[1][j++] = elt;
1804 realized[1][j] = Qnil;
1806 tables[0] = Fmake_char_table (Qfontset_info, Qnil);
1807 tables[1] = Fmake_char_table (Qnil, Qnil);
1808 XCHAR_TABLE (tables[0])->extras[0] = tables[1];
1809 fontsets[0] = fontset;
1810 fontsets[1] = Vdefault_fontset;
1812 /* Accumulate information of the fontset in TABLE. The format of
1813 each element is ((FONT-SPEC OPENED-FONT ...) ...). */
1814 for (k = 0; k <= 1; k++)
1816 for (c = 0; c <= MAX_CHAR; )
1818 int from, to;
1820 if (c <= MAX_5_BYTE_CHAR)
1822 val = char_table_ref_and_range (fontsets[k], c, &from, &to);
1823 if (to > MAX_5_BYTE_CHAR)
1824 to = MAX_5_BYTE_CHAR;
1826 else
1828 val = FONTSET_FALLBACK (fontsets[k]);
1829 to = MAX_CHAR;
1831 if (VECTORP (val))
1833 Lisp_Object alist;
1835 /* At first, set ALIST to ((FONT-SPEC) ...). */
1836 for (alist = Qnil, i = 0; i < ASIZE (val); i++)
1837 if (! NILP (AREF (val, i)))
1838 alist = Fcons (Fcons (FONT_DEF_SPEC (AREF (val, i)), Qnil),
1839 alist);
1840 alist = Fnreverse (alist);
1842 /* Then store opened font names to cdr of each elements. */
1843 for (i = 0; ! NILP (realized[k][i]); i++)
1845 if (c <= MAX_5_BYTE_CHAR)
1846 val = FONTSET_REF (realized[k][i], c);
1847 else
1848 val = FONTSET_FALLBACK (realized[k][i]);
1849 if (! VECTORP (val))
1850 continue;
1851 /* VAL: [int ? [FACE-ID FONT-DEF FONT-OBJECT int] ... ] */
1852 for (j = 2; j < ASIZE (val); j++)
1854 elt = AREF (val, j);
1855 if (FONT_OBJECT_P (RFONT_DEF_OBJECT (elt)))
1857 Lisp_Object font_object = RFONT_DEF_OBJECT (elt);
1858 Lisp_Object slot, name;
1860 slot = Fassq (RFONT_DEF_SPEC (elt), alist);
1861 name = AREF (font_object, FONT_NAME_INDEX);
1862 if (NILP (Fmember (name, XCDR (slot))))
1863 nconc2 (slot, Fcons (name, Qnil));
1868 /* Store ALIST in TBL for characters C..TO. */
1869 if (c <= MAX_5_BYTE_CHAR)
1870 char_table_set_range (tables[k], c, to, alist);
1871 else
1872 XCHAR_TABLE (tables[k])->defalt = alist;
1874 /* At last, change each elements to font names. */
1875 for (; CONSP (alist); alist = XCDR (alist))
1877 elt = XCAR (alist);
1878 XSETCAR (elt, Ffont_xlfd_name (XCAR (elt), Qnil));
1881 c = to + 1;
1885 return tables[0];
1889 DEFUN ("fontset-font", Ffontset_font, Sfontset_font, 2, 3, 0,
1890 doc: /* Return a font name pattern for character CH in fontset NAME.
1891 If NAME is t, find a pattern in the default fontset.
1893 The value has the form (FAMILY . REGISTRY), where FAMILY is a font
1894 family name and REGISTRY is a font registry name. This is actually
1895 the first font name pattern for CH in the fontset or in the default
1896 fontset.
1898 If the 2nd optional arg ALL is non-nil, return a list of all font name
1899 patterns. */)
1900 (name, ch, all)
1901 Lisp_Object name, ch, all;
1903 int c;
1904 Lisp_Object fontset, elt, list, repertory, val;
1905 int i, j;
1907 fontset = check_fontset_name (name);
1909 CHECK_CHARACTER (ch);
1910 c = XINT (ch);
1911 list = Qnil;
1912 while (1)
1914 for (i = 0, elt = FONTSET_REF (fontset, c); i < 2;
1915 i++, elt = FONTSET_FALLBACK (fontset))
1916 if (VECTORP (elt))
1917 for (j = 0; j < ASIZE (elt); j++)
1919 val = AREF (elt, j);
1920 repertory = AREF (val, 1);
1921 if (INTEGERP (repertory))
1923 struct charset *charset = CHARSET_FROM_ID (XINT (repertory));
1925 if (! CHAR_CHARSET_P (c, charset))
1926 continue;
1928 else if (CHAR_TABLE_P (repertory))
1930 if (NILP (CHAR_TABLE_REF (repertory, c)))
1931 continue;
1933 val = AREF (val, 0);
1934 val = Fcons (AREF (val, 0), AREF (val, 5));
1935 if (NILP (all))
1936 return val;
1937 list = Fcons (val, list);
1939 if (EQ (fontset, Vdefault_fontset))
1940 break;
1941 fontset = Vdefault_fontset;
1943 return (Fnreverse (list));
1946 DEFUN ("fontset-list", Ffontset_list, Sfontset_list, 0, 0, 0,
1947 doc: /* Return a list of all defined fontset names. */)
1950 Lisp_Object fontset, list;
1951 int i;
1953 list = Qnil;
1954 for (i = 0; i < ASIZE (Vfontset_table); i++)
1956 fontset = FONTSET_FROM_ID (i);
1957 if (!NILP (fontset)
1958 && BASE_FONTSET_P (fontset))
1959 list = Fcons (FONTSET_NAME (fontset), list);
1962 return list;
1966 #ifdef FONTSET_DEBUG
1968 Lisp_Object
1969 dump_fontset (fontset)
1970 Lisp_Object fontset;
1972 Lisp_Object vec;
1974 vec = Fmake_vector (make_number (3), Qnil);
1975 ASET (vec, 0, FONTSET_ID (fontset));
1977 if (BASE_FONTSET_P (fontset))
1979 ASET (vec, 1, FONTSET_NAME (fontset));
1981 else
1983 Lisp_Object frame;
1985 frame = FONTSET_FRAME (fontset);
1986 if (FRAMEP (frame))
1988 FRAME_PTR f = XFRAME (frame);
1990 if (FRAME_LIVE_P (f))
1991 ASET (vec, 1,
1992 Fcons (FONTSET_NAME (FONTSET_BASE (fontset)), f->name));
1993 else
1994 ASET (vec, 1,
1995 Fcons (FONTSET_NAME (FONTSET_BASE (fontset)), Qnil));
1997 if (!NILP (FONTSET_DEFAULT (fontset)))
1998 ASET (vec, 2, FONTSET_ID (FONTSET_DEFAULT (fontset)));
2000 return vec;
2003 DEFUN ("fontset-list-all", Ffontset_list_all, Sfontset_list_all, 0, 0, 0,
2004 doc: /* Return a brief summary of all fontsets for debug use. */)
2007 Lisp_Object val;
2008 int i;
2010 for (i = 0, val = Qnil; i < ASIZE (Vfontset_table); i++)
2011 if (! NILP (AREF (Vfontset_table, i)))
2012 val = Fcons (dump_fontset (AREF (Vfontset_table, i)), val);
2013 return (Fnreverse (val));
2015 #endif /* FONTSET_DEBUG */
2017 void
2018 syms_of_fontset ()
2020 DEFSYM (Qfontset, "fontset");
2021 Fput (Qfontset, Qchar_table_extra_slots, make_number (9));
2022 DEFSYM (Qfontset_info, "fontset-info");
2023 Fput (Qfontset_info, Qchar_table_extra_slots, make_number (1));
2025 DEFSYM (Qprepend, "prepend");
2026 DEFSYM (Qappend, "append");
2027 DEFSYM (Qlatin, "latin");
2029 Vcached_fontset_data = Qnil;
2030 staticpro (&Vcached_fontset_data);
2032 Vfontset_table = Fmake_vector (make_number (32), Qnil);
2033 staticpro (&Vfontset_table);
2035 Vdefault_fontset = Fmake_char_table (Qfontset, Qnil);
2036 staticpro (&Vdefault_fontset);
2037 FONTSET_ID (Vdefault_fontset) = make_number (0);
2038 FONTSET_NAME (Vdefault_fontset)
2039 = build_string ("-*-*-*-*-*-*-*-*-*-*-*-*-fontset-default");
2040 ASET (Vfontset_table, 0, Vdefault_fontset);
2041 next_fontset_id = 1;
2043 auto_fontset_alist = Qnil;
2044 staticpro (&auto_fontset_alist);
2046 DEFVAR_LISP ("font-encoding-charset-alist", &Vfont_encoding_charset_alist,
2047 doc: /*
2048 Alist of charsets vs the charsets to determine the preferred font encoding.
2049 Each element looks like (CHARSET . ENCODING-CHARSET),
2050 where ENCODING-CHARSET is a charset registered in the variable
2051 `font-encoding-alist' as ENCODING.
2053 When a text has a property `charset' and the value is CHARSET, a font
2054 whose encoding corresponds to ENCODING-CHARSET is preferred. */);
2055 Vfont_encoding_charset_alist = Qnil;
2057 DEFVAR_LISP ("use-default-ascent", &Vuse_default_ascent,
2058 doc: /*
2059 Char table of characters whose ascent values should be ignored.
2060 If an entry for a character is non-nil, the ascent value of the glyph
2061 is assumed to be specified by _MULE_DEFAULT_ASCENT property of a font.
2063 This affects how a composite character which contains
2064 such a character is displayed on screen. */);
2065 Vuse_default_ascent = Qnil;
2067 DEFVAR_LISP ("ignore-relative-composition", &Vignore_relative_composition,
2068 doc: /*
2069 Char table of characters which are not composed relatively.
2070 If an entry for a character is non-nil, a composition sequence
2071 which contains that character is displayed so that
2072 the glyph of that character is put without considering
2073 an ascent and descent value of a previous character. */);
2074 Vignore_relative_composition = Qnil;
2076 DEFVAR_LISP ("alternate-fontname-alist", &Valternate_fontname_alist,
2077 doc: /* Alist of fontname vs list of the alternate fontnames.
2078 When a specified font name is not found, the corresponding
2079 alternate fontnames (if any) are tried instead. */);
2080 Valternate_fontname_alist = Qnil;
2082 DEFVAR_LISP ("fontset-alias-alist", &Vfontset_alias_alist,
2083 doc: /* Alist of fontset names vs the aliases. */);
2084 Vfontset_alias_alist = Fcons (Fcons (FONTSET_NAME (Vdefault_fontset),
2085 build_string ("fontset-default")),
2086 Qnil);
2088 DEFVAR_LISP ("vertical-centering-font-regexp",
2089 &Vvertical_centering_font_regexp,
2090 doc: /* *Regexp matching font names that require vertical centering on display.
2091 When a character is displayed with such fonts, the character is displayed
2092 at the vertical center of lines. */);
2093 Vvertical_centering_font_regexp = Qnil;
2095 DEFVAR_LISP ("otf-script-alist", &Votf_script_alist,
2096 doc: /* Alist of OpenType script tags vs the corresponding script names. */);
2097 Votf_script_alist = Qnil;
2099 defsubr (&Squery_fontset);
2100 defsubr (&Snew_fontset);
2101 defsubr (&Sset_fontset_font);
2102 defsubr (&Sinternal_char_font);
2103 defsubr (&Sfontset_info);
2104 defsubr (&Sfontset_font);
2105 defsubr (&Sfontset_list);
2106 #ifdef FONTSET_DEBUG
2107 defsubr (&Sfontset_list_all);
2108 #endif
2111 /* arch-tag: ea861585-2f5f-4e5b-9849-d04a9c3a3537
2112 (do not change this comment) */