ChangeLog updates for last commit.
[emacs.git] / src / font.c
blob43b74b5b6f8d78c0a27ed7f355c27a4997ecf853
1 /* font.c -- "Font" primitives.
3 Copyright (C) 2006-2012 Free Software Foundation, Inc.
4 Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011
5 National Institute of Advanced Industrial Science and Technology (AIST)
6 Registration Number H13PRO009
8 This file is part of GNU Emacs.
10 GNU Emacs is free software: you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation, either version 3 of the License, or
13 (at your option) any later version.
15 GNU Emacs is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
23 #include <config.h>
24 #include <float.h>
25 #include <stdio.h>
26 #include <ctype.h>
27 #include <setjmp.h>
29 #include "lisp.h"
30 #include "buffer.h"
31 #include "frame.h"
32 #include "window.h"
33 #include "dispextern.h"
34 #include "charset.h"
35 #include "character.h"
36 #include "composite.h"
37 #include "fontset.h"
38 #include "font.h"
40 #ifdef HAVE_X_WINDOWS
41 #include "xterm.h"
42 #endif /* HAVE_X_WINDOWS */
44 #ifdef HAVE_NTGUI
45 #include "w32term.h"
46 #endif /* HAVE_NTGUI */
48 #ifdef HAVE_NS
49 #include "nsterm.h"
50 #endif /* HAVE_NS */
52 Lisp_Object Qopentype;
54 /* Important character set strings. */
55 Lisp_Object Qascii_0, Qiso8859_1, Qiso10646_1, Qunicode_bmp, Qunicode_sip;
57 #define DEFAULT_ENCODING Qiso8859_1
59 /* Unicode category `Cf'. */
60 static Lisp_Object QCf;
62 /* Special vector of zero length. This is repeatedly used by (struct
63 font_driver *)->list when a specified font is not found. */
64 static Lisp_Object null_vector;
66 /* Vector of Vfont_weight_table, Vfont_slant_table, and Vfont_width_table. */
67 static Lisp_Object font_style_table;
69 /* Structure used for tables mapping weight, slant, and width numeric
70 values and their names. */
72 struct table_entry
74 int numeric;
75 /* The first one is a valid name as a face attribute.
76 The second one (if any) is a typical name in XLFD field. */
77 const char *names[5];
80 /* Table of weight numeric values and their names. This table must be
81 sorted by numeric values in ascending order. */
83 static const struct table_entry weight_table[] =
85 { 0, { "thin" }},
86 { 20, { "ultra-light", "ultralight" }},
87 { 40, { "extra-light", "extralight" }},
88 { 50, { "light" }},
89 { 75, { "semi-light", "semilight", "demilight", "book" }},
90 { 100, { "normal", "medium", "regular", "unspecified" }},
91 { 180, { "semi-bold", "semibold", "demibold", "demi" }},
92 { 200, { "bold" }},
93 { 205, { "extra-bold", "extrabold" }},
94 { 210, { "ultra-bold", "ultrabold", "black" }}
97 /* Table of slant numeric values and their names. This table must be
98 sorted by numeric values in ascending order. */
100 static const struct table_entry slant_table[] =
102 { 0, { "reverse-oblique", "ro" }},
103 { 10, { "reverse-italic", "ri" }},
104 { 100, { "normal", "r", "unspecified" }},
105 { 200, { "italic" ,"i", "ot" }},
106 { 210, { "oblique", "o" }}
109 /* Table of width numeric values and their names. This table must be
110 sorted by numeric values in ascending order. */
112 static const struct table_entry width_table[] =
114 { 50, { "ultra-condensed", "ultracondensed" }},
115 { 63, { "extra-condensed", "extracondensed" }},
116 { 75, { "condensed", "compressed", "narrow" }},
117 { 87, { "semi-condensed", "semicondensed", "demicondensed" }},
118 { 100, { "normal", "medium", "regular", "unspecified" }},
119 { 113, { "semi-expanded", "semiexpanded", "demiexpanded" }},
120 { 125, { "expanded" }},
121 { 150, { "extra-expanded", "extraexpanded" }},
122 { 200, { "ultra-expanded", "ultraexpanded", "wide" }}
125 Lisp_Object QCfoundry;
126 static Lisp_Object QCadstyle, QCregistry;
127 /* Symbols representing keys of font extra info. */
128 Lisp_Object QCspacing, QCdpi, QCscalable, QCotf, QClang, QCscript, QCavgwidth;
129 Lisp_Object QCantialias, QCfont_entity;
130 static Lisp_Object QCfc_unknown_spec;
131 /* Symbols representing values of font spacing property. */
132 static Lisp_Object Qc, Qm, Qd;
133 Lisp_Object Qp;
134 /* Special ADSTYLE properties to avoid fonts used for Latin
135 characters; used in xfont.c and ftfont.c. */
136 Lisp_Object Qja, Qko;
138 static Lisp_Object QCuser_spec;
140 /* Alist of font registry symbols and the corresponding charset
141 information. The information is retrieved from
142 Vfont_encoding_alist on demand.
144 Eash element has the form:
145 (REGISTRY . (ENCODING-CHARSET-ID . REPERTORY-CHARSET-ID))
147 (REGISTRY . nil)
149 In the former form, ENCODING-CHARSET-ID is an ID of a charset that
150 encodes a character code to a glyph code of a font, and
151 REPERTORY-CHARSET-ID is an ID of a charset that tells if a
152 character is supported by a font.
154 The latter form means that the information for REGISTRY couldn't be
155 retrieved. */
156 static Lisp_Object font_charset_alist;
158 /* List of all font drivers. Each font-backend (XXXfont.c) calls
159 register_font_driver in syms_of_XXXfont to register its font-driver
160 here. */
161 static struct font_driver_list *font_driver_list;
165 /* Creators of font-related Lisp object. */
167 static Lisp_Object
168 font_make_spec (void)
170 Lisp_Object font_spec;
171 struct font_spec *spec
172 = ((struct font_spec *)
173 allocate_pseudovector (VECSIZE (struct font_spec),
174 FONT_SPEC_MAX, PVEC_FONT));
175 XSETFONT (font_spec, spec);
176 return font_spec;
179 Lisp_Object
180 font_make_entity (void)
182 Lisp_Object font_entity;
183 struct font_entity *entity
184 = ((struct font_entity *)
185 allocate_pseudovector (VECSIZE (struct font_entity),
186 FONT_ENTITY_MAX, PVEC_FONT));
187 XSETFONT (font_entity, entity);
188 return font_entity;
191 /* Create a font-object whose structure size is SIZE. If ENTITY is
192 not nil, copy properties from ENTITY to the font-object. If
193 PIXELSIZE is positive, set the `size' property to PIXELSIZE. */
194 Lisp_Object
195 font_make_object (int size, Lisp_Object entity, int pixelsize)
197 Lisp_Object font_object;
198 struct font *font
199 = (struct font *) allocate_pseudovector (size, FONT_OBJECT_MAX, PVEC_FONT);
200 int i;
202 XSETFONT (font_object, font);
204 if (! NILP (entity))
206 for (i = 1; i < FONT_SPEC_MAX; i++)
207 font->props[i] = AREF (entity, i);
208 if (! NILP (AREF (entity, FONT_EXTRA_INDEX)))
209 font->props[FONT_EXTRA_INDEX]
210 = Fcopy_alist (AREF (entity, FONT_EXTRA_INDEX));
212 if (size > 0)
213 font->props[FONT_SIZE_INDEX] = make_number (pixelsize);
214 return font_object;
219 static int font_pixel_size (FRAME_PTR f, Lisp_Object);
220 static Lisp_Object font_open_entity (FRAME_PTR, Lisp_Object, int);
221 static Lisp_Object font_matching_entity (FRAME_PTR, Lisp_Object *,
222 Lisp_Object);
223 static unsigned font_encode_char (Lisp_Object, int);
225 /* Number of registered font drivers. */
226 static int num_font_drivers;
229 /* Return a Lispy value of a font property value at STR and LEN bytes.
230 If STR is "*", return nil.
231 If FORCE_SYMBOL is zero and all characters in STR are digits,
232 return an integer. Otherwise, return a symbol interned from
233 STR. */
235 Lisp_Object
236 font_intern_prop (const char *str, ptrdiff_t len, int force_symbol)
238 ptrdiff_t i;
239 Lisp_Object tem;
240 Lisp_Object obarray;
241 EMACS_INT nbytes, nchars;
243 if (len == 1 && *str == '*')
244 return Qnil;
245 if (!force_symbol && 0 < len && '0' <= *str && *str <= '9')
247 for (i = 1; i < len; i++)
248 if (! ('0' <= str[i] && str[i] <= '9'))
249 break;
250 if (i == len)
252 EMACS_INT n;
254 i = 0;
255 for (n = 0; (n += str[i++] - '0') <= MOST_POSITIVE_FIXNUM; n *= 10)
257 if (i == len)
258 return make_number (n);
259 if (MOST_POSITIVE_FIXNUM / 10 < n)
260 break;
263 xsignal1 (Qoverflow_error, make_string (str, len));
267 /* The following code is copied from the function intern (in
268 lread.c), and modified to suit our purpose. */
269 obarray = Vobarray;
270 if (!VECTORP (obarray) || ASIZE (obarray) == 0)
271 obarray = check_obarray (obarray);
272 parse_str_as_multibyte ((unsigned char *) str, len, &nchars, &nbytes);
273 if (len == nchars || len != nbytes)
274 /* CONTENTS contains no multibyte sequences or contains an invalid
275 multibyte sequence. We'll make a unibyte string. */
276 tem = oblookup (obarray, str, len, len);
277 else
278 tem = oblookup (obarray, str, nchars, len);
279 if (SYMBOLP (tem))
280 return tem;
281 if (len == nchars || len != nbytes)
282 tem = make_unibyte_string (str, len);
283 else
284 tem = make_multibyte_string (str, nchars, len);
285 return Fintern (tem, obarray);
288 /* Return a pixel size of font-spec SPEC on frame F. */
290 static int
291 font_pixel_size (FRAME_PTR f, Lisp_Object spec)
293 #ifdef HAVE_WINDOW_SYSTEM
294 Lisp_Object size = AREF (spec, FONT_SIZE_INDEX);
295 double point_size;
296 int dpi, pixel_size;
297 Lisp_Object val;
299 if (INTEGERP (size))
300 return XINT (size);
301 if (NILP (size))
302 return 0;
303 font_assert (FLOATP (size));
304 point_size = XFLOAT_DATA (size);
305 val = AREF (spec, FONT_DPI_INDEX);
306 if (INTEGERP (val))
307 dpi = XINT (val);
308 else
309 dpi = f->resy;
310 pixel_size = POINT_TO_PIXEL (point_size, dpi);
311 return pixel_size;
312 #else
313 return 1;
314 #endif
318 /* Return a value of PROP's VAL (symbol or integer) to be stored in a
319 font vector. If VAL is not valid (i.e. not registered in
320 font_style_table), return -1 if NOERROR is zero, and return a
321 proper index if NOERROR is nonzero. In that case, register VAL in
322 font_style_table if VAL is a symbol, and return the closest index if
323 VAL is an integer. */
326 font_style_to_value (enum font_property_index prop, Lisp_Object val, int noerror)
328 Lisp_Object table = AREF (font_style_table, prop - FONT_WEIGHT_INDEX);
329 int len = ASIZE (table);
331 if (SYMBOLP (val))
333 int i, j;
334 char *s;
335 Lisp_Object args[2], elt;
337 /* At first try exact match. */
338 for (i = 0; i < len; i++)
339 for (j = 1; j < ASIZE (AREF (table, i)); j++)
340 if (EQ (val, AREF (AREF (table, i), j)))
341 return ((XINT (AREF (AREF (table, i), 0)) << 8)
342 | (i << 4) | (j - 1));
343 /* Try also with case-folding match. */
344 s = SSDATA (SYMBOL_NAME (val));
345 for (i = 0; i < len; i++)
346 for (j = 1; j < ASIZE (AREF (table, i)); j++)
348 elt = AREF (AREF (table, i), j);
349 if (xstrcasecmp (s, SSDATA (SYMBOL_NAME (elt))) == 0)
350 return ((XINT (AREF (AREF (table, i), 0)) << 8)
351 | (i << 4) | (j - 1));
353 if (! noerror)
354 return -1;
355 if (len == 255)
356 abort ();
357 elt = Fmake_vector (make_number (2), make_number (100));
358 ASET (elt, 1, val);
359 args[0] = table;
360 args[1] = Fmake_vector (make_number (1), elt);
361 ASET (font_style_table, prop - FONT_WEIGHT_INDEX, Fvconcat (2, args));
362 return (100 << 8) | (i << 4);
364 else
366 int i, last_n;
367 int numeric = XINT (val);
369 for (i = 0, last_n = -1; i < len; i++)
371 int n = XINT (AREF (AREF (table, i), 0));
373 if (numeric == n)
374 return (n << 8) | (i << 4);
375 if (numeric < n)
377 if (! noerror)
378 return -1;
379 return ((i == 0 || n - numeric < numeric - last_n)
380 ? (n << 8) | (i << 4): (last_n << 8 | ((i - 1) << 4)));
382 last_n = n;
384 if (! noerror)
385 return -1;
386 return ((last_n << 8) | ((i - 1) << 4));
390 Lisp_Object
391 font_style_symbolic (Lisp_Object font, enum font_property_index prop, int for_face)
393 Lisp_Object val = AREF (font, prop);
394 Lisp_Object table, elt;
395 int i;
397 if (NILP (val))
398 return Qnil;
399 table = AREF (font_style_table, prop - FONT_WEIGHT_INDEX);
400 i = XINT (val) & 0xFF;
401 font_assert (((i >> 4) & 0xF) < ASIZE (table));
402 elt = AREF (table, ((i >> 4) & 0xF));
403 font_assert ((i & 0xF) + 1 < ASIZE (elt));
404 return (for_face ? AREF (elt, 1) : AREF (elt, (i & 0xF) + 1));
407 /* Return ENCODING or a cons of ENCODING and REPERTORY of the font
408 FONTNAME. ENCODING is a charset symbol that specifies the encoding
409 of the font. REPERTORY is a charset symbol or nil. */
411 Lisp_Object
412 find_font_encoding (Lisp_Object fontname)
414 Lisp_Object tail, elt;
416 for (tail = Vfont_encoding_alist; CONSP (tail); tail = XCDR (tail))
418 elt = XCAR (tail);
419 if (CONSP (elt)
420 && STRINGP (XCAR (elt))
421 && fast_string_match_ignore_case (XCAR (elt), fontname) >= 0
422 && (SYMBOLP (XCDR (elt))
423 ? CHARSETP (XCDR (elt))
424 : CONSP (XCDR (elt)) && CHARSETP (XCAR (XCDR (elt)))))
425 return (XCDR (elt));
427 return Qnil;
430 /* Return encoding charset and repertory charset for REGISTRY in
431 ENCODING and REPERTORY correspondingly. If correct information for
432 REGISTRY is available, return 0. Otherwise return -1. */
435 font_registry_charsets (Lisp_Object registry, struct charset **encoding, struct charset **repertory)
437 Lisp_Object val;
438 int encoding_id, repertory_id;
440 val = Fassoc_string (registry, font_charset_alist, Qt);
441 if (! NILP (val))
443 val = XCDR (val);
444 if (NILP (val))
445 return -1;
446 encoding_id = XINT (XCAR (val));
447 repertory_id = XINT (XCDR (val));
449 else
451 val = find_font_encoding (SYMBOL_NAME (registry));
452 if (SYMBOLP (val) && CHARSETP (val))
454 encoding_id = repertory_id = XINT (CHARSET_SYMBOL_ID (val));
456 else if (CONSP (val))
458 if (! CHARSETP (XCAR (val)))
459 goto invalid_entry;
460 encoding_id = XINT (CHARSET_SYMBOL_ID (XCAR (val)));
461 if (NILP (XCDR (val)))
462 repertory_id = -1;
463 else
465 if (! CHARSETP (XCDR (val)))
466 goto invalid_entry;
467 repertory_id = XINT (CHARSET_SYMBOL_ID (XCDR (val)));
470 else
471 goto invalid_entry;
472 val = Fcons (make_number (encoding_id), make_number (repertory_id));
473 font_charset_alist
474 = nconc2 (font_charset_alist, Fcons (Fcons (registry, val), Qnil));
477 if (encoding)
478 *encoding = CHARSET_FROM_ID (encoding_id);
479 if (repertory)
480 *repertory = repertory_id >= 0 ? CHARSET_FROM_ID (repertory_id) : NULL;
481 return 0;
483 invalid_entry:
484 font_charset_alist
485 = nconc2 (font_charset_alist, Fcons (Fcons (registry, Qnil), Qnil));
486 return -1;
490 /* Font property value validators. See the comment of
491 font_property_table for the meaning of the arguments. */
493 static Lisp_Object font_prop_validate (int, Lisp_Object, Lisp_Object);
494 static Lisp_Object font_prop_validate_symbol (Lisp_Object, Lisp_Object);
495 static Lisp_Object font_prop_validate_style (Lisp_Object, Lisp_Object);
496 static Lisp_Object font_prop_validate_non_neg (Lisp_Object, Lisp_Object);
497 static Lisp_Object font_prop_validate_spacing (Lisp_Object, Lisp_Object);
498 static int get_font_prop_index (Lisp_Object);
500 static Lisp_Object
501 font_prop_validate_symbol (Lisp_Object prop, Lisp_Object val)
503 if (STRINGP (val))
504 val = Fintern (val, Qnil);
505 if (! SYMBOLP (val))
506 val = Qerror;
507 else if (EQ (prop, QCregistry))
508 val = Fintern (Fdowncase (SYMBOL_NAME (val)), Qnil);
509 return val;
513 static Lisp_Object
514 font_prop_validate_style (Lisp_Object style, Lisp_Object val)
516 enum font_property_index prop = (EQ (style, QCweight) ? FONT_WEIGHT_INDEX
517 : EQ (style, QCslant) ? FONT_SLANT_INDEX
518 : FONT_WIDTH_INDEX);
519 if (INTEGERP (val))
521 int n = XINT (val);
522 if (((n >> 4) & 0xF)
523 >= ASIZE (AREF (font_style_table, prop - FONT_WEIGHT_INDEX)))
524 val = Qerror;
525 else
527 Lisp_Object elt = AREF (AREF (font_style_table, prop - FONT_WEIGHT_INDEX), (n >> 4) & 0xF);
529 if ((n & 0xF) + 1 >= ASIZE (elt))
530 val = Qerror;
531 else if (XINT (AREF (elt, 0)) != (n >> 8))
532 val = Qerror;
535 else if (SYMBOLP (val))
537 int n = font_style_to_value (prop, val, 0);
539 val = n >= 0 ? make_number (n) : Qerror;
541 else
542 val = Qerror;
543 return val;
546 static Lisp_Object
547 font_prop_validate_non_neg (Lisp_Object prop, Lisp_Object val)
549 return (NATNUMP (val) || (FLOATP (val) && XFLOAT_DATA (val) >= 0)
550 ? val : Qerror);
553 static Lisp_Object
554 font_prop_validate_spacing (Lisp_Object prop, Lisp_Object val)
556 if (NILP (val) || (NATNUMP (val) && XINT (val) <= FONT_SPACING_CHARCELL))
557 return val;
558 if (SYMBOLP (val) && SBYTES (SYMBOL_NAME (val)) == 1)
560 char spacing = SDATA (SYMBOL_NAME (val))[0];
562 if (spacing == 'c' || spacing == 'C')
563 return make_number (FONT_SPACING_CHARCELL);
564 if (spacing == 'm' || spacing == 'M')
565 return make_number (FONT_SPACING_MONO);
566 if (spacing == 'p' || spacing == 'P')
567 return make_number (FONT_SPACING_PROPORTIONAL);
568 if (spacing == 'd' || spacing == 'D')
569 return make_number (FONT_SPACING_DUAL);
571 return Qerror;
574 static Lisp_Object
575 font_prop_validate_otf (Lisp_Object prop, Lisp_Object val)
577 Lisp_Object tail, tmp;
578 int i;
580 /* VAL = (SCRIPT [ LANGSYS [ GSUB-FEATURES [ GPOS-FEATURES ]]])
581 GSUB-FEATURES = (FEATURE ... [ nil FEATURE ... ]) | nil
582 GPOS-FEATURES = (FEATURE ... [ nil FEATURE ... ]) | nil */
583 if (! CONSP (val))
584 return Qerror;
585 if (! SYMBOLP (XCAR (val)))
586 return Qerror;
587 tail = XCDR (val);
588 if (NILP (tail))
589 return val;
590 if (! CONSP (tail) || ! SYMBOLP (XCAR (val)))
591 return Qerror;
592 for (i = 0; i < 2; i++)
594 tail = XCDR (tail);
595 if (NILP (tail))
596 return val;
597 if (! CONSP (tail))
598 return Qerror;
599 for (tmp = XCAR (tail); CONSP (tmp); tmp = XCDR (tmp))
600 if (! SYMBOLP (XCAR (tmp)))
601 return Qerror;
602 if (! NILP (tmp))
603 return Qerror;
605 return val;
608 /* Structure of known font property keys and validator of the
609 values. */
610 static const struct
612 /* Pointer to the key symbol. */
613 Lisp_Object *key;
614 /* Function to validate PROP's value VAL, or NULL if any value is
615 ok. The value is VAL or its regularized value if VAL is valid,
616 and Qerror if not. */
617 Lisp_Object (*validator) (Lisp_Object prop, Lisp_Object val);
618 } font_property_table[] =
619 { { &QCtype, font_prop_validate_symbol },
620 { &QCfoundry, font_prop_validate_symbol },
621 { &QCfamily, font_prop_validate_symbol },
622 { &QCadstyle, font_prop_validate_symbol },
623 { &QCregistry, font_prop_validate_symbol },
624 { &QCweight, font_prop_validate_style },
625 { &QCslant, font_prop_validate_style },
626 { &QCwidth, font_prop_validate_style },
627 { &QCsize, font_prop_validate_non_neg },
628 { &QCdpi, font_prop_validate_non_neg },
629 { &QCspacing, font_prop_validate_spacing },
630 { &QCavgwidth, font_prop_validate_non_neg },
631 /* The order of the above entries must match with enum
632 font_property_index. */
633 { &QClang, font_prop_validate_symbol },
634 { &QCscript, font_prop_validate_symbol },
635 { &QCotf, font_prop_validate_otf }
638 /* Size (number of elements) of the above table. */
639 #define FONT_PROPERTY_TABLE_SIZE \
640 ((sizeof font_property_table) / (sizeof *font_property_table))
642 /* Return an index number of font property KEY or -1 if KEY is not an
643 already known property. */
645 static int
646 get_font_prop_index (Lisp_Object key)
648 int i;
650 for (i = 0; i < FONT_PROPERTY_TABLE_SIZE; i++)
651 if (EQ (key, *font_property_table[i].key))
652 return i;
653 return -1;
656 /* Validate the font property. The property key is specified by the
657 symbol PROP, or the index IDX (if PROP is nil). If VAL is invalid,
658 signal an error. The value is VAL or the regularized one. */
660 static Lisp_Object
661 font_prop_validate (int idx, Lisp_Object prop, Lisp_Object val)
663 Lisp_Object validated;
665 if (NILP (val))
666 return val;
667 if (NILP (prop))
668 prop = *font_property_table[idx].key;
669 else
671 idx = get_font_prop_index (prop);
672 if (idx < 0)
673 return val;
675 validated = (font_property_table[idx].validator) (prop, val);
676 if (EQ (validated, Qerror))
677 signal_error ("invalid font property", Fcons (prop, val));
678 return validated;
682 /* Store VAL as a value of extra font property PROP in FONT while
683 keeping the sorting order. Don't check the validity of VAL. */
685 Lisp_Object
686 font_put_extra (Lisp_Object font, Lisp_Object prop, Lisp_Object val)
688 Lisp_Object extra = AREF (font, FONT_EXTRA_INDEX);
689 Lisp_Object slot = (NILP (extra) ? Qnil : assq_no_quit (prop, extra));
691 if (NILP (slot))
693 Lisp_Object prev = Qnil;
695 while (CONSP (extra)
696 && NILP (Fstring_lessp (prop, XCAR (XCAR (extra)))))
697 prev = extra, extra = XCDR (extra);
699 if (NILP (prev))
700 ASET (font, FONT_EXTRA_INDEX, Fcons (Fcons (prop, val), extra));
701 else
702 XSETCDR (prev, Fcons (Fcons (prop, val), extra));
704 return val;
706 XSETCDR (slot, val);
707 if (NILP (val))
708 ASET (font, FONT_EXTRA_INDEX, Fdelq (slot, extra));
709 return val;
713 /* Font name parser and unparser */
715 static int parse_matrix (const char *);
716 static int font_expand_wildcards (Lisp_Object *, int);
717 static int font_parse_name (char *, Lisp_Object);
719 /* An enumerator for each field of an XLFD font name. */
720 enum xlfd_field_index
722 XLFD_FOUNDRY_INDEX,
723 XLFD_FAMILY_INDEX,
724 XLFD_WEIGHT_INDEX,
725 XLFD_SLANT_INDEX,
726 XLFD_SWIDTH_INDEX,
727 XLFD_ADSTYLE_INDEX,
728 XLFD_PIXEL_INDEX,
729 XLFD_POINT_INDEX,
730 XLFD_RESX_INDEX,
731 XLFD_RESY_INDEX,
732 XLFD_SPACING_INDEX,
733 XLFD_AVGWIDTH_INDEX,
734 XLFD_REGISTRY_INDEX,
735 XLFD_ENCODING_INDEX,
736 XLFD_LAST_INDEX
739 /* An enumerator for mask bit corresponding to each XLFD field. */
740 enum xlfd_field_mask
742 XLFD_FOUNDRY_MASK = 0x0001,
743 XLFD_FAMILY_MASK = 0x0002,
744 XLFD_WEIGHT_MASK = 0x0004,
745 XLFD_SLANT_MASK = 0x0008,
746 XLFD_SWIDTH_MASK = 0x0010,
747 XLFD_ADSTYLE_MASK = 0x0020,
748 XLFD_PIXEL_MASK = 0x0040,
749 XLFD_POINT_MASK = 0x0080,
750 XLFD_RESX_MASK = 0x0100,
751 XLFD_RESY_MASK = 0x0200,
752 XLFD_SPACING_MASK = 0x0400,
753 XLFD_AVGWIDTH_MASK = 0x0800,
754 XLFD_REGISTRY_MASK = 0x1000,
755 XLFD_ENCODING_MASK = 0x2000
759 /* Parse P pointing to the pixel/point size field of the form
760 `[A B C D]' which specifies a transformation matrix:
762 A B 0
763 C D 0
764 0 0 1
766 by which all glyphs of the font are transformed. The spec says
767 that scalar value N for the pixel/point size is equivalent to:
768 A = N * resx/resy, B = C = 0, D = N.
770 Return the scalar value N if the form is valid. Otherwise return
771 -1. */
773 static int
774 parse_matrix (const char *p)
776 double matrix[4];
777 char *end;
778 int i;
780 for (i = 0, p++; i < 4 && *p && *p != ']'; i++)
782 if (*p == '~')
783 matrix[i] = - strtod (p + 1, &end);
784 else
785 matrix[i] = strtod (p, &end);
786 p = end;
788 return (i == 4 ? (int) matrix[3] : -1);
791 /* Expand a wildcard field in FIELD (the first N fields are filled) to
792 multiple fields to fill in all 14 XLFD fields while restricting a
793 field position by its contents. */
795 static int
796 font_expand_wildcards (Lisp_Object *field, int n)
798 /* Copy of FIELD. */
799 Lisp_Object tmp[XLFD_LAST_INDEX];
800 /* Array of information about where this element can go. Nth
801 element is for Nth element of FIELD. */
802 struct {
803 /* Minimum possible field. */
804 int from;
805 /* Maximum possible field. */
806 int to;
807 /* Bit mask of possible field. Nth bit corresponds to Nth field. */
808 int mask;
809 } range[XLFD_LAST_INDEX];
810 int i, j;
811 int range_from, range_to;
812 unsigned range_mask;
814 #define XLFD_SYMBOL_MASK (XLFD_FOUNDRY_MASK | XLFD_FAMILY_MASK \
815 | XLFD_ADSTYLE_MASK | XLFD_REGISTRY_MASK)
816 #define XLFD_NULL_MASK (XLFD_FOUNDRY_MASK | XLFD_ADSTYLE_MASK)
817 #define XLFD_LARGENUM_MASK (XLFD_POINT_MASK | XLFD_RESX_MASK | XLFD_RESY_MASK \
818 | XLFD_AVGWIDTH_MASK)
819 #define XLFD_REGENC_MASK (XLFD_REGISTRY_MASK | XLFD_ENCODING_MASK)
821 /* Initialize RANGE_MASK for FIELD[0] which can be 0th to (14 - N)th
822 field. The value is shifted to left one bit by one in the
823 following loop. */
824 for (i = 0, range_mask = 0; i <= 14 - n; i++)
825 range_mask = (range_mask << 1) | 1;
827 /* The triplet RANGE_FROM, RANGE_TO, and RANGE_MASK is a
828 position-based restriction for FIELD[I]. */
829 for (i = 0, range_from = 0, range_to = 14 - n; i < n;
830 i++, range_from++, range_to++, range_mask <<= 1)
832 Lisp_Object val = field[i];
834 tmp[i] = val;
835 if (NILP (val))
837 /* Wildcard. */
838 range[i].from = range_from;
839 range[i].to = range_to;
840 range[i].mask = range_mask;
842 else
844 /* The triplet FROM, TO, and MASK is a value-based
845 restriction for FIELD[I]. */
846 int from, to;
847 unsigned mask;
849 if (INTEGERP (val))
851 int numeric = XINT (val);
853 if (i + 1 == n)
854 from = to = XLFD_ENCODING_INDEX,
855 mask = XLFD_ENCODING_MASK;
856 else if (numeric == 0)
857 from = XLFD_PIXEL_INDEX, to = XLFD_AVGWIDTH_INDEX,
858 mask = XLFD_PIXEL_MASK | XLFD_LARGENUM_MASK;
859 else if (numeric <= 48)
860 from = to = XLFD_PIXEL_INDEX,
861 mask = XLFD_PIXEL_MASK;
862 else
863 from = XLFD_POINT_INDEX, to = XLFD_AVGWIDTH_INDEX,
864 mask = XLFD_LARGENUM_MASK;
866 else if (SBYTES (SYMBOL_NAME (val)) == 0)
867 from = XLFD_FOUNDRY_INDEX, to = XLFD_ADSTYLE_INDEX,
868 mask = XLFD_NULL_MASK;
869 else if (i == 0)
870 from = to = XLFD_FOUNDRY_INDEX, mask = XLFD_FOUNDRY_MASK;
871 else if (i + 1 == n)
873 Lisp_Object name = SYMBOL_NAME (val);
875 if (SDATA (name)[SBYTES (name) - 1] == '*')
876 from = XLFD_REGISTRY_INDEX, to = XLFD_ENCODING_INDEX,
877 mask = XLFD_REGENC_MASK;
878 else
879 from = to = XLFD_ENCODING_INDEX,
880 mask = XLFD_ENCODING_MASK;
882 else if (range_from <= XLFD_WEIGHT_INDEX
883 && range_to >= XLFD_WEIGHT_INDEX
884 && FONT_WEIGHT_NAME_NUMERIC (val) >= 0)
885 from = to = XLFD_WEIGHT_INDEX, mask = XLFD_WEIGHT_MASK;
886 else if (range_from <= XLFD_SLANT_INDEX
887 && range_to >= XLFD_SLANT_INDEX
888 && FONT_SLANT_NAME_NUMERIC (val) >= 0)
889 from = to = XLFD_SLANT_INDEX, mask = XLFD_SLANT_MASK;
890 else if (range_from <= XLFD_SWIDTH_INDEX
891 && range_to >= XLFD_SWIDTH_INDEX
892 && FONT_WIDTH_NAME_NUMERIC (val) >= 0)
893 from = to = XLFD_SWIDTH_INDEX, mask = XLFD_SWIDTH_MASK;
894 else
896 if (EQ (val, Qc) || EQ (val, Qm) || EQ (val, Qp) || EQ (val, Qd))
897 from = to = XLFD_SPACING_INDEX, mask = XLFD_SPACING_MASK;
898 else
899 from = XLFD_FOUNDRY_INDEX, to = XLFD_ENCODING_INDEX,
900 mask = XLFD_SYMBOL_MASK;
903 /* Merge position-based and value-based restrictions. */
904 mask &= range_mask;
905 while (from < range_from)
906 mask &= ~(1 << from++);
907 while (from < 14 && ! (mask & (1 << from)))
908 from++;
909 while (to > range_to)
910 mask &= ~(1 << to--);
911 while (to >= 0 && ! (mask & (1 << to)))
912 to--;
913 if (from > to)
914 return -1;
915 range[i].from = from;
916 range[i].to = to;
917 range[i].mask = mask;
919 if (from > range_from || to < range_to)
921 /* The range is narrowed by value-based restrictions.
922 Reflect it to the other fields. */
924 /* Following fields should be after FROM. */
925 range_from = from;
926 /* Preceding fields should be before TO. */
927 for (j = i - 1, from--, to--; j >= 0; j--, from--, to--)
929 /* Check FROM for non-wildcard field. */
930 if (! NILP (tmp[j]) && range[j].from < from)
932 while (range[j].from < from)
933 range[j].mask &= ~(1 << range[j].from++);
934 while (from < 14 && ! (range[j].mask & (1 << from)))
935 from++;
936 range[j].from = from;
938 else
939 from = range[j].from;
940 if (range[j].to > to)
942 while (range[j].to > to)
943 range[j].mask &= ~(1 << range[j].to--);
944 while (to >= 0 && ! (range[j].mask & (1 << to)))
945 to--;
946 range[j].to = to;
948 else
949 to = range[j].to;
950 if (from > to)
951 return -1;
957 /* Decide all fields from restrictions in RANGE. */
958 for (i = j = 0; i < n ; i++)
960 if (j < range[i].from)
962 if (i == 0 || ! NILP (tmp[i - 1]))
963 /* None of TMP[X] corresponds to Jth field. */
964 return -1;
965 for (; j < range[i].from; j++)
966 field[j] = Qnil;
968 field[j++] = tmp[i];
970 if (! NILP (tmp[n - 1]) && j < XLFD_REGISTRY_INDEX)
971 return -1;
972 for (; j < XLFD_LAST_INDEX; j++)
973 field[j] = Qnil;
974 if (INTEGERP (field[XLFD_ENCODING_INDEX]))
975 field[XLFD_ENCODING_INDEX]
976 = Fintern (Fnumber_to_string (field[XLFD_ENCODING_INDEX]), Qnil);
977 return 0;
981 /* Parse NAME (null terminated) as XLFD and store information in FONT
982 (font-spec or font-entity). Size property of FONT is set as
983 follows:
984 specified XLFD fields FONT property
985 --------------------- -------------
986 PIXEL_SIZE PIXEL_SIZE (Lisp integer)
987 POINT_SIZE and RESY calculated pixel size (Lisp integer)
988 POINT_SIZE POINT_SIZE/10 (Lisp float)
990 If NAME is successfully parsed, return 0. Otherwise return -1.
992 FONT is usually a font-spec, but when this function is called from
993 X font backend driver, it is a font-entity. In that case, NAME is
994 a fully specified XLFD. */
997 font_parse_xlfd (char *name, Lisp_Object font)
999 ptrdiff_t len = strlen (name);
1000 int i, j, n;
1001 char *f[XLFD_LAST_INDEX + 1];
1002 Lisp_Object val;
1003 char *p;
1005 if (len > 255 || !len)
1006 /* Maximum XLFD name length is 255. */
1007 return -1;
1008 /* Accept "*-.." as a fully specified XLFD. */
1009 if (name[0] == '*' && (len == 1 || name[1] == '-'))
1010 i = 1, f[XLFD_FOUNDRY_INDEX] = name;
1011 else
1012 i = 0;
1013 for (p = name + i; *p; p++)
1014 if (*p == '-')
1016 f[i++] = p + 1;
1017 if (i == XLFD_LAST_INDEX)
1018 break;
1020 f[i] = name + len;
1022 #define INTERN_FIELD(N) font_intern_prop (f[N], f[(N) + 1] - 1 - f[N], 0)
1023 #define INTERN_FIELD_SYM(N) font_intern_prop (f[N], f[(N) + 1] - 1 - f[N], 1)
1025 if (i == XLFD_LAST_INDEX)
1027 /* Fully specified XLFD. */
1028 int pixel_size;
1030 ASET (font, FONT_FOUNDRY_INDEX, INTERN_FIELD_SYM (XLFD_FOUNDRY_INDEX));
1031 ASET (font, FONT_FAMILY_INDEX, INTERN_FIELD_SYM (XLFD_FAMILY_INDEX));
1032 for (i = XLFD_WEIGHT_INDEX, j = FONT_WEIGHT_INDEX;
1033 i <= XLFD_SWIDTH_INDEX; i++, j++)
1035 val = INTERN_FIELD_SYM (i);
1036 if (! NILP (val))
1038 if ((n = font_style_to_value (j, INTERN_FIELD_SYM (i), 0)) < 0)
1039 return -1;
1040 ASET (font, j, make_number (n));
1043 ASET (font, FONT_ADSTYLE_INDEX, INTERN_FIELD_SYM (XLFD_ADSTYLE_INDEX));
1044 if (strcmp (f[XLFD_REGISTRY_INDEX], "*-*") == 0)
1045 ASET (font, FONT_REGISTRY_INDEX, Qnil);
1046 else
1047 ASET (font, FONT_REGISTRY_INDEX,
1048 font_intern_prop (f[XLFD_REGISTRY_INDEX],
1049 f[XLFD_LAST_INDEX] - f[XLFD_REGISTRY_INDEX],
1050 1));
1051 p = f[XLFD_PIXEL_INDEX];
1052 if (*p == '[' && (pixel_size = parse_matrix (p)) >= 0)
1053 ASET (font, FONT_SIZE_INDEX, make_number (pixel_size));
1054 else
1056 val = INTERN_FIELD (XLFD_PIXEL_INDEX);
1057 if (INTEGERP (val))
1058 ASET (font, FONT_SIZE_INDEX, val);
1059 else if (FONT_ENTITY_P (font))
1060 return -1;
1061 else
1063 double point_size = -1;
1065 font_assert (FONT_SPEC_P (font));
1066 p = f[XLFD_POINT_INDEX];
1067 if (*p == '[')
1068 point_size = parse_matrix (p);
1069 else if (isdigit (*p))
1070 point_size = atoi (p), point_size /= 10;
1071 if (point_size >= 0)
1072 ASET (font, FONT_SIZE_INDEX, make_float (point_size));
1076 val = INTERN_FIELD (XLFD_RESY_INDEX);
1077 if (! NILP (val) && ! INTEGERP (val))
1078 return -1;
1079 ASET (font, FONT_DPI_INDEX, val);
1080 val = INTERN_FIELD (XLFD_SPACING_INDEX);
1081 if (! NILP (val))
1083 val = font_prop_validate_spacing (QCspacing, val);
1084 if (! INTEGERP (val))
1085 return -1;
1086 ASET (font, FONT_SPACING_INDEX, val);
1088 p = f[XLFD_AVGWIDTH_INDEX];
1089 if (*p == '~')
1090 p++;
1091 val = font_intern_prop (p, f[XLFD_REGISTRY_INDEX] - 1 - p, 0);
1092 if (! NILP (val) && ! INTEGERP (val))
1093 return -1;
1094 ASET (font, FONT_AVGWIDTH_INDEX, val);
1096 else
1098 int wild_card_found = 0;
1099 Lisp_Object prop[XLFD_LAST_INDEX];
1101 if (FONT_ENTITY_P (font))
1102 return -1;
1103 for (j = 0; j < i; j++)
1105 if (*f[j] == '*')
1107 if (f[j][1] && f[j][1] != '-')
1108 return -1;
1109 prop[j] = Qnil;
1110 wild_card_found = 1;
1112 else if (j + 1 < i)
1113 prop[j] = INTERN_FIELD (j);
1114 else
1115 prop[j] = font_intern_prop (f[j], f[i] - f[j], 0);
1117 if (! wild_card_found)
1118 return -1;
1119 if (font_expand_wildcards (prop, i) < 0)
1120 return -1;
1122 ASET (font, FONT_FOUNDRY_INDEX, prop[XLFD_FOUNDRY_INDEX]);
1123 ASET (font, FONT_FAMILY_INDEX, prop[XLFD_FAMILY_INDEX]);
1124 for (i = XLFD_WEIGHT_INDEX, j = FONT_WEIGHT_INDEX;
1125 i <= XLFD_SWIDTH_INDEX; i++, j++)
1126 if (! NILP (prop[i]))
1128 if ((n = font_style_to_value (j, prop[i], 1)) < 0)
1129 return -1;
1130 ASET (font, j, make_number (n));
1132 ASET (font, FONT_ADSTYLE_INDEX, prop[XLFD_ADSTYLE_INDEX]);
1133 val = prop[XLFD_REGISTRY_INDEX];
1134 if (NILP (val))
1136 val = prop[XLFD_ENCODING_INDEX];
1137 if (! NILP (val))
1138 val = concat2 (build_string ("*-"), SYMBOL_NAME (val));
1140 else if (NILP (prop[XLFD_ENCODING_INDEX]))
1141 val = concat2 (SYMBOL_NAME (val), build_string ("-*"));
1142 else
1143 val = concat3 (SYMBOL_NAME (val), build_string ("-"),
1144 SYMBOL_NAME (prop[XLFD_ENCODING_INDEX]));
1145 if (! NILP (val))
1146 ASET (font, FONT_REGISTRY_INDEX, Fintern (val, Qnil));
1148 if (INTEGERP (prop[XLFD_PIXEL_INDEX]))
1149 ASET (font, FONT_SIZE_INDEX, prop[XLFD_PIXEL_INDEX]);
1150 else if (INTEGERP (prop[XLFD_POINT_INDEX]))
1152 double point_size = XINT (prop[XLFD_POINT_INDEX]);
1154 ASET (font, FONT_SIZE_INDEX, make_float (point_size / 10));
1157 if (INTEGERP (prop[XLFD_RESX_INDEX]))
1158 ASET (font, FONT_DPI_INDEX, prop[XLFD_RESY_INDEX]);
1159 if (! NILP (prop[XLFD_SPACING_INDEX]))
1161 val = font_prop_validate_spacing (QCspacing,
1162 prop[XLFD_SPACING_INDEX]);
1163 if (! INTEGERP (val))
1164 return -1;
1165 ASET (font, FONT_SPACING_INDEX, val);
1167 if (INTEGERP (prop[XLFD_AVGWIDTH_INDEX]))
1168 ASET (font, FONT_AVGWIDTH_INDEX, prop[XLFD_AVGWIDTH_INDEX]);
1171 return 0;
1174 /* Store XLFD name of FONT (font-spec or font-entity) in NAME (NBYTES
1175 length), and return the name length. If FONT_SIZE_INDEX of FONT is
1176 0, use PIXEL_SIZE instead. */
1179 font_unparse_xlfd (Lisp_Object font, int pixel_size, char *name, int nbytes)
1181 char *p;
1182 const char *f[XLFD_REGISTRY_INDEX + 1];
1183 Lisp_Object val;
1184 int i, j, len;
1186 font_assert (FONTP (font));
1188 for (i = FONT_FOUNDRY_INDEX, j = XLFD_FOUNDRY_INDEX; i <= FONT_REGISTRY_INDEX;
1189 i++, j++)
1191 if (i == FONT_ADSTYLE_INDEX)
1192 j = XLFD_ADSTYLE_INDEX;
1193 else if (i == FONT_REGISTRY_INDEX)
1194 j = XLFD_REGISTRY_INDEX;
1195 val = AREF (font, i);
1196 if (NILP (val))
1198 if (j == XLFD_REGISTRY_INDEX)
1199 f[j] = "*-*";
1200 else
1201 f[j] = "*";
1203 else
1205 if (SYMBOLP (val))
1206 val = SYMBOL_NAME (val);
1207 if (j == XLFD_REGISTRY_INDEX
1208 && ! strchr (SSDATA (val), '-'))
1210 /* Change "jisx0208*" and "jisx0208" to "jisx0208*-*". */
1211 ptrdiff_t alloc = SBYTES (val) + 4;
1212 if (nbytes <= alloc)
1213 return -1;
1214 f[j] = p = alloca (alloc);
1215 sprintf (p, "%s%s-*", SDATA (val),
1216 "*" + (SDATA (val)[SBYTES (val) - 1] == '*'));
1218 else
1219 f[j] = SSDATA (val);
1223 for (i = FONT_WEIGHT_INDEX, j = XLFD_WEIGHT_INDEX; i <= FONT_WIDTH_INDEX;
1224 i++, j++)
1226 val = font_style_symbolic (font, i, 0);
1227 if (NILP (val))
1228 f[j] = "*";
1229 else
1231 val = SYMBOL_NAME (val);
1232 f[j] = SSDATA (val);
1236 val = AREF (font, FONT_SIZE_INDEX);
1237 font_assert (NUMBERP (val) || NILP (val));
1238 if (INTEGERP (val))
1240 EMACS_INT v = XINT (val);
1241 if (v <= 0)
1242 v = pixel_size;
1243 if (v > 0)
1245 f[XLFD_PIXEL_INDEX] = p =
1246 alloca (sizeof "-*" + INT_STRLEN_BOUND (EMACS_INT));
1247 sprintf (p, "%"pI"d-*", v);
1249 else
1250 f[XLFD_PIXEL_INDEX] = "*-*";
1252 else if (FLOATP (val))
1254 double v = XFLOAT_DATA (val) * 10;
1255 f[XLFD_PIXEL_INDEX] = p = alloca (sizeof "*-" + 1 + DBL_MAX_10_EXP + 1);
1256 sprintf (p, "*-%.0f", v);
1258 else
1259 f[XLFD_PIXEL_INDEX] = "*-*";
1261 if (INTEGERP (AREF (font, FONT_DPI_INDEX)))
1263 EMACS_INT v = XINT (AREF (font, FONT_DPI_INDEX));
1264 f[XLFD_RESX_INDEX] = p =
1265 alloca (sizeof "-" + 2 * INT_STRLEN_BOUND (EMACS_INT));
1266 sprintf (p, "%"pI"d-%"pI"d", v, v);
1268 else
1269 f[XLFD_RESX_INDEX] = "*-*";
1270 if (INTEGERP (AREF (font, FONT_SPACING_INDEX)))
1272 EMACS_INT spacing = XINT (AREF (font, FONT_SPACING_INDEX));
1274 f[XLFD_SPACING_INDEX] = (spacing <= FONT_SPACING_PROPORTIONAL ? "p"
1275 : spacing <= FONT_SPACING_DUAL ? "d"
1276 : spacing <= FONT_SPACING_MONO ? "m"
1277 : "c");
1279 else
1280 f[XLFD_SPACING_INDEX] = "*";
1281 if (INTEGERP (AREF (font, FONT_AVGWIDTH_INDEX)))
1283 f[XLFD_AVGWIDTH_INDEX] = p = alloca (INT_BUFSIZE_BOUND (EMACS_INT));
1284 sprintf (p, "%"pI"d", XINT (AREF (font, FONT_AVGWIDTH_INDEX)));
1286 else
1287 f[XLFD_AVGWIDTH_INDEX] = "*";
1288 len = snprintf (name, nbytes, "-%s-%s-%s-%s-%s-%s-%s-%s-%s-%s-%s",
1289 f[XLFD_FOUNDRY_INDEX], f[XLFD_FAMILY_INDEX],
1290 f[XLFD_WEIGHT_INDEX], f[XLFD_SLANT_INDEX],
1291 f[XLFD_SWIDTH_INDEX], f[XLFD_ADSTYLE_INDEX],
1292 f[XLFD_PIXEL_INDEX], f[XLFD_RESX_INDEX],
1293 f[XLFD_SPACING_INDEX], f[XLFD_AVGWIDTH_INDEX],
1294 f[XLFD_REGISTRY_INDEX]);
1295 return len < nbytes ? len : -1;
1298 /* Parse NAME (null terminated) and store information in FONT
1299 (font-spec or font-entity). NAME is supplied in either the
1300 Fontconfig or GTK font name format. If NAME is successfully
1301 parsed, return 0. Otherwise return -1.
1303 The fontconfig format is
1305 FAMILY[-SIZE][:PROP1[=VAL1][:PROP2[=VAL2]...]]
1307 The GTK format is
1309 FAMILY [PROPS...] [SIZE]
1311 This function tries to guess which format it is. */
1313 static int
1314 font_parse_fcname (char *name, Lisp_Object font)
1316 char *p, *q;
1317 char *size_beg = NULL, *size_end = NULL;
1318 char *props_beg = NULL, *family_end = NULL;
1319 ptrdiff_t len = strlen (name);
1321 if (len == 0)
1322 return -1;
1324 for (p = name; *p; p++)
1326 if (*p == '\\' && p[1])
1327 p++;
1328 else if (*p == ':')
1330 props_beg = family_end = p;
1331 break;
1333 else if (*p == '-')
1335 int decimal = 0, size_found = 1;
1336 for (q = p + 1; *q && *q != ':'; q++)
1337 if (! isdigit (*q))
1339 if (*q != '.' || decimal)
1341 size_found = 0;
1342 break;
1344 decimal = 1;
1346 if (size_found)
1348 family_end = p;
1349 size_beg = p + 1;
1350 size_end = q;
1351 break;
1356 if (family_end)
1358 Lisp_Object extra_props = Qnil;
1360 /* A fontconfig name with size and/or property data. */
1361 if (family_end > name)
1363 Lisp_Object family;
1364 family = font_intern_prop (name, family_end - name, 1);
1365 ASET (font, FONT_FAMILY_INDEX, family);
1367 if (size_beg)
1369 double point_size = strtod (size_beg, &size_end);
1370 ASET (font, FONT_SIZE_INDEX, make_float (point_size));
1371 if (*size_end == ':' && size_end[1])
1372 props_beg = size_end;
1374 if (props_beg)
1376 /* Now parse ":KEY=VAL" patterns. */
1377 Lisp_Object val;
1379 for (p = props_beg; *p; p = q)
1381 for (q = p + 1; *q && *q != '=' && *q != ':'; q++);
1382 if (*q != '=')
1384 /* Must be an enumerated value. */
1385 ptrdiff_t word_len;
1386 p = p + 1;
1387 word_len = q - p;
1388 val = font_intern_prop (p, q - p, 1);
1390 #define PROP_MATCH(STR) (word_len == strlen (STR) \
1391 && memcmp (p, STR, strlen (STR)) == 0)
1393 if (PROP_MATCH ("light")
1394 || PROP_MATCH ("medium")
1395 || PROP_MATCH ("demibold")
1396 || PROP_MATCH ("bold")
1397 || PROP_MATCH ("black"))
1398 FONT_SET_STYLE (font, FONT_WEIGHT_INDEX, val);
1399 else if (PROP_MATCH ("roman")
1400 || PROP_MATCH ("italic")
1401 || PROP_MATCH ("oblique"))
1402 FONT_SET_STYLE (font, FONT_SLANT_INDEX, val);
1403 else if (PROP_MATCH ("charcell"))
1404 ASET (font, FONT_SPACING_INDEX,
1405 make_number (FONT_SPACING_CHARCELL));
1406 else if (PROP_MATCH ("mono"))
1407 ASET (font, FONT_SPACING_INDEX,
1408 make_number (FONT_SPACING_MONO));
1409 else if (PROP_MATCH ("proportional"))
1410 ASET (font, FONT_SPACING_INDEX,
1411 make_number (FONT_SPACING_PROPORTIONAL));
1412 #undef PROP_MATCH
1414 else
1416 /* KEY=VAL pairs */
1417 Lisp_Object key;
1418 int prop;
1420 if (q - p == 10 && memcmp (p + 1, "pixelsize", 9) == 0)
1421 prop = FONT_SIZE_INDEX;
1422 else
1424 key = font_intern_prop (p, q - p, 1);
1425 prop = get_font_prop_index (key);
1428 p = q + 1;
1429 for (q = p; *q && *q != ':'; q++);
1430 val = font_intern_prop (p, q - p, 0);
1432 if (prop >= FONT_FOUNDRY_INDEX
1433 && prop < FONT_EXTRA_INDEX)
1434 ASET (font, prop, font_prop_validate (prop, Qnil, val));
1435 else
1437 extra_props = nconc2 (extra_props,
1438 Fcons (Fcons (key, val), Qnil));
1441 p = q;
1445 if (! NILP (extra_props))
1447 struct font_driver_list *driver_list = font_driver_list;
1448 for ( ; driver_list; driver_list = driver_list->next)
1449 if (driver_list->driver->filter_properties)
1450 (*driver_list->driver->filter_properties) (font, extra_props);
1454 else
1456 /* Either a fontconfig-style name with no size and property
1457 data, or a GTK-style name. */
1458 Lisp_Object weight = Qnil, slant = Qnil;
1459 Lisp_Object width = Qnil, size = Qnil;
1460 char *word_start;
1461 ptrdiff_t word_len;
1463 /* Scan backwards from the end, looking for a size. */
1464 for (p = name + len - 1; p >= name; p--)
1465 if (!isdigit (*p))
1466 break;
1468 if ((p < name + len - 1) && ((p + 1 == name) || *p == ' '))
1469 /* Found a font size. */
1470 size = make_float (strtod (p + 1, NULL));
1471 else
1472 p = name + len;
1474 /* Now P points to the termination of the string, sans size.
1475 Scan backwards, looking for font properties. */
1476 for (; p > name; p = q)
1478 for (q = p - 1; q >= name; q--)
1480 if (q > name && *(q-1) == '\\')
1481 --q; /* Skip quoting backslashes. */
1482 else if (*q == ' ')
1483 break;
1486 word_start = q + 1;
1487 word_len = p - word_start;
1489 #define PROP_MATCH(STR) \
1490 (word_len == strlen (STR) \
1491 && memcmp (word_start, STR, strlen (STR)) == 0)
1492 #define PROP_SAVE(VAR, STR) \
1493 (VAR = NILP (VAR) ? font_intern_prop (STR, strlen (STR), 1) : VAR)
1495 if (PROP_MATCH ("Ultra-Light"))
1496 PROP_SAVE (weight, "ultra-light");
1497 else if (PROP_MATCH ("Light"))
1498 PROP_SAVE (weight, "light");
1499 else if (PROP_MATCH ("Book"))
1500 PROP_SAVE (weight, "book");
1501 else if (PROP_MATCH ("Medium"))
1502 PROP_SAVE (weight, "medium");
1503 else if (PROP_MATCH ("Semi-Bold"))
1504 PROP_SAVE (weight, "semi-bold");
1505 else if (PROP_MATCH ("Bold"))
1506 PROP_SAVE (weight, "bold");
1507 else if (PROP_MATCH ("Italic"))
1508 PROP_SAVE (slant, "italic");
1509 else if (PROP_MATCH ("Oblique"))
1510 PROP_SAVE (slant, "oblique");
1511 else if (PROP_MATCH ("Semi-Condensed"))
1512 PROP_SAVE (width, "semi-condensed");
1513 else if (PROP_MATCH ("Condensed"))
1514 PROP_SAVE (width, "condensed");
1515 /* An unknown word must be part of the font name. */
1516 else
1518 family_end = p;
1519 break;
1522 #undef PROP_MATCH
1523 #undef PROP_SAVE
1525 if (family_end)
1526 ASET (font, FONT_FAMILY_INDEX,
1527 font_intern_prop (name, family_end - name, 1));
1528 if (!NILP (size))
1529 ASET (font, FONT_SIZE_INDEX, size);
1530 if (!NILP (weight))
1531 FONT_SET_STYLE (font, FONT_WEIGHT_INDEX, weight);
1532 if (!NILP (slant))
1533 FONT_SET_STYLE (font, FONT_SLANT_INDEX, slant);
1534 if (!NILP (width))
1535 FONT_SET_STYLE (font, FONT_WIDTH_INDEX, width);
1538 return 0;
1541 /* Store fontconfig's font name of FONT (font-spec or font-entity) in
1542 NAME (NBYTES length), and return the name length. If
1543 FONT_SIZE_INDEX of FONT is 0, use PIXEL_SIZE instead. */
1546 font_unparse_fcname (Lisp_Object font, int pixel_size, char *name, int nbytes)
1548 Lisp_Object family, foundry;
1549 Lisp_Object val;
1550 int point_size;
1551 int i;
1552 char *p;
1553 char *lim;
1554 Lisp_Object styles[3];
1555 const char *style_names[3] = { "weight", "slant", "width" };
1557 family = AREF (font, FONT_FAMILY_INDEX);
1558 if (! NILP (family))
1560 if (SYMBOLP (family))
1561 family = SYMBOL_NAME (family);
1562 else
1563 family = Qnil;
1566 val = AREF (font, FONT_SIZE_INDEX);
1567 if (INTEGERP (val))
1569 if (XINT (val) != 0)
1570 pixel_size = XINT (val);
1571 point_size = -1;
1573 else
1575 if (! FLOATP (val))
1576 abort ();
1577 pixel_size = -1;
1578 point_size = (int) XFLOAT_DATA (val);
1581 foundry = AREF (font, FONT_FOUNDRY_INDEX);
1582 if (! NILP (foundry))
1584 if (SYMBOLP (foundry))
1585 foundry = SYMBOL_NAME (foundry);
1586 else
1587 foundry = Qnil;
1590 for (i = 0; i < 3; i++)
1591 styles[i] = font_style_symbolic (font, FONT_WEIGHT_INDEX + i, 0);
1593 p = name;
1594 lim = name + nbytes;
1595 if (! NILP (family))
1597 int len = snprintf (p, lim - p, "%s", SSDATA (family));
1598 if (! (0 <= len && len < lim - p))
1599 return -1;
1600 p += len;
1602 if (point_size > 0)
1604 int len = snprintf (p, lim - p, "-%d" + (p == name), point_size);
1605 if (! (0 <= len && len < lim - p))
1606 return -1;
1607 p += len;
1609 else if (pixel_size > 0)
1611 int len = snprintf (p, lim - p, ":pixelsize=%d", pixel_size);
1612 if (! (0 <= len && len < lim - p))
1613 return -1;
1614 p += len;
1616 if (! NILP (AREF (font, FONT_FOUNDRY_INDEX)))
1618 int len = snprintf (p, lim - p, ":foundry=%s",
1619 SSDATA (SYMBOL_NAME (AREF (font,
1620 FONT_FOUNDRY_INDEX))));
1621 if (! (0 <= len && len < lim - p))
1622 return -1;
1623 p += len;
1625 for (i = 0; i < 3; i++)
1626 if (! NILP (styles[i]))
1628 int len = snprintf (p, lim - p, ":%s=%s", style_names[i],
1629 SSDATA (SYMBOL_NAME (styles[i])));
1630 if (! (0 <= len && len < lim - p))
1631 return -1;
1632 p += len;
1635 if (INTEGERP (AREF (font, FONT_DPI_INDEX)))
1637 int len = snprintf (p, lim - p, ":dpi=%"pI"d",
1638 XINT (AREF (font, FONT_DPI_INDEX)));
1639 if (! (0 <= len && len < lim - p))
1640 return -1;
1641 p += len;
1644 if (INTEGERP (AREF (font, FONT_SPACING_INDEX)))
1646 int len = snprintf (p, lim - p, ":spacing=%"pI"d",
1647 XINT (AREF (font, FONT_SPACING_INDEX)));
1648 if (! (0 <= len && len < lim - p))
1649 return -1;
1650 p += len;
1653 if (INTEGERP (AREF (font, FONT_AVGWIDTH_INDEX)))
1655 int len = snprintf (p, lim - p,
1656 (XINT (AREF (font, FONT_AVGWIDTH_INDEX)) == 0
1657 ? ":scalable=true"
1658 : ":scalable=false"));
1659 if (! (0 <= len && len < lim - p))
1660 return -1;
1661 p += len;
1664 return (p - name);
1667 /* Parse NAME (null terminated) and store information in FONT
1668 (font-spec or font-entity). If NAME is successfully parsed, return
1669 0. Otherwise return -1. */
1671 static int
1672 font_parse_name (char *name, Lisp_Object font)
1674 if (name[0] == '-' || strchr (name, '*') || strchr (name, '?'))
1675 return font_parse_xlfd (name, font);
1676 return font_parse_fcname (name, font);
1680 /* Merge FAMILY and REGISTRY into FONT_SPEC. FAMILY may have the form
1681 "FAMILY-FOUNDRY". REGISTRY may not contain charset-encoding
1682 part. */
1684 void
1685 font_parse_family_registry (Lisp_Object family, Lisp_Object registry, Lisp_Object font_spec)
1687 int len;
1688 char *p0, *p1;
1690 if (! NILP (family)
1691 && NILP (AREF (font_spec, FONT_FAMILY_INDEX)))
1693 CHECK_STRING (family);
1694 len = SBYTES (family);
1695 p0 = SSDATA (family);
1696 p1 = strchr (p0, '-');
1697 if (p1)
1699 if ((*p0 != '*' && p1 - p0 > 0)
1700 && NILP (AREF (font_spec, FONT_FOUNDRY_INDEX)))
1701 Ffont_put (font_spec, QCfoundry, font_intern_prop (p0, p1 - p0, 1));
1702 p1++;
1703 len -= p1 - p0;
1704 Ffont_put (font_spec, QCfamily, font_intern_prop (p1, len, 1));
1706 else
1707 ASET (font_spec, FONT_FAMILY_INDEX, Fintern (family, Qnil));
1709 if (! NILP (registry))
1711 /* Convert "XXX" and "XXX*" to "XXX*-*". */
1712 CHECK_STRING (registry);
1713 len = SBYTES (registry);
1714 p0 = SSDATA (registry);
1715 p1 = strchr (p0, '-');
1716 if (! p1)
1718 if (SDATA (registry)[len - 1] == '*')
1719 registry = concat2 (registry, build_string ("-*"));
1720 else
1721 registry = concat2 (registry, build_string ("*-*"));
1723 registry = Fdowncase (registry);
1724 ASET (font_spec, FONT_REGISTRY_INDEX, Fintern (registry, Qnil));
1729 /* This part (through the next ^L) is still experimental and not
1730 tested much. We may drastically change codes. */
1732 /* OTF handler */
1734 #if 0
1736 #define LGSTRING_HEADER_SIZE 6
1737 #define LGSTRING_GLYPH_SIZE 8
1739 static int
1740 check_gstring (Lisp_Object gstring)
1742 Lisp_Object val;
1743 int i, j;
1745 CHECK_VECTOR (gstring);
1746 val = AREF (gstring, 0);
1747 CHECK_VECTOR (val);
1748 if (ASIZE (val) < LGSTRING_HEADER_SIZE)
1749 goto err;
1750 CHECK_FONT_OBJECT (LGSTRING_FONT (gstring));
1751 if (!NILP (LGSTRING_SLOT (gstring, LGSTRING_IX_LBEARING)))
1752 CHECK_NUMBER (LGSTRING_SLOT (gstring, LGSTRING_IX_LBEARING));
1753 if (!NILP (LGSTRING_SLOT (gstring, LGSTRING_IX_RBEARING)))
1754 CHECK_NUMBER (LGSTRING_SLOT (gstring, LGSTRING_IX_RBEARING));
1755 if (!NILP (LGSTRING_SLOT (gstring, LGSTRING_IX_WIDTH)))
1756 CHECK_NATNUM (LGSTRING_SLOT (gstring, LGSTRING_IX_WIDTH));
1757 if (!NILP (LGSTRING_SLOT (gstring, LGSTRING_IX_ASCENT)))
1758 CHECK_NUMBER (LGSTRING_SLOT (gstring, LGSTRING_IX_ASCENT));
1759 if (!NILP (LGSTRING_SLOT (gstring, LGSTRING_IX_ASCENT)))
1760 CHECK_NUMBER (LGSTRING_SLOT (gstring, LGSTRING_IX_ASCENT));
1762 for (i = 0; i < LGSTRING_GLYPH_LEN (gstring); i++)
1764 val = LGSTRING_GLYPH (gstring, i);
1765 CHECK_VECTOR (val);
1766 if (ASIZE (val) < LGSTRING_GLYPH_SIZE)
1767 goto err;
1768 if (NILP (AREF (val, LGLYPH_IX_CHAR)))
1769 break;
1770 CHECK_NATNUM (AREF (val, LGLYPH_IX_FROM));
1771 CHECK_NATNUM (AREF (val, LGLYPH_IX_TO));
1772 CHECK_CHARACTER (AREF (val, LGLYPH_IX_CHAR));
1773 if (!NILP (AREF (val, LGLYPH_IX_CODE)))
1774 CHECK_NATNUM (AREF (val, LGLYPH_IX_CODE));
1775 if (!NILP (AREF (val, LGLYPH_IX_WIDTH)))
1776 CHECK_NATNUM (AREF (val, LGLYPH_IX_WIDTH));
1777 if (!NILP (AREF (val, LGLYPH_IX_ADJUSTMENT)))
1779 val = AREF (val, LGLYPH_IX_ADJUSTMENT);
1780 CHECK_VECTOR (val);
1781 if (ASIZE (val) < 3)
1782 goto err;
1783 for (j = 0; j < 3; j++)
1784 CHECK_NUMBER (AREF (val, j));
1787 return i;
1788 err:
1789 error ("Invalid glyph-string format");
1790 return -1;
1793 static void
1794 check_otf_features (Lisp_Object otf_features)
1796 Lisp_Object val;
1798 CHECK_CONS (otf_features);
1799 CHECK_SYMBOL (XCAR (otf_features));
1800 otf_features = XCDR (otf_features);
1801 CHECK_CONS (otf_features);
1802 CHECK_SYMBOL (XCAR (otf_features));
1803 otf_features = XCDR (otf_features);
1804 for (val = Fcar (otf_features); ! NILP (val); val = Fcdr (val))
1806 CHECK_SYMBOL (Fcar (val));
1807 if (SBYTES (SYMBOL_NAME (XCAR (val))) > 4)
1808 error ("Invalid OTF GSUB feature: %s",
1809 SDATA (SYMBOL_NAME (XCAR (val))));
1811 otf_features = XCDR (otf_features);
1812 for (val = Fcar (otf_features); ! NILP (val); val = Fcdr (val))
1814 CHECK_SYMBOL (Fcar (val));
1815 if (SBYTES (SYMBOL_NAME (XCAR (val))) > 4)
1816 error ("Invalid OTF GPOS feature: %s",
1817 SDATA (SYMBOL_NAME (XCAR (val))));
1821 #ifdef HAVE_LIBOTF
1822 #include <otf.h>
1824 Lisp_Object otf_list;
1826 static Lisp_Object
1827 otf_tag_symbol (OTF_Tag tag)
1829 char name[5];
1831 OTF_tag_name (tag, name);
1832 return Fintern (make_unibyte_string (name, 4), Qnil);
1835 static OTF *
1836 otf_open (Lisp_Object file)
1838 Lisp_Object val = Fassoc (file, otf_list);
1839 OTF *otf;
1841 if (! NILP (val))
1842 otf = XSAVE_VALUE (XCDR (val))->pointer;
1843 else
1845 otf = STRINGP (file) ? OTF_open (SSDATA (file)) : NULL;
1846 val = make_save_value (otf, 0);
1847 otf_list = Fcons (Fcons (file, val), otf_list);
1849 return otf;
1853 /* Return a list describing which scripts/languages FONT supports by
1854 which GSUB/GPOS features of OpenType tables. See the comment of
1855 (struct font_driver).otf_capability. */
1857 Lisp_Object
1858 font_otf_capability (struct font *font)
1860 OTF *otf;
1861 Lisp_Object capability = Fcons (Qnil, Qnil);
1862 int i;
1864 otf = otf_open (font->props[FONT_FILE_INDEX]);
1865 if (! otf)
1866 return Qnil;
1867 for (i = 0; i < 2; i++)
1869 OTF_GSUB_GPOS *gsub_gpos;
1870 Lisp_Object script_list = Qnil;
1871 int j;
1873 if (OTF_get_features (otf, i == 0) < 0)
1874 continue;
1875 gsub_gpos = i == 0 ? otf->gsub : otf->gpos;
1876 for (j = gsub_gpos->ScriptList.ScriptCount - 1; j >= 0; j--)
1878 OTF_Script *script = gsub_gpos->ScriptList.Script + j;
1879 Lisp_Object langsys_list = Qnil;
1880 Lisp_Object script_tag = otf_tag_symbol (script->ScriptTag);
1881 int k;
1883 for (k = script->LangSysCount; k >= 0; k--)
1885 OTF_LangSys *langsys;
1886 Lisp_Object feature_list = Qnil;
1887 Lisp_Object langsys_tag;
1888 int l;
1890 if (k == script->LangSysCount)
1892 langsys = &script->DefaultLangSys;
1893 langsys_tag = Qnil;
1895 else
1897 langsys = script->LangSys + k;
1898 langsys_tag
1899 = otf_tag_symbol (script->LangSysRecord[k].LangSysTag);
1901 for (l = langsys->FeatureCount - 1; l >= 0; l--)
1903 OTF_Feature *feature
1904 = gsub_gpos->FeatureList.Feature + langsys->FeatureIndex[l];
1905 Lisp_Object feature_tag
1906 = otf_tag_symbol (feature->FeatureTag);
1908 feature_list = Fcons (feature_tag, feature_list);
1910 langsys_list = Fcons (Fcons (langsys_tag, feature_list),
1911 langsys_list);
1913 script_list = Fcons (Fcons (script_tag, langsys_list),
1914 script_list);
1917 if (i == 0)
1918 XSETCAR (capability, script_list);
1919 else
1920 XSETCDR (capability, script_list);
1923 return capability;
1926 /* Parse OTF features in SPEC and write a proper features spec string
1927 in FEATURES for the call of OTF_drive_gsub/gpos (of libotf). It is
1928 assured that the sufficient memory has already allocated for
1929 FEATURES. */
1931 static void
1932 generate_otf_features (Lisp_Object spec, char *features)
1934 Lisp_Object val;
1935 char *p;
1936 int asterisk;
1938 p = features;
1939 *p = '\0';
1940 for (asterisk = 0; CONSP (spec); spec = XCDR (spec))
1942 val = XCAR (spec);
1943 CHECK_SYMBOL (val);
1944 if (p > features)
1945 *p++ = ',';
1946 if (SREF (SYMBOL_NAME (val), 0) == '*')
1948 asterisk = 1;
1949 *p++ = '*';
1951 else if (! asterisk)
1953 val = SYMBOL_NAME (val);
1954 p += esprintf (p, "%s", SDATA (val));
1956 else
1958 val = SYMBOL_NAME (val);
1959 p += esprintf (p, "~%s", SDATA (val));
1962 if (CONSP (spec))
1963 error ("OTF spec too long");
1966 Lisp_Object
1967 font_otf_DeviceTable (OTF_DeviceTable *device_table)
1969 int len = device_table->StartSize - device_table->EndSize + 1;
1971 return Fcons (make_number (len),
1972 make_unibyte_string (device_table->DeltaValue, len));
1975 Lisp_Object
1976 font_otf_ValueRecord (int value_format, OTF_ValueRecord *value_record)
1978 Lisp_Object val = Fmake_vector (make_number (8), Qnil);
1980 if (value_format & OTF_XPlacement)
1981 ASET (val, 0, make_number (value_record->XPlacement));
1982 if (value_format & OTF_YPlacement)
1983 ASET (val, 1, make_number (value_record->YPlacement));
1984 if (value_format & OTF_XAdvance)
1985 ASET (val, 2, make_number (value_record->XAdvance));
1986 if (value_format & OTF_YAdvance)
1987 ASET (val, 3, make_number (value_record->YAdvance));
1988 if (value_format & OTF_XPlaDevice)
1989 ASET (val, 4, font_otf_DeviceTable (&value_record->XPlaDevice));
1990 if (value_format & OTF_YPlaDevice)
1991 ASET (val, 4, font_otf_DeviceTable (&value_record->YPlaDevice));
1992 if (value_format & OTF_XAdvDevice)
1993 ASET (val, 4, font_otf_DeviceTable (&value_record->XAdvDevice));
1994 if (value_format & OTF_YAdvDevice)
1995 ASET (val, 4, font_otf_DeviceTable (&value_record->YAdvDevice));
1996 return val;
1999 Lisp_Object
2000 font_otf_Anchor (OTF_Anchor *anchor)
2002 Lisp_Object val;
2004 val = Fmake_vector (make_number (anchor->AnchorFormat + 1), Qnil);
2005 ASET (val, 0, make_number (anchor->XCoordinate));
2006 ASET (val, 1, make_number (anchor->YCoordinate));
2007 if (anchor->AnchorFormat == 2)
2008 ASET (val, 2, make_number (anchor->f.f1.AnchorPoint));
2009 else
2011 ASET (val, 3, font_otf_DeviceTable (&anchor->f.f2.XDeviceTable));
2012 ASET (val, 4, font_otf_DeviceTable (&anchor->f.f2.YDeviceTable));
2014 return val;
2016 #endif /* HAVE_LIBOTF */
2017 #endif /* 0 */
2020 /* Font sorting */
2022 static unsigned font_score (Lisp_Object, Lisp_Object *);
2023 static int font_compare (const void *, const void *);
2024 static Lisp_Object font_sort_entities (Lisp_Object, Lisp_Object,
2025 Lisp_Object, int);
2027 static double
2028 font_rescale_ratio (Lisp_Object font_entity)
2030 Lisp_Object tail, elt;
2031 Lisp_Object name = Qnil;
2033 for (tail = Vface_font_rescale_alist; CONSP (tail); tail = XCDR (tail))
2035 elt = XCAR (tail);
2036 if (FLOATP (XCDR (elt)))
2038 if (STRINGP (XCAR (elt)))
2040 if (NILP (name))
2041 name = Ffont_xlfd_name (font_entity, Qnil);
2042 if (fast_string_match_ignore_case (XCAR (elt), name) >= 0)
2043 return XFLOAT_DATA (XCDR (elt));
2045 else if (FONT_SPEC_P (XCAR (elt)))
2047 if (font_match_p (XCAR (elt), font_entity))
2048 return XFLOAT_DATA (XCDR (elt));
2052 return 1.0;
2055 /* We sort fonts by scoring each of them against a specified
2056 font-spec. The score value is 32 bit (`unsigned'), and the smaller
2057 the value is, the closer the font is to the font-spec.
2059 The lowest 2 bits of the score are used for driver type. The font
2060 available by the most preferred font driver is 0.
2062 The 4 7-bit fields in the higher 28 bits are used for numeric properties
2063 WEIGHT, SLANT, WIDTH, and SIZE. */
2065 /* How many bits to shift to store the difference value of each font
2066 property in a score. Note that floats for FONT_TYPE_INDEX and
2067 FONT_REGISTRY_INDEX are not used. */
2068 static int sort_shift_bits[FONT_SIZE_INDEX + 1];
2070 /* Score font-entity ENTITY against properties of font-spec SPEC_PROP.
2071 The return value indicates how different ENTITY is compared with
2072 SPEC_PROP. */
2074 static unsigned
2075 font_score (Lisp_Object entity, Lisp_Object *spec_prop)
2077 unsigned score = 0;
2078 int i;
2080 /* Score three style numeric fields. Maximum difference is 127. */
2081 for (i = FONT_WEIGHT_INDEX; i <= FONT_WIDTH_INDEX; i++)
2082 if (! NILP (spec_prop[i]) && ! EQ (AREF (entity, i), spec_prop[i]))
2084 EMACS_INT diff = ((XINT (AREF (entity, i)) >> 8)
2085 - (XINT (spec_prop[i]) >> 8));
2086 if (diff < 0)
2087 diff = - diff;
2088 score |= min (diff, 127) << sort_shift_bits[i];
2091 /* Score the size. Maximum difference is 127. */
2092 i = FONT_SIZE_INDEX;
2093 if (! NILP (spec_prop[FONT_SIZE_INDEX])
2094 && XINT (AREF (entity, FONT_SIZE_INDEX)) > 0)
2096 /* We use the higher 6-bit for the actual size difference. The
2097 lowest bit is set if the DPI is different. */
2098 EMACS_INT diff;
2099 EMACS_INT pixel_size = XINT (spec_prop[FONT_SIZE_INDEX]);
2101 if (CONSP (Vface_font_rescale_alist))
2102 pixel_size *= font_rescale_ratio (entity);
2103 diff = pixel_size - XINT (AREF (entity, FONT_SIZE_INDEX));
2104 if (diff < 0)
2105 diff = - diff;
2106 diff <<= 1;
2107 if (! NILP (spec_prop[FONT_DPI_INDEX])
2108 && ! EQ (spec_prop[FONT_DPI_INDEX], AREF (entity, FONT_DPI_INDEX)))
2109 diff |= 1;
2110 if (! NILP (spec_prop[FONT_AVGWIDTH_INDEX])
2111 && ! EQ (spec_prop[FONT_AVGWIDTH_INDEX], AREF (entity, FONT_AVGWIDTH_INDEX)))
2112 diff |= 1;
2113 score |= min (diff, 127) << sort_shift_bits[FONT_SIZE_INDEX];
2116 return score;
2120 /* Concatenate all elements of LIST into one vector. LIST is a list
2121 of font-entity vectors. */
2123 static Lisp_Object
2124 font_vconcat_entity_vectors (Lisp_Object list)
2126 int nargs = XINT (Flength (list));
2127 Lisp_Object *args = alloca (sizeof (Lisp_Object) * nargs);
2128 int i;
2130 for (i = 0; i < nargs; i++, list = XCDR (list))
2131 args[i] = XCAR (list);
2132 return Fvconcat (nargs, args);
2136 /* The structure for elements being sorted by qsort. */
2137 struct font_sort_data
2139 unsigned score;
2140 int font_driver_preference;
2141 Lisp_Object entity;
2145 /* The comparison function for qsort. */
2147 static int
2148 font_compare (const void *d1, const void *d2)
2150 const struct font_sort_data *data1 = d1;
2151 const struct font_sort_data *data2 = d2;
2153 if (data1->score < data2->score)
2154 return -1;
2155 else if (data1->score > data2->score)
2156 return 1;
2157 return (data1->font_driver_preference - data2->font_driver_preference);
2161 /* Sort each font-entity vector in LIST by closeness to font-spec PREFER.
2162 If PREFER specifies a point-size, calculate the corresponding
2163 pixel-size from QCdpi property of PREFER or from the Y-resolution
2164 of FRAME before sorting.
2166 If BEST-ONLY is nonzero, return the best matching entity (that
2167 supports the character BEST-ONLY if BEST-ONLY is positive, or any
2168 if BEST-ONLY is negative). Otherwise, return the sorted result as
2169 a single vector of font-entities.
2171 This function does no optimization for the case that the total
2172 number of elements is 1. The caller should avoid calling this in
2173 such a case. */
2175 static Lisp_Object
2176 font_sort_entities (Lisp_Object list, Lisp_Object prefer, Lisp_Object frame, int best_only)
2178 Lisp_Object prefer_prop[FONT_SPEC_MAX];
2179 int len, maxlen, i;
2180 struct font_sort_data *data;
2181 unsigned best_score;
2182 Lisp_Object best_entity;
2183 struct frame *f = XFRAME (frame);
2184 Lisp_Object tail, vec IF_LINT (= Qnil);
2185 USE_SAFE_ALLOCA;
2187 for (i = FONT_WEIGHT_INDEX; i <= FONT_AVGWIDTH_INDEX; i++)
2188 prefer_prop[i] = AREF (prefer, i);
2189 if (FLOATP (prefer_prop[FONT_SIZE_INDEX]))
2190 prefer_prop[FONT_SIZE_INDEX]
2191 = make_number (font_pixel_size (XFRAME (frame), prefer));
2193 if (NILP (XCDR (list)))
2195 /* What we have to take care of is this single vector. */
2196 vec = XCAR (list);
2197 maxlen = ASIZE (vec);
2199 else if (best_only)
2201 /* We don't have to perform sort, so there's no need of creating
2202 a single vector. But, we must find the length of the longest
2203 vector. */
2204 maxlen = 0;
2205 for (tail = list; CONSP (tail); tail = XCDR (tail))
2206 if (maxlen < ASIZE (XCAR (tail)))
2207 maxlen = ASIZE (XCAR (tail));
2209 else
2211 /* We have to create a single vector to sort it. */
2212 vec = font_vconcat_entity_vectors (list);
2213 maxlen = ASIZE (vec);
2216 SAFE_ALLOCA (data, struct font_sort_data *, (sizeof *data) * maxlen);
2217 best_score = 0xFFFFFFFF;
2218 best_entity = Qnil;
2220 for (tail = list; CONSP (tail); tail = XCDR (tail))
2222 int font_driver_preference = 0;
2223 Lisp_Object current_font_driver;
2225 if (best_only)
2226 vec = XCAR (tail);
2227 len = ASIZE (vec);
2229 /* We are sure that the length of VEC > 0. */
2230 current_font_driver = AREF (AREF (vec, 0), FONT_TYPE_INDEX);
2231 /* Score the elements. */
2232 for (i = 0; i < len; i++)
2234 data[i].entity = AREF (vec, i);
2235 data[i].score
2236 = ((best_only <= 0 || font_has_char (f, data[i].entity, best_only)
2237 > 0)
2238 ? font_score (data[i].entity, prefer_prop)
2239 : 0xFFFFFFFF);
2240 if (best_only && best_score > data[i].score)
2242 best_score = data[i].score;
2243 best_entity = data[i].entity;
2244 if (best_score == 0)
2245 break;
2247 if (! EQ (current_font_driver, AREF (AREF (vec, i), FONT_TYPE_INDEX)))
2249 current_font_driver = AREF (AREF (vec, i), FONT_TYPE_INDEX);
2250 font_driver_preference++;
2252 data[i].font_driver_preference = font_driver_preference;
2255 /* Sort if necessary. */
2256 if (! best_only)
2258 qsort (data, len, sizeof *data, font_compare);
2259 for (i = 0; i < len; i++)
2260 ASET (vec, i, data[i].entity);
2261 break;
2263 else
2264 vec = best_entity;
2267 SAFE_FREE ();
2269 FONT_ADD_LOG ("sort-by", prefer, vec);
2270 return vec;
2274 /* API of Font Service Layer. */
2276 /* Reflect ORDER (see the variable font_sort_order in xfaces.c) to
2277 sort_shift_bits. Finternal_set_font_selection_order calls this
2278 function with font_sort_order after setting up it. */
2280 void
2281 font_update_sort_order (int *order)
2283 int i, shift_bits;
2285 for (i = 0, shift_bits = 23; i < 4; i++, shift_bits -= 7)
2287 int xlfd_idx = order[i];
2289 if (xlfd_idx == XLFD_WEIGHT_INDEX)
2290 sort_shift_bits[FONT_WEIGHT_INDEX] = shift_bits;
2291 else if (xlfd_idx == XLFD_SLANT_INDEX)
2292 sort_shift_bits[FONT_SLANT_INDEX] = shift_bits;
2293 else if (xlfd_idx == XLFD_SWIDTH_INDEX)
2294 sort_shift_bits[FONT_WIDTH_INDEX] = shift_bits;
2295 else
2296 sort_shift_bits[FONT_SIZE_INDEX] = shift_bits;
2300 static int
2301 font_check_otf_features (Lisp_Object script, Lisp_Object langsys, Lisp_Object features, Lisp_Object table)
2303 Lisp_Object val;
2304 int negative;
2306 table = assq_no_quit (script, table);
2307 if (NILP (table))
2308 return 0;
2309 table = XCDR (table);
2310 if (! NILP (langsys))
2312 table = assq_no_quit (langsys, table);
2313 if (NILP (table))
2314 return 0;
2316 else
2318 val = assq_no_quit (Qnil, table);
2319 if (NILP (val))
2320 table = XCAR (table);
2321 else
2322 table = val;
2324 table = XCDR (table);
2325 for (negative = 0; CONSP (features); features = XCDR (features))
2327 if (NILP (XCAR (features)))
2329 negative = 1;
2330 continue;
2332 if (NILP (Fmemq (XCAR (features), table)) != negative)
2333 return 0;
2335 return 1;
2338 /* Check if OTF_CAPABILITY satisfies SPEC (otf-spec). */
2340 static int
2341 font_check_otf (Lisp_Object spec, Lisp_Object otf_capability)
2343 Lisp_Object script, langsys = Qnil, gsub = Qnil, gpos = Qnil;
2345 script = XCAR (spec);
2346 spec = XCDR (spec);
2347 if (! NILP (spec))
2349 langsys = XCAR (spec);
2350 spec = XCDR (spec);
2351 if (! NILP (spec))
2353 gsub = XCAR (spec);
2354 spec = XCDR (spec);
2355 if (! NILP (spec))
2356 gpos = XCAR (spec);
2360 if (! NILP (gsub) && ! font_check_otf_features (script, langsys, gsub,
2361 XCAR (otf_capability)))
2362 return 0;
2363 if (! NILP (gpos) && ! font_check_otf_features (script, langsys, gpos,
2364 XCDR (otf_capability)))
2365 return 0;
2366 return 1;
2371 /* Check if FONT (font-entity or font-object) matches with the font
2372 specification SPEC. */
2375 font_match_p (Lisp_Object spec, Lisp_Object font)
2377 Lisp_Object prop[FONT_SPEC_MAX], *props;
2378 Lisp_Object extra, font_extra;
2379 int i;
2381 for (i = FONT_FOUNDRY_INDEX; i <= FONT_REGISTRY_INDEX; i++)
2382 if (! NILP (AREF (spec, i))
2383 && ! NILP (AREF (font, i))
2384 && ! EQ (AREF (spec, i), AREF (font, i)))
2385 return 0;
2386 props = XFONT_SPEC (spec)->props;
2387 if (FLOATP (props[FONT_SIZE_INDEX]))
2389 for (i = FONT_FOUNDRY_INDEX; i < FONT_SIZE_INDEX; i++)
2390 prop[i] = AREF (spec, i);
2391 prop[FONT_SIZE_INDEX]
2392 = make_number (font_pixel_size (XFRAME (selected_frame), spec));
2393 props = prop;
2396 if (font_score (font, props) > 0)
2397 return 0;
2398 extra = AREF (spec, FONT_EXTRA_INDEX);
2399 font_extra = AREF (font, FONT_EXTRA_INDEX);
2400 for (; CONSP (extra); extra = XCDR (extra))
2402 Lisp_Object key = XCAR (XCAR (extra));
2403 Lisp_Object val = XCDR (XCAR (extra)), val2;
2405 if (EQ (key, QClang))
2407 val2 = assq_no_quit (key, font_extra);
2408 if (NILP (val2))
2409 return 0;
2410 val2 = XCDR (val2);
2411 if (CONSP (val))
2413 if (! CONSP (val2))
2414 return 0;
2415 while (CONSP (val))
2416 if (NILP (Fmemq (val, val2)))
2417 return 0;
2419 else
2420 if (CONSP (val2)
2421 ? NILP (Fmemq (val, XCDR (val2)))
2422 : ! EQ (val, val2))
2423 return 0;
2425 else if (EQ (key, QCscript))
2427 val2 = assq_no_quit (val, Vscript_representative_chars);
2428 if (CONSP (val2))
2430 val2 = XCDR (val2);
2431 if (CONSP (val2))
2433 /* All characters in the list must be supported. */
2434 for (; CONSP (val2); val2 = XCDR (val2))
2436 if (! NATNUMP (XCAR (val2)))
2437 continue;
2438 if (font_encode_char (font, XFASTINT (XCAR (val2)))
2439 == FONT_INVALID_CODE)
2440 return 0;
2443 else if (VECTORP (val2))
2445 /* At most one character in the vector must be supported. */
2446 for (i = 0; i < ASIZE (val2); i++)
2448 if (! NATNUMP (AREF (val2, i)))
2449 continue;
2450 if (font_encode_char (font, XFASTINT (AREF (val2, i)))
2451 != FONT_INVALID_CODE)
2452 break;
2454 if (i == ASIZE (val2))
2455 return 0;
2459 else if (EQ (key, QCotf))
2461 struct font *fontp;
2463 if (! FONT_OBJECT_P (font))
2464 return 0;
2465 fontp = XFONT_OBJECT (font);
2466 if (! fontp->driver->otf_capability)
2467 return 0;
2468 val2 = fontp->driver->otf_capability (fontp);
2469 if (NILP (val2) || ! font_check_otf (val, val2))
2470 return 0;
2474 return 1;
2478 /* Font cache
2480 Each font backend has the callback function get_cache, and it
2481 returns a cons cell of which cdr part can be freely used for
2482 caching fonts. The cons cell may be shared by multiple frames
2483 and/or multiple font drivers. So, we arrange the cdr part as this:
2485 ((DRIVER-TYPE NUM-FRAMES FONT-CACHE-DATA ...) ...)
2487 where DRIVER-TYPE is a symbol such as `x', `xft', etc., NUM-FRAMES
2488 is a number frames sharing this cache, and FONT-CACHE-DATA is a
2489 cons (FONT-SPEC FONT-ENTITY ...). */
2491 static void font_prepare_cache (FRAME_PTR, struct font_driver *);
2492 static void font_finish_cache (FRAME_PTR, struct font_driver *);
2493 static Lisp_Object font_get_cache (FRAME_PTR, struct font_driver *);
2494 static void font_clear_cache (FRAME_PTR, Lisp_Object,
2495 struct font_driver *);
2497 static void
2498 font_prepare_cache (FRAME_PTR f, struct font_driver *driver)
2500 Lisp_Object cache, val;
2502 cache = driver->get_cache (f);
2503 val = XCDR (cache);
2504 while (CONSP (val) && ! EQ (XCAR (XCAR (val)), driver->type))
2505 val = XCDR (val);
2506 if (NILP (val))
2508 val = Fcons (driver->type, Fcons (make_number (1), Qnil));
2509 XSETCDR (cache, Fcons (val, XCDR (cache)));
2511 else
2513 val = XCDR (XCAR (val));
2514 XSETCAR (val, make_number (XINT (XCAR (val)) + 1));
2519 static void
2520 font_finish_cache (FRAME_PTR f, struct font_driver *driver)
2522 Lisp_Object cache, val, tmp;
2525 cache = driver->get_cache (f);
2526 val = XCDR (cache);
2527 while (CONSP (val) && ! EQ (XCAR (XCAR (val)), driver->type))
2528 cache = val, val = XCDR (val);
2529 font_assert (! NILP (val));
2530 tmp = XCDR (XCAR (val));
2531 XSETCAR (tmp, make_number (XINT (XCAR (tmp)) - 1));
2532 if (XINT (XCAR (tmp)) == 0)
2534 font_clear_cache (f, XCAR (val), driver);
2535 XSETCDR (cache, XCDR (val));
2540 static Lisp_Object
2541 font_get_cache (FRAME_PTR f, struct font_driver *driver)
2543 Lisp_Object val = driver->get_cache (f);
2544 Lisp_Object type = driver->type;
2546 font_assert (CONSP (val));
2547 for (val = XCDR (val); ! EQ (XCAR (XCAR (val)), type); val = XCDR (val));
2548 font_assert (CONSP (val));
2549 /* VAL = ((DRIVER-TYPE NUM-FRAMES FONT-CACHE-DATA ...) ...) */
2550 val = XCDR (XCAR (val));
2551 return val;
2554 static int num_fonts;
2556 static void
2557 font_clear_cache (FRAME_PTR f, Lisp_Object cache, struct font_driver *driver)
2559 Lisp_Object tail, elt;
2560 Lisp_Object tail2, entity;
2562 /* CACHE = (DRIVER-TYPE NUM-FRAMES FONT-CACHE-DATA ...) */
2563 for (tail = XCDR (XCDR (cache)); CONSP (tail); tail = XCDR (tail))
2565 elt = XCAR (tail);
2566 /* elt should have the form (FONT-SPEC FONT-ENTITY ...) */
2567 if (CONSP (elt) && FONT_SPEC_P (XCAR (elt)))
2569 for (tail2 = XCDR (elt); CONSP (tail2); tail2 = XCDR (tail2))
2571 entity = XCAR (tail2);
2573 if (FONT_ENTITY_P (entity)
2574 && EQ (driver->type, AREF (entity, FONT_TYPE_INDEX)))
2576 Lisp_Object objlist = AREF (entity, FONT_OBJLIST_INDEX);
2578 for (; CONSP (objlist); objlist = XCDR (objlist))
2580 Lisp_Object val = XCAR (objlist);
2581 struct font *font = XFONT_OBJECT (val);
2583 if (! NILP (AREF (val, FONT_TYPE_INDEX)))
2585 font_assert (font && driver == font->driver);
2586 driver->close (f, font);
2587 num_fonts--;
2590 if (driver->free_entity)
2591 driver->free_entity (entity);
2596 XSETCDR (cache, Qnil);
2600 static Lisp_Object scratch_font_spec, scratch_font_prefer;
2602 /* Check each font-entity in VEC, and return a list of font-entities
2603 that satisfy these conditions:
2604 (1) matches with SPEC and SIZE if SPEC is not nil, and
2605 (2) doesn't match with any regexps in Vface_ignored_fonts (if non-nil).
2608 static Lisp_Object
2609 font_delete_unmatched (Lisp_Object vec, Lisp_Object spec, int size)
2611 Lisp_Object entity, val;
2612 enum font_property_index prop;
2613 int i;
2615 for (val = Qnil, i = ASIZE (vec) - 1; i >= 0; i--)
2617 entity = AREF (vec, i);
2618 if (! NILP (Vface_ignored_fonts))
2620 char name[256];
2621 Lisp_Object tail, regexp;
2623 if (font_unparse_xlfd (entity, 0, name, 256) >= 0)
2625 for (tail = Vface_ignored_fonts; CONSP (tail); tail = XCDR (tail))
2627 regexp = XCAR (tail);
2628 if (STRINGP (regexp)
2629 && fast_c_string_match_ignore_case (regexp, name) >= 0)
2630 break;
2632 if (CONSP (tail))
2633 continue;
2636 if (NILP (spec))
2638 val = Fcons (entity, val);
2639 continue;
2641 for (prop = FONT_WEIGHT_INDEX; prop < FONT_SIZE_INDEX; prop++)
2642 if (INTEGERP (AREF (spec, prop))
2643 && ((XINT (AREF (spec, prop)) >> 8)
2644 != (XINT (AREF (entity, prop)) >> 8)))
2645 prop = FONT_SPEC_MAX;
2646 if (prop < FONT_SPEC_MAX
2647 && size
2648 && XINT (AREF (entity, FONT_SIZE_INDEX)) > 0)
2650 int diff = XINT (AREF (entity, FONT_SIZE_INDEX)) - size;
2652 if (diff != 0
2653 && (diff < 0 ? -diff > FONT_PIXEL_SIZE_QUANTUM
2654 : diff > FONT_PIXEL_SIZE_QUANTUM))
2655 prop = FONT_SPEC_MAX;
2657 if (prop < FONT_SPEC_MAX
2658 && INTEGERP (AREF (spec, FONT_DPI_INDEX))
2659 && INTEGERP (AREF (entity, FONT_DPI_INDEX))
2660 && XINT (AREF (entity, FONT_DPI_INDEX)) != 0
2661 && ! EQ (AREF (spec, FONT_DPI_INDEX), AREF (entity, FONT_DPI_INDEX)))
2662 prop = FONT_SPEC_MAX;
2663 if (prop < FONT_SPEC_MAX
2664 && INTEGERP (AREF (spec, FONT_AVGWIDTH_INDEX))
2665 && INTEGERP (AREF (entity, FONT_AVGWIDTH_INDEX))
2666 && XINT (AREF (entity, FONT_AVGWIDTH_INDEX)) != 0
2667 && ! EQ (AREF (spec, FONT_AVGWIDTH_INDEX),
2668 AREF (entity, FONT_AVGWIDTH_INDEX)))
2669 prop = FONT_SPEC_MAX;
2670 if (prop < FONT_SPEC_MAX)
2671 val = Fcons (entity, val);
2673 return (Fvconcat (1, &val));
2677 /* Return a list of vectors of font-entities matching with SPEC on
2678 FRAME. Each elements in the list is a vector of entities from the
2679 same font-driver. */
2681 Lisp_Object
2682 font_list_entities (Lisp_Object frame, Lisp_Object spec)
2684 FRAME_PTR f = XFRAME (frame);
2685 struct font_driver_list *driver_list = f->font_driver_list;
2686 Lisp_Object ftype, val;
2687 Lisp_Object list = Qnil;
2688 int size;
2689 int need_filtering = 0;
2690 int i;
2692 font_assert (FONT_SPEC_P (spec));
2694 if (INTEGERP (AREF (spec, FONT_SIZE_INDEX)))
2695 size = XINT (AREF (spec, FONT_SIZE_INDEX));
2696 else if (FLOATP (AREF (spec, FONT_SIZE_INDEX)))
2697 size = font_pixel_size (f, spec);
2698 else
2699 size = 0;
2701 ftype = AREF (spec, FONT_TYPE_INDEX);
2702 for (i = FONT_FOUNDRY_INDEX; i <= FONT_REGISTRY_INDEX; i++)
2703 ASET (scratch_font_spec, i, AREF (spec, i));
2704 for (i = FONT_WEIGHT_INDEX; i < FONT_EXTRA_INDEX; i++)
2705 if (i != FONT_SPACING_INDEX)
2707 ASET (scratch_font_spec, i, Qnil);
2708 if (! NILP (AREF (spec, i)))
2709 need_filtering = 1;
2711 ASET (scratch_font_spec, FONT_SPACING_INDEX, AREF (spec, FONT_SPACING_INDEX));
2712 ASET (scratch_font_spec, FONT_EXTRA_INDEX, AREF (spec, FONT_EXTRA_INDEX));
2714 for (i = 0; driver_list; driver_list = driver_list->next)
2715 if (driver_list->on
2716 && (NILP (ftype) || EQ (driver_list->driver->type, ftype)))
2718 Lisp_Object cache = font_get_cache (f, driver_list->driver);
2720 ASET (scratch_font_spec, FONT_TYPE_INDEX, driver_list->driver->type);
2721 val = assoc_no_quit (scratch_font_spec, XCDR (cache));
2722 if (CONSP (val))
2723 val = XCDR (val);
2724 else
2726 Lisp_Object copy;
2728 val = driver_list->driver->list (frame, scratch_font_spec);
2729 if (NILP (val))
2730 val = null_vector;
2731 else
2732 val = Fvconcat (1, &val);
2733 copy = copy_font_spec (scratch_font_spec);
2734 ASET (copy, FONT_TYPE_INDEX, driver_list->driver->type);
2735 XSETCDR (cache, Fcons (Fcons (copy, val), XCDR (cache)));
2737 if (ASIZE (val) > 0
2738 && (need_filtering
2739 || ! NILP (Vface_ignored_fonts)))
2740 val = font_delete_unmatched (val, need_filtering ? spec : Qnil, size);
2741 if (ASIZE (val) > 0)
2742 list = Fcons (val, list);
2745 list = Fnreverse (list);
2746 FONT_ADD_LOG ("list", spec, list);
2747 return list;
2751 /* Return a font entity matching with SPEC on FRAME. ATTRS, if non
2752 nil, is an array of face's attributes, which specifies preferred
2753 font-related attributes. */
2755 static Lisp_Object
2756 font_matching_entity (FRAME_PTR f, Lisp_Object *attrs, Lisp_Object spec)
2758 struct font_driver_list *driver_list = f->font_driver_list;
2759 Lisp_Object ftype, size, entity;
2760 Lisp_Object frame;
2761 Lisp_Object work = copy_font_spec (spec);
2763 XSETFRAME (frame, f);
2764 ftype = AREF (spec, FONT_TYPE_INDEX);
2765 size = AREF (spec, FONT_SIZE_INDEX);
2767 if (FLOATP (size))
2768 ASET (work, FONT_SIZE_INDEX, make_number (font_pixel_size (f, spec)));
2769 FONT_SET_STYLE (work, FONT_WEIGHT_INDEX, attrs[LFACE_WEIGHT_INDEX]);
2770 FONT_SET_STYLE (work, FONT_SLANT_INDEX, attrs[LFACE_SLANT_INDEX]);
2771 FONT_SET_STYLE (work, FONT_WIDTH_INDEX, attrs[LFACE_SWIDTH_INDEX]);
2773 entity = Qnil;
2774 for (; driver_list; driver_list = driver_list->next)
2775 if (driver_list->on
2776 && (NILP (ftype) || EQ (driver_list->driver->type, ftype)))
2778 Lisp_Object cache = font_get_cache (f, driver_list->driver);
2779 Lisp_Object copy;
2781 ASET (work, FONT_TYPE_INDEX, driver_list->driver->type);
2782 entity = assoc_no_quit (work, XCDR (cache));
2783 if (CONSP (entity))
2784 entity = XCDR (entity);
2785 else
2787 entity = driver_list->driver->match (frame, work);
2788 copy = copy_font_spec (work);
2789 ASET (copy, FONT_TYPE_INDEX, driver_list->driver->type);
2790 XSETCDR (cache, Fcons (Fcons (copy, entity), XCDR (cache)));
2792 if (! NILP (entity))
2793 break;
2795 FONT_ADD_LOG ("match", work, entity);
2796 return entity;
2800 /* Open a font of ENTITY and PIXEL_SIZE on frame F, and return the
2801 opened font object. */
2803 static Lisp_Object
2804 font_open_entity (FRAME_PTR f, Lisp_Object entity, int pixel_size)
2806 struct font_driver_list *driver_list;
2807 Lisp_Object objlist, size, val, font_object;
2808 struct font *font;
2809 int min_width, height;
2810 int scaled_pixel_size = pixel_size;
2812 font_assert (FONT_ENTITY_P (entity));
2813 size = AREF (entity, FONT_SIZE_INDEX);
2814 if (XINT (size) != 0)
2815 scaled_pixel_size = pixel_size = XINT (size);
2816 else if (CONSP (Vface_font_rescale_alist))
2817 scaled_pixel_size = pixel_size * font_rescale_ratio (entity);
2819 val = AREF (entity, FONT_TYPE_INDEX);
2820 for (driver_list = f->font_driver_list;
2821 driver_list && ! EQ (driver_list->driver->type, val);
2822 driver_list = driver_list->next);
2823 if (! driver_list)
2824 return Qnil;
2826 for (objlist = AREF (entity, FONT_OBJLIST_INDEX); CONSP (objlist);
2827 objlist = XCDR (objlist))
2829 Lisp_Object fn = XCAR (objlist);
2830 if (! NILP (AREF (fn, FONT_TYPE_INDEX))
2831 && XFONT_OBJECT (fn)->pixel_size == pixel_size)
2833 if (driver_list->driver->cached_font_ok == NULL
2834 || driver_list->driver->cached_font_ok (f, fn, entity))
2835 return fn;
2839 font_object = driver_list->driver->open (f, entity, scaled_pixel_size);
2840 if (!NILP (font_object))
2841 ASET (font_object, FONT_SIZE_INDEX, make_number (pixel_size));
2842 FONT_ADD_LOG ("open", entity, font_object);
2843 if (NILP (font_object))
2844 return Qnil;
2845 ASET (entity, FONT_OBJLIST_INDEX,
2846 Fcons (font_object, AREF (entity, FONT_OBJLIST_INDEX)));
2847 num_fonts++;
2849 font = XFONT_OBJECT (font_object);
2850 min_width = (font->min_width ? font->min_width
2851 : font->average_width ? font->average_width
2852 : font->space_width ? font->space_width
2853 : 1);
2854 height = (font->height ? font->height : 1);
2855 #ifdef HAVE_WINDOW_SYSTEM
2856 FRAME_X_DISPLAY_INFO (f)->n_fonts++;
2857 if (FRAME_X_DISPLAY_INFO (f)->n_fonts == 1)
2859 FRAME_SMALLEST_CHAR_WIDTH (f) = min_width;
2860 FRAME_SMALLEST_FONT_HEIGHT (f) = height;
2861 fonts_changed_p = 1;
2863 else
2865 if (FRAME_SMALLEST_CHAR_WIDTH (f) > min_width)
2866 FRAME_SMALLEST_CHAR_WIDTH (f) = min_width, fonts_changed_p = 1;
2867 if (FRAME_SMALLEST_FONT_HEIGHT (f) > height)
2868 FRAME_SMALLEST_FONT_HEIGHT (f) = height, fonts_changed_p = 1;
2870 #endif
2872 return font_object;
2876 /* Close FONT_OBJECT that is opened on frame F. */
2878 static void
2879 font_close_object (FRAME_PTR f, Lisp_Object font_object)
2881 struct font *font = XFONT_OBJECT (font_object);
2883 if (NILP (AREF (font_object, FONT_TYPE_INDEX)))
2884 /* Already closed. */
2885 return;
2886 FONT_ADD_LOG ("close", font_object, Qnil);
2887 font->driver->close (f, font);
2888 #ifdef HAVE_WINDOW_SYSTEM
2889 font_assert (FRAME_X_DISPLAY_INFO (f)->n_fonts);
2890 FRAME_X_DISPLAY_INFO (f)->n_fonts--;
2891 #endif
2892 num_fonts--;
2896 /* Return 1 if FONT on F has a glyph for character C, 0 if not, -1 if
2897 FONT is a font-entity and it must be opened to check. */
2900 font_has_char (FRAME_PTR f, Lisp_Object font, int c)
2902 struct font *fontp;
2904 if (FONT_ENTITY_P (font))
2906 Lisp_Object type = AREF (font, FONT_TYPE_INDEX);
2907 struct font_driver_list *driver_list;
2909 for (driver_list = f->font_driver_list;
2910 driver_list && ! EQ (driver_list->driver->type, type);
2911 driver_list = driver_list->next);
2912 if (! driver_list)
2913 return 0;
2914 if (! driver_list->driver->has_char)
2915 return -1;
2916 return driver_list->driver->has_char (font, c);
2919 font_assert (FONT_OBJECT_P (font));
2920 fontp = XFONT_OBJECT (font);
2921 if (fontp->driver->has_char)
2923 int result = fontp->driver->has_char (font, c);
2925 if (result >= 0)
2926 return result;
2928 return (fontp->driver->encode_char (fontp, c) != FONT_INVALID_CODE);
2932 /* Return the glyph ID of FONT_OBJECT for character C. */
2934 static unsigned
2935 font_encode_char (Lisp_Object font_object, int c)
2937 struct font *font;
2939 font_assert (FONT_OBJECT_P (font_object));
2940 font = XFONT_OBJECT (font_object);
2941 return font->driver->encode_char (font, c);
2945 /* Return the name of FONT_OBJECT. */
2947 Lisp_Object
2948 font_get_name (Lisp_Object font_object)
2950 font_assert (FONT_OBJECT_P (font_object));
2951 return AREF (font_object, FONT_NAME_INDEX);
2955 /* Create a new font spec from FONT_NAME, and return it. If FONT_NAME
2956 could not be parsed by font_parse_name, return Qnil. */
2958 Lisp_Object
2959 font_spec_from_name (Lisp_Object font_name)
2961 Lisp_Object spec = Ffont_spec (0, NULL);
2963 CHECK_STRING (font_name);
2964 if (font_parse_name (SSDATA (font_name), spec) == -1)
2965 return Qnil;
2966 font_put_extra (spec, QCname, font_name);
2967 font_put_extra (spec, QCuser_spec, font_name);
2968 return spec;
2972 void
2973 font_clear_prop (Lisp_Object *attrs, enum font_property_index prop)
2975 Lisp_Object font = attrs[LFACE_FONT_INDEX];
2977 if (! FONTP (font))
2978 return;
2980 if (! NILP (Ffont_get (font, QCname)))
2982 font = copy_font_spec (font);
2983 font_put_extra (font, QCname, Qnil);
2986 if (NILP (AREF (font, prop))
2987 && prop != FONT_FAMILY_INDEX
2988 && prop != FONT_FOUNDRY_INDEX
2989 && prop != FONT_WIDTH_INDEX
2990 && prop != FONT_SIZE_INDEX)
2991 return;
2992 if (EQ (font, attrs[LFACE_FONT_INDEX]))
2993 font = copy_font_spec (font);
2994 ASET (font, prop, Qnil);
2995 if (prop == FONT_FAMILY_INDEX || prop == FONT_FOUNDRY_INDEX)
2997 if (prop == FONT_FAMILY_INDEX)
2999 ASET (font, FONT_FOUNDRY_INDEX, Qnil);
3000 /* If we are setting the font family, we must also clear
3001 FONT_WIDTH_INDEX to avoid rejecting families that lack
3002 support for some widths. */
3003 ASET (font, FONT_WIDTH_INDEX, Qnil);
3005 ASET (font, FONT_ADSTYLE_INDEX, Qnil);
3006 ASET (font, FONT_REGISTRY_INDEX, Qnil);
3007 ASET (font, FONT_SIZE_INDEX, Qnil);
3008 ASET (font, FONT_DPI_INDEX, Qnil);
3009 ASET (font, FONT_SPACING_INDEX, Qnil);
3010 ASET (font, FONT_AVGWIDTH_INDEX, Qnil);
3012 else if (prop == FONT_SIZE_INDEX)
3014 ASET (font, FONT_DPI_INDEX, Qnil);
3015 ASET (font, FONT_SPACING_INDEX, Qnil);
3016 ASET (font, FONT_AVGWIDTH_INDEX, Qnil);
3018 else if (prop == FONT_WIDTH_INDEX)
3019 ASET (font, FONT_AVGWIDTH_INDEX, Qnil);
3020 attrs[LFACE_FONT_INDEX] = font;
3023 /* Select a font from ENTITIES (list of font-entity vectors) that
3024 supports C and is the best match for ATTRS and PIXEL_SIZE. */
3026 static Lisp_Object
3027 font_select_entity (Lisp_Object frame, Lisp_Object entities, Lisp_Object *attrs, int pixel_size, int c)
3029 Lisp_Object font_entity;
3030 Lisp_Object prefer;
3031 int result, i;
3032 FRAME_PTR f = XFRAME (frame);
3034 if (NILP (XCDR (entities))
3035 && ASIZE (XCAR (entities)) == 1)
3037 font_entity = AREF (XCAR (entities), 0);
3038 if (c < 0
3039 || (result = font_has_char (f, font_entity, c)) > 0)
3040 return font_entity;
3041 return Qnil;
3044 /* Sort fonts by properties specified in ATTRS. */
3045 prefer = scratch_font_prefer;
3047 for (i = FONT_WEIGHT_INDEX; i <= FONT_SIZE_INDEX; i++)
3048 ASET (prefer, i, Qnil);
3049 if (FONTP (attrs[LFACE_FONT_INDEX]))
3051 Lisp_Object face_font = attrs[LFACE_FONT_INDEX];
3053 for (i = FONT_WEIGHT_INDEX; i <= FONT_SIZE_INDEX; i++)
3054 ASET (prefer, i, AREF (face_font, i));
3056 if (NILP (AREF (prefer, FONT_WEIGHT_INDEX)))
3057 FONT_SET_STYLE (prefer, FONT_WEIGHT_INDEX, attrs[LFACE_WEIGHT_INDEX]);
3058 if (NILP (AREF (prefer, FONT_SLANT_INDEX)))
3059 FONT_SET_STYLE (prefer, FONT_SLANT_INDEX, attrs[LFACE_SLANT_INDEX]);
3060 if (NILP (AREF (prefer, FONT_WIDTH_INDEX)))
3061 FONT_SET_STYLE (prefer, FONT_WIDTH_INDEX, attrs[LFACE_SWIDTH_INDEX]);
3062 ASET (prefer, FONT_SIZE_INDEX, make_number (pixel_size));
3064 return font_sort_entities (entities, prefer, frame, c);
3067 /* Return a font-entity that satisfies SPEC and is the best match for
3068 face's font related attributes in ATTRS. C, if not negative, is a
3069 character that the entity must support. */
3071 Lisp_Object
3072 font_find_for_lface (FRAME_PTR f, Lisp_Object *attrs, Lisp_Object spec, int c)
3074 Lisp_Object work;
3075 Lisp_Object frame, entities, val;
3076 Lisp_Object foundry[3], *family, registry[3], adstyle[3];
3077 int pixel_size;
3078 int i, j, k, l;
3080 registry[0] = AREF (spec, FONT_REGISTRY_INDEX);
3081 if (NILP (registry[0]))
3083 registry[0] = DEFAULT_ENCODING;
3084 registry[1] = Qascii_0;
3085 registry[2] = null_vector;
3087 else
3088 registry[1] = null_vector;
3090 if (c >= 0 && ! NILP (AREF (spec, FONT_REGISTRY_INDEX)))
3092 struct charset *encoding, *repertory;
3094 if (font_registry_charsets (AREF (spec, FONT_REGISTRY_INDEX),
3095 &encoding, &repertory) < 0)
3096 return Qnil;
3097 if (repertory
3098 && ENCODE_CHAR (repertory, c) == CHARSET_INVALID_CODE (repertory))
3099 return Qnil;
3100 else if (c > encoding->max_char)
3101 return Qnil;
3104 work = copy_font_spec (spec);
3105 ASET (work, FONT_TYPE_INDEX, AREF (spec, FONT_TYPE_INDEX));
3106 XSETFRAME (frame, f);
3107 pixel_size = font_pixel_size (f, spec);
3108 if (pixel_size == 0 && INTEGERP (attrs[LFACE_HEIGHT_INDEX]))
3110 double pt = XINT (attrs[LFACE_HEIGHT_INDEX]);
3112 pixel_size = POINT_TO_PIXEL (pt / 10, f->resy);
3114 ASET (work, FONT_SIZE_INDEX, Qnil);
3115 foundry[0] = AREF (work, FONT_FOUNDRY_INDEX);
3116 if (! NILP (foundry[0]))
3117 foundry[1] = null_vector;
3118 else if (STRINGP (attrs[LFACE_FOUNDRY_INDEX]))
3120 val = attrs[LFACE_FOUNDRY_INDEX];
3121 foundry[0] = font_intern_prop (SSDATA (val), SBYTES (val), 1);
3122 foundry[1] = Qnil;
3123 foundry[2] = null_vector;
3125 else
3126 foundry[0] = Qnil, foundry[1] = null_vector;
3128 adstyle[0] = AREF (work, FONT_ADSTYLE_INDEX);
3129 if (! NILP (adstyle[0]))
3130 adstyle[1] = null_vector;
3131 else if (FONTP (attrs[LFACE_FONT_INDEX]))
3133 Lisp_Object face_font = attrs[LFACE_FONT_INDEX];
3135 if (! NILP (AREF (face_font, FONT_ADSTYLE_INDEX)))
3137 adstyle[0] = AREF (face_font, FONT_ADSTYLE_INDEX);
3138 adstyle[1] = Qnil;
3139 adstyle[2] = null_vector;
3141 else
3142 adstyle[0] = Qnil, adstyle[1] = null_vector;
3144 else
3145 adstyle[0] = Qnil, adstyle[1] = null_vector;
3148 val = AREF (work, FONT_FAMILY_INDEX);
3149 if (NILP (val) && STRINGP (attrs[LFACE_FAMILY_INDEX]))
3151 val = attrs[LFACE_FAMILY_INDEX];
3152 val = font_intern_prop (SSDATA (val), SBYTES (val), 1);
3154 if (NILP (val))
3156 family = alloca ((sizeof family[0]) * 2);
3157 family[0] = Qnil;
3158 family[1] = null_vector; /* terminator. */
3160 else
3162 Lisp_Object alters
3163 = Fassoc_string (val, Vface_alternative_font_family_alist, Qt);
3165 if (! NILP (alters))
3167 family = alloca ((sizeof family[0]) * (XINT (Flength (alters)) + 2));
3168 for (i = 0; CONSP (alters); i++, alters = XCDR (alters))
3169 family[i] = XCAR (alters);
3170 if (NILP (AREF (spec, FONT_FAMILY_INDEX)))
3171 family[i++] = Qnil;
3172 family[i] = null_vector;
3174 else
3176 family = alloca ((sizeof family[0]) * 3);
3177 i = 0;
3178 family[i++] = val;
3179 if (NILP (AREF (spec, FONT_FAMILY_INDEX)))
3180 family[i++] = Qnil;
3181 family[i] = null_vector;
3185 for (i = 0; SYMBOLP (family[i]); i++)
3187 ASET (work, FONT_FAMILY_INDEX, family[i]);
3188 for (j = 0; SYMBOLP (foundry[j]); j++)
3190 ASET (work, FONT_FOUNDRY_INDEX, foundry[j]);
3191 for (k = 0; SYMBOLP (registry[k]); k++)
3193 ASET (work, FONT_REGISTRY_INDEX, registry[k]);
3194 for (l = 0; SYMBOLP (adstyle[l]); l++)
3196 ASET (work, FONT_ADSTYLE_INDEX, adstyle[l]);
3197 entities = font_list_entities (frame, work);
3198 if (! NILP (entities))
3200 val = font_select_entity (frame, entities,
3201 attrs, pixel_size, c);
3202 if (! NILP (val))
3203 return val;
3209 return Qnil;
3213 Lisp_Object
3214 font_open_for_lface (FRAME_PTR f, Lisp_Object entity, Lisp_Object *attrs, Lisp_Object spec)
3216 int size;
3218 if (INTEGERP (AREF (entity, FONT_SIZE_INDEX))
3219 && XINT (AREF (entity, FONT_SIZE_INDEX)) > 0)
3220 size = XINT (AREF (entity, FONT_SIZE_INDEX));
3221 else if (FONT_SPEC_P (spec) && ! NILP (AREF (spec, FONT_SIZE_INDEX)))
3222 size = font_pixel_size (f, spec);
3223 else
3225 double pt;
3226 if (INTEGERP (attrs[LFACE_HEIGHT_INDEX]))
3227 pt = XINT (attrs[LFACE_HEIGHT_INDEX]);
3228 else
3230 struct face *def = FACE_FROM_ID (f, DEFAULT_FACE_ID);
3231 Lisp_Object height = def->lface[LFACE_HEIGHT_INDEX];
3232 if (INTEGERP (height))
3233 pt = XINT (height);
3234 else
3235 abort (); /* We should never end up here. */
3238 pt /= 10;
3239 size = POINT_TO_PIXEL (pt, f->resy);
3240 #ifdef HAVE_NS
3241 if (size == 0)
3243 Lisp_Object ffsize = get_frame_param (f, Qfontsize);
3244 size = NUMBERP (ffsize) ? POINT_TO_PIXEL (XINT (ffsize), f->resy) : 0;
3246 #endif
3248 return font_open_entity (f, entity, size);
3252 /* Find a font that satisfies SPEC and is the best match for
3253 face's attributes in ATTRS on FRAME, and return the opened
3254 font-object. */
3256 Lisp_Object
3257 font_load_for_lface (FRAME_PTR f, Lisp_Object *attrs, Lisp_Object spec)
3259 Lisp_Object entity, name;
3261 entity = font_find_for_lface (f, attrs, spec, -1);
3262 if (NILP (entity))
3264 /* No font is listed for SPEC, but each font-backend may have
3265 different criteria about "font matching". So, try it. */
3266 entity = font_matching_entity (f, attrs, spec);
3267 if (NILP (entity))
3268 return Qnil;
3270 /* Don't lose the original name that was put in initially. We need
3271 it to re-apply the font when font parameters (like hinting or dpi) have
3272 changed. */
3273 entity = font_open_for_lface (f, entity, attrs, spec);
3274 if (!NILP (entity))
3276 name = Ffont_get (spec, QCuser_spec);
3277 if (STRINGP (name)) font_put_extra (entity, QCuser_spec, name);
3279 return entity;
3283 /* Make FACE on frame F ready to use the font opened for FACE. */
3285 void
3286 font_prepare_for_face (FRAME_PTR f, struct face *face)
3288 if (face->font->driver->prepare_face)
3289 face->font->driver->prepare_face (f, face);
3293 /* Make FACE on frame F stop using the font opened for FACE. */
3295 void
3296 font_done_for_face (FRAME_PTR f, struct face *face)
3298 if (face->font->driver->done_face)
3299 face->font->driver->done_face (f, face);
3300 face->extra = NULL;
3304 /* Open a font that is a match for font-spec SPEC on frame F. If no proper
3305 font is found, return Qnil. */
3307 Lisp_Object
3308 font_open_by_spec (FRAME_PTR f, Lisp_Object spec)
3310 Lisp_Object attrs[LFACE_VECTOR_SIZE];
3312 /* We set up the default font-related attributes of a face to prefer
3313 a moderate font. */
3314 attrs[LFACE_FAMILY_INDEX] = attrs[LFACE_FOUNDRY_INDEX] = Qnil;
3315 attrs[LFACE_SWIDTH_INDEX] = attrs[LFACE_WEIGHT_INDEX]
3316 = attrs[LFACE_SLANT_INDEX] = Qnormal;
3317 #ifndef HAVE_NS
3318 attrs[LFACE_HEIGHT_INDEX] = make_number (120);
3319 #else
3320 attrs[LFACE_HEIGHT_INDEX] = make_number (0);
3321 #endif
3322 attrs[LFACE_FONT_INDEX] = Qnil;
3324 return font_load_for_lface (f, attrs, spec);
3328 /* Open a font that matches NAME on frame F. If no proper font is
3329 found, return Qnil. */
3331 Lisp_Object
3332 font_open_by_name (FRAME_PTR f, const char *name)
3334 Lisp_Object args[2];
3335 Lisp_Object spec, ret;
3337 args[0] = QCname;
3338 args[1] = make_unibyte_string (name, strlen (name));
3339 spec = Ffont_spec (2, args);
3340 ret = font_open_by_spec (f, spec);
3341 /* Do not lose name originally put in. */
3342 if (!NILP (ret))
3343 font_put_extra (ret, QCuser_spec, args[1]);
3345 return ret;
3349 /* Register font-driver DRIVER. This function is used in two ways.
3351 The first is with frame F non-NULL. In this case, make DRIVER
3352 available (but not yet activated) on F. All frame creators
3353 (e.g. Fx_create_frame) must call this function at least once with
3354 an available font-driver.
3356 The second is with frame F NULL. In this case, DRIVER is globally
3357 registered in the variable `font_driver_list'. All font-driver
3358 implementations must call this function in its syms_of_XXXX
3359 (e.g. syms_of_xfont). */
3361 void
3362 register_font_driver (struct font_driver *driver, FRAME_PTR f)
3364 struct font_driver_list *root = f ? f->font_driver_list : font_driver_list;
3365 struct font_driver_list *prev, *list;
3367 if (f && ! driver->draw)
3368 error ("Unusable font driver for a frame: %s",
3369 SDATA (SYMBOL_NAME (driver->type)));
3371 for (prev = NULL, list = root; list; prev = list, list = list->next)
3372 if (EQ (list->driver->type, driver->type))
3373 error ("Duplicated font driver: %s", SDATA (SYMBOL_NAME (driver->type)));
3375 list = xmalloc (sizeof (struct font_driver_list));
3376 list->on = 0;
3377 list->driver = driver;
3378 list->next = NULL;
3379 if (prev)
3380 prev->next = list;
3381 else if (f)
3382 f->font_driver_list = list;
3383 else
3384 font_driver_list = list;
3385 if (! f)
3386 num_font_drivers++;
3389 void
3390 free_font_driver_list (FRAME_PTR f)
3392 struct font_driver_list *list, *next;
3394 for (list = f->font_driver_list; list; list = next)
3396 next = list->next;
3397 xfree (list);
3399 f->font_driver_list = NULL;
3403 /* Make the frame F use font backends listed in NEW_DRIVERS (list of
3404 symbols, e.g. xft, x). If NEW_DRIVERS is t, make F use all
3405 available font drivers. If NEW_DRIVERS is nil, finalize all drivers.
3407 A caller must free all realized faces if any in advance. The
3408 return value is a list of font backends actually made used on
3409 F. */
3411 Lisp_Object
3412 font_update_drivers (FRAME_PTR f, Lisp_Object new_drivers)
3414 Lisp_Object active_drivers = Qnil;
3415 struct font_driver_list *list;
3417 /* At first, turn off non-requested drivers, and turn on requested
3418 drivers. */
3419 for (list = f->font_driver_list; list; list = list->next)
3421 struct font_driver *driver = list->driver;
3422 if ((EQ (new_drivers, Qt) || ! NILP (Fmemq (driver->type, new_drivers)))
3423 != list->on)
3425 if (list->on)
3427 if (driver->end_for_frame)
3428 driver->end_for_frame (f);
3429 font_finish_cache (f, driver);
3430 list->on = 0;
3432 else
3434 if (! driver->start_for_frame
3435 || driver->start_for_frame (f) == 0)
3437 font_prepare_cache (f, driver);
3438 list->on = 1;
3444 if (NILP (new_drivers))
3445 return Qnil;
3447 if (! EQ (new_drivers, Qt))
3449 /* Re-order the driver list according to new_drivers. */
3450 struct font_driver_list **list_table, **next;
3451 Lisp_Object tail;
3452 int i;
3454 list_table = alloca (sizeof list_table[0] * (num_font_drivers + 1));
3455 for (i = 0, tail = new_drivers; ! NILP (tail); tail = XCDR (tail))
3457 for (list = f->font_driver_list; list; list = list->next)
3458 if (list->on && EQ (list->driver->type, XCAR (tail)))
3459 break;
3460 if (list)
3461 list_table[i++] = list;
3463 for (list = f->font_driver_list; list; list = list->next)
3464 if (! list->on)
3465 list_table[i++] = list;
3466 list_table[i] = NULL;
3468 next = &f->font_driver_list;
3469 for (i = 0; list_table[i]; i++)
3471 *next = list_table[i];
3472 next = &(*next)->next;
3474 *next = NULL;
3476 if (! f->font_driver_list->on)
3477 { /* None of the drivers is enabled: enable them all.
3478 Happens if you set the list of drivers to (xft x) in your .emacs
3479 and then use it under w32 or ns. */
3480 for (list = f->font_driver_list; list; list = list->next)
3482 struct font_driver *driver = list->driver;
3483 eassert (! list->on);
3484 if (! driver->start_for_frame
3485 || driver->start_for_frame (f) == 0)
3487 font_prepare_cache (f, driver);
3488 list->on = 1;
3494 for (list = f->font_driver_list; list; list = list->next)
3495 if (list->on)
3496 active_drivers = nconc2 (active_drivers,
3497 Fcons (list->driver->type, Qnil));
3498 return active_drivers;
3502 font_put_frame_data (FRAME_PTR f, struct font_driver *driver, void *data)
3504 struct font_data_list *list, *prev;
3506 for (prev = NULL, list = f->font_data_list; list;
3507 prev = list, list = list->next)
3508 if (list->driver == driver)
3509 break;
3510 if (! data)
3512 if (list)
3514 if (prev)
3515 prev->next = list->next;
3516 else
3517 f->font_data_list = list->next;
3518 xfree (list);
3520 return 0;
3523 if (! list)
3525 list = xmalloc (sizeof (struct font_data_list));
3526 list->driver = driver;
3527 list->next = f->font_data_list;
3528 f->font_data_list = list;
3530 list->data = data;
3531 return 0;
3535 void *
3536 font_get_frame_data (FRAME_PTR f, struct font_driver *driver)
3538 struct font_data_list *list;
3540 for (list = f->font_data_list; list; list = list->next)
3541 if (list->driver == driver)
3542 break;
3543 if (! list)
3544 return NULL;
3545 return list->data;
3549 /* Sets attributes on a font. Any properties that appear in ALIST and
3550 BOOLEAN_PROPERTIES or NON_BOOLEAN_PROPERTIES are set on the font.
3551 BOOLEAN_PROPERTIES and NON_BOOLEAN_PROPERTIES are NULL-terminated
3552 arrays of strings. This function is intended for use by the font
3553 drivers to implement their specific font_filter_properties. */
3554 void
3555 font_filter_properties (Lisp_Object font,
3556 Lisp_Object alist,
3557 const char *const boolean_properties[],
3558 const char *const non_boolean_properties[])
3560 Lisp_Object it;
3561 int i;
3563 /* Set boolean values to Qt or Qnil */
3564 for (i = 0; boolean_properties[i] != NULL; ++i)
3565 for (it = alist; ! NILP (it); it = XCDR (it))
3567 Lisp_Object key = XCAR (XCAR (it));
3568 Lisp_Object val = XCDR (XCAR (it));
3569 char *keystr = SSDATA (SYMBOL_NAME (key));
3571 if (strcmp (boolean_properties[i], keystr) == 0)
3573 const char *str = INTEGERP (val) ? (XINT (val) ? "true" : "false")
3574 : SYMBOLP (val) ? SSDATA (SYMBOL_NAME (val))
3575 : "true";
3577 if (strcmp ("false", str) == 0 || strcmp ("False", str) == 0
3578 || strcmp ("FALSE", str) == 0 || strcmp ("FcFalse", str) == 0
3579 || strcmp ("off", str) == 0 || strcmp ("OFF", str) == 0
3580 || strcmp ("Off", str) == 0)
3581 val = Qnil;
3582 else
3583 val = Qt;
3585 Ffont_put (font, key, val);
3589 for (i = 0; non_boolean_properties[i] != NULL; ++i)
3590 for (it = alist; ! NILP (it); it = XCDR (it))
3592 Lisp_Object key = XCAR (XCAR (it));
3593 Lisp_Object val = XCDR (XCAR (it));
3594 char *keystr = SSDATA (SYMBOL_NAME (key));
3595 if (strcmp (non_boolean_properties[i], keystr) == 0)
3596 Ffont_put (font, key, val);
3601 /* Return the font used to draw character C by FACE at buffer position
3602 POS in window W. If STRING is non-nil, it is a string containing C
3603 at index POS. If C is negative, get C from the current buffer or
3604 STRING. */
3606 static Lisp_Object
3607 font_at (int c, EMACS_INT pos, struct face *face, struct window *w,
3608 Lisp_Object string)
3610 FRAME_PTR f;
3611 int multibyte;
3612 Lisp_Object font_object;
3614 multibyte = (NILP (string)
3615 ? ! NILP (BVAR (current_buffer, enable_multibyte_characters))
3616 : STRING_MULTIBYTE (string));
3617 if (c < 0)
3619 if (NILP (string))
3621 if (multibyte)
3623 EMACS_INT pos_byte = CHAR_TO_BYTE (pos);
3625 c = FETCH_CHAR (pos_byte);
3627 else
3628 c = FETCH_BYTE (pos);
3630 else
3632 unsigned char *str;
3634 multibyte = STRING_MULTIBYTE (string);
3635 if (multibyte)
3637 EMACS_INT pos_byte = string_char_to_byte (string, pos);
3639 str = SDATA (string) + pos_byte;
3640 c = STRING_CHAR (str);
3642 else
3643 c = SDATA (string)[pos];
3647 f = XFRAME (w->frame);
3648 if (! FRAME_WINDOW_P (f))
3649 return Qnil;
3650 if (! face)
3652 int face_id;
3653 EMACS_INT endptr;
3655 if (STRINGP (string))
3656 face_id = face_at_string_position (w, string, pos, 0, -1, -1, &endptr,
3657 DEFAULT_FACE_ID, 0);
3658 else
3659 face_id = face_at_buffer_position (w, pos, -1, -1, &endptr,
3660 pos + 100, 0, -1);
3661 face = FACE_FROM_ID (f, face_id);
3663 if (multibyte)
3665 int face_id = FACE_FOR_CHAR (f, face, c, pos, string);
3666 face = FACE_FROM_ID (f, face_id);
3668 if (! face->font)
3669 return Qnil;
3671 XSETFONT (font_object, face->font);
3672 return font_object;
3676 #ifdef HAVE_WINDOW_SYSTEM
3678 /* Check how many characters after POS (at most to *LIMIT) can be
3679 displayed by the same font in the window W. FACE, if non-NULL, is
3680 the face selected for the character at POS. If STRING is not nil,
3681 it is the string to check instead of the current buffer. In that
3682 case, FACE must be not NULL.
3684 The return value is the font-object for the character at POS.
3685 *LIMIT is set to the position where that font can't be used.
3687 It is assured that the current buffer (or STRING) is multibyte. */
3689 Lisp_Object
3690 font_range (EMACS_INT pos, EMACS_INT *limit, struct window *w, struct face *face, Lisp_Object string)
3692 EMACS_INT pos_byte, ignore;
3693 int c;
3694 Lisp_Object font_object = Qnil;
3696 if (NILP (string))
3698 pos_byte = CHAR_TO_BYTE (pos);
3699 if (! face)
3701 int face_id;
3703 face_id = face_at_buffer_position (w, pos, 0, 0, &ignore,
3704 *limit, 0, -1);
3705 face = FACE_FROM_ID (XFRAME (w->frame), face_id);
3708 else
3710 font_assert (face);
3711 pos_byte = string_char_to_byte (string, pos);
3714 while (pos < *limit)
3716 Lisp_Object category;
3718 if (NILP (string))
3719 FETCH_CHAR_ADVANCE_NO_CHECK (c, pos, pos_byte);
3720 else
3721 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, string, pos, pos_byte);
3722 category = CHAR_TABLE_REF (Vunicode_category_table, c);
3723 if (INTEGERP (category)
3724 && (XINT (category) == UNICODE_CATEGORY_Cf
3725 || CHAR_VARIATION_SELECTOR_P (c)))
3726 continue;
3727 if (NILP (font_object))
3729 font_object = font_for_char (face, c, pos - 1, string);
3730 if (NILP (font_object))
3731 return Qnil;
3732 continue;
3734 if (font_encode_char (font_object, c) == FONT_INVALID_CODE)
3735 *limit = pos - 1;
3737 return font_object;
3739 #endif
3742 /* Lisp API */
3744 DEFUN ("fontp", Ffontp, Sfontp, 1, 2, 0,
3745 doc: /* Return t if OBJECT is a font-spec, font-entity, or font-object.
3746 Return nil otherwise.
3747 Optional 2nd argument EXTRA-TYPE, if non-nil, specifies to check
3748 which kind of font it is. It must be one of `font-spec', `font-entity',
3749 `font-object'. */)
3750 (Lisp_Object object, Lisp_Object extra_type)
3752 if (NILP (extra_type))
3753 return (FONTP (object) ? Qt : Qnil);
3754 if (EQ (extra_type, Qfont_spec))
3755 return (FONT_SPEC_P (object) ? Qt : Qnil);
3756 if (EQ (extra_type, Qfont_entity))
3757 return (FONT_ENTITY_P (object) ? Qt : Qnil);
3758 if (EQ (extra_type, Qfont_object))
3759 return (FONT_OBJECT_P (object) ? Qt : Qnil);
3760 wrong_type_argument (intern ("font-extra-type"), extra_type);
3763 DEFUN ("font-spec", Ffont_spec, Sfont_spec, 0, MANY, 0,
3764 doc: /* Return a newly created font-spec with arguments as properties.
3766 ARGS must come in pairs KEY VALUE of font properties. KEY must be a
3767 valid font property name listed below:
3769 `:family', `:weight', `:slant', `:width'
3771 They are the same as face attributes of the same name. See
3772 `set-face-attribute'.
3774 `:foundry'
3776 VALUE must be a string or a symbol specifying the font foundry, e.g. ``misc''.
3778 `:adstyle'
3780 VALUE must be a string or a symbol specifying the additional
3781 typographic style information of a font, e.g. ``sans''.
3783 `:registry'
3785 VALUE must be a string or a symbol specifying the charset registry and
3786 encoding of a font, e.g. ``iso8859-1''.
3788 `:size'
3790 VALUE must be a non-negative integer or a floating point number
3791 specifying the font size. It specifies the font size in pixels (if
3792 VALUE is an integer), or in points (if VALUE is a float).
3794 `:name'
3796 VALUE must be a string of XLFD-style or fontconfig-style font name.
3798 `:script'
3800 VALUE must be a symbol representing a script that the font must
3801 support. It may be a symbol representing a subgroup of a script
3802 listed in the variable `script-representative-chars'.
3804 `:lang'
3806 VALUE must be a symbol of two-letter ISO-639 language names,
3807 e.g. `ja'.
3809 `:otf'
3811 VALUE must be a list (SCRIPT-TAG LANGSYS-TAG GSUB [ GPOS ]) to specify
3812 required OpenType features.
3814 SCRIPT-TAG: OpenType script tag symbol (e.g. `deva').
3815 LANGSYS-TAG: OpenType language system tag symbol,
3816 or nil for the default language system.
3817 GSUB: List of OpenType GSUB feature tag symbols, or nil if none required.
3818 GPOS: List of OpenType GPOS feature tag symbols, or nil if none required.
3820 GSUB and GPOS may contain `nil' element. In such a case, the font
3821 must not have any of the remaining elements.
3823 For instance, if the VALUE is `(thai nil nil (mark))', the font must
3824 be an OpenType font whose GPOS table of `thai' script's default
3825 language system must contain `mark' feature.
3827 usage: (font-spec ARGS...) */)
3828 (ptrdiff_t nargs, Lisp_Object *args)
3830 Lisp_Object spec = font_make_spec ();
3831 ptrdiff_t i;
3833 for (i = 0; i < nargs; i += 2)
3835 Lisp_Object key = args[i], val;
3837 CHECK_SYMBOL (key);
3838 if (i + 1 >= nargs)
3839 error ("No value for key `%s'", SDATA (SYMBOL_NAME (key)));
3840 val = args[i + 1];
3842 if (EQ (key, QCname))
3844 CHECK_STRING (val);
3845 font_parse_name (SSDATA (val), spec);
3846 font_put_extra (spec, key, val);
3848 else
3850 int idx = get_font_prop_index (key);
3852 if (idx >= 0)
3854 val = font_prop_validate (idx, Qnil, val);
3855 if (idx < FONT_EXTRA_INDEX)
3856 ASET (spec, idx, val);
3857 else
3858 font_put_extra (spec, key, val);
3860 else
3861 font_put_extra (spec, key, font_prop_validate (0, key, val));
3864 return spec;
3867 /* Return a copy of FONT as a font-spec. */
3868 Lisp_Object
3869 copy_font_spec (Lisp_Object font)
3871 Lisp_Object new_spec, tail, prev, extra;
3872 int i;
3874 CHECK_FONT (font);
3875 new_spec = font_make_spec ();
3876 for (i = 1; i < FONT_EXTRA_INDEX; i++)
3877 ASET (new_spec, i, AREF (font, i));
3878 extra = Fcopy_alist (AREF (font, FONT_EXTRA_INDEX));
3879 /* We must remove :font-entity property. */
3880 for (prev = Qnil, tail = extra; CONSP (tail); prev = tail, tail = XCDR (tail))
3881 if (EQ (XCAR (XCAR (tail)), QCfont_entity))
3883 if (NILP (prev))
3884 extra = XCDR (extra);
3885 else
3886 XSETCDR (prev, XCDR (tail));
3887 break;
3889 ASET (new_spec, FONT_EXTRA_INDEX, extra);
3890 return new_spec;
3893 /* Merge font-specs FROM and TO, and return a new font-spec.
3894 Every specified property in FROM overrides the corresponding
3895 property in TO. */
3896 Lisp_Object
3897 merge_font_spec (Lisp_Object from, Lisp_Object to)
3899 Lisp_Object extra, tail;
3900 int i;
3902 CHECK_FONT (from);
3903 CHECK_FONT (to);
3904 to = copy_font_spec (to);
3905 for (i = 0; i < FONT_EXTRA_INDEX; i++)
3906 ASET (to, i, AREF (from, i));
3907 extra = AREF (to, FONT_EXTRA_INDEX);
3908 for (tail = AREF (from, FONT_EXTRA_INDEX); CONSP (tail); tail = XCDR (tail))
3909 if (! EQ (XCAR (XCAR (tail)), Qfont_entity))
3911 Lisp_Object slot = assq_no_quit (XCAR (XCAR (tail)), extra);
3913 if (! NILP (slot))
3914 XSETCDR (slot, XCDR (XCAR (tail)));
3915 else
3916 extra = Fcons (Fcons (XCAR (XCAR (tail)), XCDR (XCAR (tail))), extra);
3918 ASET (to, FONT_EXTRA_INDEX, extra);
3919 return to;
3922 DEFUN ("font-get", Ffont_get, Sfont_get, 2, 2, 0,
3923 doc: /* Return the value of FONT's property KEY.
3924 FONT is a font-spec, a font-entity, or a font-object.
3925 KEY is any symbol, but these are reserved for specific meanings:
3926 :family, :weight, :slant, :width, :foundry, :adstyle, :registry,
3927 :size, :name, :script, :otf
3928 See the documentation of `font-spec' for their meanings.
3929 In addition, if FONT is a font-entity or a font-object, values of
3930 :script and :otf are different from those of a font-spec as below:
3932 The value of :script may be a list of scripts that are supported by the font.
3934 The value of :otf is a cons (GSUB . GPOS) where GSUB and GPOS are lists
3935 representing the OpenType features supported by the font by this form:
3936 ((SCRIPT (LANGSYS FEATURE ...) ...) ...)
3937 SCRIPT, LANGSYS, and FEATURE are all symbols representing OpenType
3938 Layout tags. */)
3939 (Lisp_Object font, Lisp_Object key)
3941 int idx;
3942 Lisp_Object val;
3944 CHECK_FONT (font);
3945 CHECK_SYMBOL (key);
3947 idx = get_font_prop_index (key);
3948 if (idx >= FONT_WEIGHT_INDEX && idx <= FONT_WIDTH_INDEX)
3949 return font_style_symbolic (font, idx, 0);
3950 if (idx >= 0 && idx < FONT_EXTRA_INDEX)
3951 return AREF (font, idx);
3952 val = Fassq (key, AREF (font, FONT_EXTRA_INDEX));
3953 if (NILP (val) && EQ (key, QCotf) && FONT_OBJECT_P (font))
3955 struct font *fontp = XFONT_OBJECT (font);
3957 if (fontp->driver->otf_capability)
3958 val = fontp->driver->otf_capability (fontp);
3959 else
3960 val = Fcons (Qnil, Qnil);
3962 else
3963 val = Fcdr (val);
3964 return val;
3967 #ifdef HAVE_WINDOW_SYSTEM
3969 DEFUN ("font-face-attributes", Ffont_face_attributes, Sfont_face_attributes, 1, 2, 0,
3970 doc: /* Return a plist of face attributes generated by FONT.
3971 FONT is a font name, a font-spec, a font-entity, or a font-object.
3972 The return value is a list of the form
3974 \(:family FAMILY :height HEIGHT :weight WEIGHT :slant SLANT :width WIDTH)
3976 where FAMILY, HEIGHT, WEIGHT, SLANT, and WIDTH are face attribute values
3977 compatible with `set-face-attribute'. Some of these key-attribute pairs
3978 may be omitted from the list if they are not specified by FONT.
3980 The optional argument FRAME specifies the frame that the face attributes
3981 are to be displayed on. If omitted, the selected frame is used. */)
3982 (Lisp_Object font, Lisp_Object frame)
3984 struct frame *f;
3985 Lisp_Object plist[10];
3986 Lisp_Object val;
3987 int n = 0;
3989 if (NILP (frame))
3990 frame = selected_frame;
3991 CHECK_LIVE_FRAME (frame);
3992 f = XFRAME (frame);
3994 if (STRINGP (font))
3996 int fontset = fs_query_fontset (font, 0);
3997 Lisp_Object name = font;
3998 if (fontset >= 0)
3999 font = fontset_ascii (fontset);
4000 font = font_spec_from_name (name);
4001 if (! FONTP (font))
4002 signal_error ("Invalid font name", name);
4004 else if (! FONTP (font))
4005 signal_error ("Invalid font object", font);
4007 val = AREF (font, FONT_FAMILY_INDEX);
4008 if (! NILP (val))
4010 plist[n++] = QCfamily;
4011 plist[n++] = SYMBOL_NAME (val);
4014 val = AREF (font, FONT_SIZE_INDEX);
4015 if (INTEGERP (val))
4017 Lisp_Object font_dpi = AREF (font, FONT_DPI_INDEX);
4018 int dpi = INTEGERP (font_dpi) ? XINT (font_dpi) : f->resy;
4019 plist[n++] = QCheight;
4020 plist[n++] = make_number (PIXEL_TO_POINT (XINT (val) * 10, dpi));
4022 else if (FLOATP (val))
4024 plist[n++] = QCheight;
4025 plist[n++] = make_number (10 * (int) XFLOAT_DATA (val));
4028 val = FONT_WEIGHT_FOR_FACE (font);
4029 if (! NILP (val))
4031 plist[n++] = QCweight;
4032 plist[n++] = val;
4035 val = FONT_SLANT_FOR_FACE (font);
4036 if (! NILP (val))
4038 plist[n++] = QCslant;
4039 plist[n++] = val;
4042 val = FONT_WIDTH_FOR_FACE (font);
4043 if (! NILP (val))
4045 plist[n++] = QCwidth;
4046 plist[n++] = val;
4049 return Flist (n, plist);
4052 #endif
4054 DEFUN ("font-put", Ffont_put, Sfont_put, 3, 3, 0,
4055 doc: /* Set one property of FONT: give property KEY value VAL.
4056 FONT is a font-spec, a font-entity, or a font-object.
4058 If FONT is a font-spec, KEY can be any symbol. But if KEY is the one
4059 accepted by the function `font-spec' (which see), VAL must be what
4060 allowed in `font-spec'.
4062 If FONT is a font-entity or a font-object, KEY must not be the one
4063 accepted by `font-spec'. */)
4064 (Lisp_Object font, Lisp_Object prop, Lisp_Object val)
4066 int idx;
4068 idx = get_font_prop_index (prop);
4069 if (idx >= 0 && idx < FONT_EXTRA_INDEX)
4071 CHECK_FONT_SPEC (font);
4072 ASET (font, idx, font_prop_validate (idx, Qnil, val));
4074 else
4076 if (EQ (prop, QCname)
4077 || EQ (prop, QCscript)
4078 || EQ (prop, QClang)
4079 || EQ (prop, QCotf))
4080 CHECK_FONT_SPEC (font);
4081 else
4082 CHECK_FONT (font);
4083 font_put_extra (font, prop, font_prop_validate (0, prop, val));
4085 return val;
4088 DEFUN ("list-fonts", Flist_fonts, Slist_fonts, 1, 4, 0,
4089 doc: /* List available fonts matching FONT-SPEC on the current frame.
4090 Optional 2nd argument FRAME specifies the target frame.
4091 Optional 3rd argument NUM, if non-nil, limits the number of returned fonts.
4092 Optional 4th argument PREFER, if non-nil, is a font-spec to
4093 control the order of the returned list. Fonts are sorted by
4094 how close they are to PREFER. */)
4095 (Lisp_Object font_spec, Lisp_Object frame, Lisp_Object num, Lisp_Object prefer)
4097 Lisp_Object vec, list;
4098 int n = 0;
4100 if (NILP (frame))
4101 frame = selected_frame;
4102 CHECK_LIVE_FRAME (frame);
4103 CHECK_FONT_SPEC (font_spec);
4104 if (! NILP (num))
4106 CHECK_NUMBER (num);
4107 n = XINT (num);
4108 if (n <= 0)
4109 return Qnil;
4111 if (! NILP (prefer))
4112 CHECK_FONT_SPEC (prefer);
4114 list = font_list_entities (frame, font_spec);
4115 if (NILP (list))
4116 return Qnil;
4117 if (NILP (XCDR (list))
4118 && ASIZE (XCAR (list)) == 1)
4119 return Fcons (AREF (XCAR (list), 0), Qnil);
4121 if (! NILP (prefer))
4122 vec = font_sort_entities (list, prefer, frame, 0);
4123 else
4124 vec = font_vconcat_entity_vectors (list);
4125 if (n == 0 || n >= ASIZE (vec))
4127 Lisp_Object args[2];
4129 args[0] = vec;
4130 args[1] = Qnil;
4131 list = Fappend (2, args);
4133 else
4135 for (list = Qnil, n--; n >= 0; n--)
4136 list = Fcons (AREF (vec, n), list);
4138 return list;
4141 DEFUN ("font-family-list", Ffont_family_list, Sfont_family_list, 0, 1, 0,
4142 doc: /* List available font families on the current frame.
4143 Optional argument FRAME, if non-nil, specifies the target frame. */)
4144 (Lisp_Object frame)
4146 FRAME_PTR f;
4147 struct font_driver_list *driver_list;
4148 Lisp_Object list;
4150 if (NILP (frame))
4151 frame = selected_frame;
4152 CHECK_LIVE_FRAME (frame);
4153 f = XFRAME (frame);
4154 list = Qnil;
4155 for (driver_list = f->font_driver_list; driver_list;
4156 driver_list = driver_list->next)
4157 if (driver_list->driver->list_family)
4159 Lisp_Object val = driver_list->driver->list_family (frame);
4160 Lisp_Object tail = list;
4162 for (; CONSP (val); val = XCDR (val))
4163 if (NILP (Fmemq (XCAR (val), tail))
4164 && SYMBOLP (XCAR (val)))
4165 list = Fcons (SYMBOL_NAME (XCAR (val)), list);
4167 return list;
4170 DEFUN ("find-font", Ffind_font, Sfind_font, 1, 2, 0,
4171 doc: /* Return a font-entity matching with FONT-SPEC on the current frame.
4172 Optional 2nd argument FRAME, if non-nil, specifies the target frame. */)
4173 (Lisp_Object font_spec, Lisp_Object frame)
4175 Lisp_Object val = Flist_fonts (font_spec, frame, make_number (1), Qnil);
4177 if (CONSP (val))
4178 val = XCAR (val);
4179 return val;
4182 DEFUN ("font-xlfd-name", Ffont_xlfd_name, Sfont_xlfd_name, 1, 2, 0,
4183 doc: /* Return XLFD name of FONT.
4184 FONT is a font-spec, font-entity, or font-object.
4185 If the name is too long for XLFD (maximum 255 chars), return nil.
4186 If the 2nd optional arg FOLD-WILDCARDS is non-nil,
4187 the consecutive wildcards are folded into one. */)
4188 (Lisp_Object font, Lisp_Object fold_wildcards)
4190 char name[256];
4191 int pixel_size = 0;
4193 CHECK_FONT (font);
4195 if (FONT_OBJECT_P (font))
4197 Lisp_Object font_name = AREF (font, FONT_NAME_INDEX);
4199 if (STRINGP (font_name)
4200 && SDATA (font_name)[0] == '-')
4202 if (NILP (fold_wildcards))
4203 return font_name;
4204 strcpy (name, SSDATA (font_name));
4205 goto done;
4207 pixel_size = XFONT_OBJECT (font)->pixel_size;
4209 if (font_unparse_xlfd (font, pixel_size, name, 256) < 0)
4210 return Qnil;
4211 done:
4212 if (! NILP (fold_wildcards))
4214 char *p0 = name, *p1;
4216 while ((p1 = strstr (p0, "-*-*")))
4218 strcpy (p1, p1 + 2);
4219 p0 = p1;
4223 return build_string (name);
4226 DEFUN ("clear-font-cache", Fclear_font_cache, Sclear_font_cache, 0, 0, 0,
4227 doc: /* Clear font cache. */)
4228 (void)
4230 Lisp_Object list, frame;
4232 FOR_EACH_FRAME (list, frame)
4234 FRAME_PTR f = XFRAME (frame);
4235 struct font_driver_list *driver_list = f->font_driver_list;
4237 for (; driver_list; driver_list = driver_list->next)
4238 if (driver_list->on)
4240 Lisp_Object cache = driver_list->driver->get_cache (f);
4241 Lisp_Object val, tmp;
4243 val = XCDR (cache);
4244 while (! NILP (val)
4245 && ! EQ (XCAR (XCAR (val)), driver_list->driver->type))
4246 val = XCDR (val);
4247 font_assert (! NILP (val));
4248 tmp = XCDR (XCAR (val));
4249 if (XINT (XCAR (tmp)) == 0)
4251 font_clear_cache (f, XCAR (val), driver_list->driver);
4252 XSETCDR (cache, XCDR (val));
4257 return Qnil;
4261 void
4262 font_fill_lglyph_metrics (Lisp_Object glyph, Lisp_Object font_object)
4264 struct font *font = XFONT_OBJECT (font_object);
4265 unsigned code;
4266 /* ecode used in LGLYPH_SET_CODE to avoid compiler warnings. */
4267 EMACS_INT ecode = font->driver->encode_char (font, LGLYPH_CHAR (glyph));
4268 struct font_metrics metrics;
4270 LGLYPH_SET_CODE (glyph, ecode);
4271 code = ecode;
4272 font->driver->text_extents (font, &code, 1, &metrics);
4273 LGLYPH_SET_LBEARING (glyph, metrics.lbearing);
4274 LGLYPH_SET_RBEARING (glyph, metrics.rbearing);
4275 LGLYPH_SET_WIDTH (glyph, metrics.width);
4276 LGLYPH_SET_ASCENT (glyph, metrics.ascent);
4277 LGLYPH_SET_DESCENT (glyph, metrics.descent);
4281 DEFUN ("font-shape-gstring", Ffont_shape_gstring, Sfont_shape_gstring, 1, 1, 0,
4282 doc: /* Shape the glyph-string GSTRING.
4283 Shaping means substituting glyphs and/or adjusting positions of glyphs
4284 to get the correct visual image of character sequences set in the
4285 header of the glyph-string.
4287 If the shaping was successful, the value is GSTRING itself or a newly
4288 created glyph-string. Otherwise, the value is nil. */)
4289 (Lisp_Object gstring)
4291 struct font *font;
4292 Lisp_Object font_object, n, glyph;
4293 EMACS_INT i, j, from, to;
4295 if (! composition_gstring_p (gstring))
4296 signal_error ("Invalid glyph-string: ", gstring);
4297 if (! NILP (LGSTRING_ID (gstring)))
4298 return gstring;
4299 font_object = LGSTRING_FONT (gstring);
4300 CHECK_FONT_OBJECT (font_object);
4301 font = XFONT_OBJECT (font_object);
4302 if (! font->driver->shape)
4303 return Qnil;
4305 /* Try at most three times with larger gstring each time. */
4306 for (i = 0; i < 3; i++)
4308 n = font->driver->shape (gstring);
4309 if (INTEGERP (n))
4310 break;
4311 gstring = larger_vector (gstring,
4312 ASIZE (gstring) + LGSTRING_GLYPH_LEN (gstring),
4313 Qnil);
4315 if (i == 3 || XINT (n) == 0)
4316 return Qnil;
4317 if (XINT (n) < LGSTRING_GLYPH_LEN (gstring))
4318 LGSTRING_SET_GLYPH (gstring, XINT (n), Qnil);
4320 glyph = LGSTRING_GLYPH (gstring, 0);
4321 from = LGLYPH_FROM (glyph);
4322 to = LGLYPH_TO (glyph);
4323 for (i = 1, j = 0; i < LGSTRING_GLYPH_LEN (gstring); i++)
4325 Lisp_Object this = LGSTRING_GLYPH (gstring, i);
4327 if (NILP (this))
4328 break;
4329 if (NILP (LGLYPH_ADJUSTMENT (this)))
4331 if (j < i - 1)
4332 for (; j < i; j++)
4334 glyph = LGSTRING_GLYPH (gstring, j);
4335 LGLYPH_SET_FROM (glyph, from);
4336 LGLYPH_SET_TO (glyph, to);
4338 from = LGLYPH_FROM (this);
4339 to = LGLYPH_TO (this);
4340 j = i;
4342 else
4344 if (from > LGLYPH_FROM (this))
4345 from = LGLYPH_FROM (this);
4346 if (to < LGLYPH_TO (this))
4347 to = LGLYPH_TO (this);
4350 if (j < i - 1)
4351 for (; j < i; j++)
4353 glyph = LGSTRING_GLYPH (gstring, j);
4354 LGLYPH_SET_FROM (glyph, from);
4355 LGLYPH_SET_TO (glyph, to);
4357 return composition_gstring_put_cache (gstring, XINT (n));
4360 DEFUN ("font-variation-glyphs", Ffont_variation_glyphs, Sfont_variation_glyphs,
4361 2, 2, 0,
4362 doc: /* Return a list of variation glyphs for CHAR in FONT-OBJECT.
4363 Each element of the value is a cons (VARIATION-SELECTOR . GLYPH-ID),
4364 where
4365 VARIATION-SELECTOR is a character code of variation selection
4366 (#xFE00..#xFE0F or #xE0100..#xE01EF)
4367 GLYPH-ID is a glyph code of the corresponding variation glyph. */)
4368 (Lisp_Object font_object, Lisp_Object character)
4370 unsigned variations[256];
4371 struct font *font;
4372 int i, n;
4373 Lisp_Object val;
4375 CHECK_FONT_OBJECT (font_object);
4376 CHECK_CHARACTER (character);
4377 font = XFONT_OBJECT (font_object);
4378 if (! font->driver->get_variation_glyphs)
4379 return Qnil;
4380 n = font->driver->get_variation_glyphs (font, XINT (character), variations);
4381 if (! n)
4382 return Qnil;
4383 val = Qnil;
4384 for (i = 0; i < 255; i++)
4385 if (variations[i])
4387 int vs = (i < 16 ? 0xFE00 + i : 0xE0100 + (i - 16));
4388 Lisp_Object code = INTEGER_TO_CONS (variations[i]);
4389 val = Fcons (Fcons (make_number (vs), code), val);
4391 return val;
4394 #if 0
4396 DEFUN ("font-drive-otf", Ffont_drive_otf, Sfont_drive_otf, 6, 6, 0,
4397 doc: /* Apply OpenType features on glyph-string GSTRING-IN.
4398 OTF-FEATURES specifies which features to apply in this format:
4399 (SCRIPT LANGSYS GSUB GPOS)
4400 where
4401 SCRIPT is a symbol specifying a script tag of OpenType,
4402 LANGSYS is a symbol specifying a langsys tag of OpenType,
4403 GSUB and GPOS, if non-nil, are lists of symbols specifying feature tags.
4405 If LANGYS is nil, the default langsys is selected.
4407 The features are applied in the order they appear in the list. The
4408 symbol `*' means to apply all available features not present in this
4409 list, and the remaining features are ignored. For instance, (vatu
4410 pstf * haln) is to apply vatu and pstf in this order, then to apply
4411 all available features other than vatu, pstf, and haln.
4413 The features are applied to the glyphs in the range FROM and TO of
4414 the glyph-string GSTRING-IN.
4416 If some feature is actually applicable, the resulting glyphs are
4417 produced in the glyph-string GSTRING-OUT from the index INDEX. In
4418 this case, the value is the number of produced glyphs.
4420 If no feature is applicable, no glyph is produced in GSTRING-OUT, and
4421 the value is 0.
4423 If GSTRING-OUT is too short to hold produced glyphs, no glyphs are
4424 produced in GSTRING-OUT, and the value is nil.
4426 See the documentation of `composition-get-gstring' for the format of
4427 glyph-string. */)
4428 (Lisp_Object otf_features, Lisp_Object gstring_in, Lisp_Object from, Lisp_Object to, Lisp_Object gstring_out, Lisp_Object index)
4430 Lisp_Object font_object = LGSTRING_FONT (gstring_in);
4431 Lisp_Object val;
4432 struct font *font;
4433 int len, num;
4435 check_otf_features (otf_features);
4436 CHECK_FONT_OBJECT (font_object);
4437 font = XFONT_OBJECT (font_object);
4438 if (! font->driver->otf_drive)
4439 error ("Font backend %s can't drive OpenType GSUB table",
4440 SDATA (SYMBOL_NAME (font->driver->type)));
4441 CHECK_CONS (otf_features);
4442 CHECK_SYMBOL (XCAR (otf_features));
4443 val = XCDR (otf_features);
4444 CHECK_SYMBOL (XCAR (val));
4445 val = XCDR (otf_features);
4446 if (! NILP (val))
4447 CHECK_CONS (val);
4448 len = check_gstring (gstring_in);
4449 CHECK_VECTOR (gstring_out);
4450 CHECK_NATNUM (from);
4451 CHECK_NATNUM (to);
4452 CHECK_NATNUM (index);
4454 if (XINT (from) >= XINT (to) || XINT (to) > len)
4455 args_out_of_range_3 (from, to, make_number (len));
4456 if (XINT (index) >= ASIZE (gstring_out))
4457 args_out_of_range (index, make_number (ASIZE (gstring_out)));
4458 num = font->driver->otf_drive (font, otf_features,
4459 gstring_in, XINT (from), XINT (to),
4460 gstring_out, XINT (index), 0);
4461 if (num < 0)
4462 return Qnil;
4463 return make_number (num);
4466 DEFUN ("font-otf-alternates", Ffont_otf_alternates, Sfont_otf_alternates,
4467 3, 3, 0,
4468 doc: /* Return a list of alternate glyphs of CHARACTER in FONT-OBJECT.
4469 OTF-FEATURES specifies which features of the font FONT-OBJECT to apply
4470 in this format:
4471 (SCRIPT LANGSYS FEATURE ...)
4472 See the documentation of `font-drive-otf' for more detail.
4474 The value is a list of cons cells of the format (GLYPH-ID . CHARACTER),
4475 where GLYPH-ID is a glyph index of the font, and CHARACTER is a
4476 character code corresponding to the glyph or nil if there's no
4477 corresponding character. */)
4478 (Lisp_Object font_object, Lisp_Object character, Lisp_Object otf_features)
4480 struct font *font;
4481 Lisp_Object gstring_in, gstring_out, g;
4482 Lisp_Object alternates;
4483 int i, num;
4485 CHECK_FONT_GET_OBJECT (font_object, font);
4486 if (! font->driver->otf_drive)
4487 error ("Font backend %s can't drive OpenType GSUB table",
4488 SDATA (SYMBOL_NAME (font->driver->type)));
4489 CHECK_CHARACTER (character);
4490 CHECK_CONS (otf_features);
4492 gstring_in = Ffont_make_gstring (font_object, make_number (1));
4493 g = LGSTRING_GLYPH (gstring_in, 0);
4494 LGLYPH_SET_CHAR (g, XINT (character));
4495 gstring_out = Ffont_make_gstring (font_object, make_number (10));
4496 while ((num = font->driver->otf_drive (font, otf_features, gstring_in, 0, 1,
4497 gstring_out, 0, 1)) < 0)
4498 gstring_out = Ffont_make_gstring (font_object,
4499 make_number (ASIZE (gstring_out) * 2));
4500 alternates = Qnil;
4501 for (i = 0; i < num; i++)
4503 Lisp_Object g = LGSTRING_GLYPH (gstring_out, i);
4504 int c = LGLYPH_CHAR (g);
4505 unsigned code = LGLYPH_CODE (g);
4507 alternates = Fcons (Fcons (make_number (code),
4508 c > 0 ? make_number (c) : Qnil),
4509 alternates);
4511 return Fnreverse (alternates);
4513 #endif /* 0 */
4515 #ifdef FONT_DEBUG
4517 DEFUN ("open-font", Fopen_font, Sopen_font, 1, 3, 0,
4518 doc: /* Open FONT-ENTITY. */)
4519 (Lisp_Object font_entity, Lisp_Object size, Lisp_Object frame)
4521 int isize;
4523 CHECK_FONT_ENTITY (font_entity);
4524 if (NILP (frame))
4525 frame = selected_frame;
4526 CHECK_LIVE_FRAME (frame);
4528 if (NILP (size))
4529 isize = XINT (AREF (font_entity, FONT_SIZE_INDEX));
4530 else
4532 CHECK_NUMBER_OR_FLOAT (size);
4533 if (FLOATP (size))
4534 isize = POINT_TO_PIXEL (XFLOAT_DATA (size), XFRAME (frame)->resy);
4535 else
4536 isize = XINT (size);
4537 if (isize == 0)
4538 isize = 120;
4540 return font_open_entity (XFRAME (frame), font_entity, isize);
4543 DEFUN ("close-font", Fclose_font, Sclose_font, 1, 2, 0,
4544 doc: /* Close FONT-OBJECT. */)
4545 (Lisp_Object font_object, Lisp_Object frame)
4547 CHECK_FONT_OBJECT (font_object);
4548 if (NILP (frame))
4549 frame = selected_frame;
4550 CHECK_LIVE_FRAME (frame);
4551 font_close_object (XFRAME (frame), font_object);
4552 return Qnil;
4555 DEFUN ("query-font", Fquery_font, Squery_font, 1, 1, 0,
4556 doc: /* Return information about FONT-OBJECT.
4557 The value is a vector:
4558 [ NAME FILENAME PIXEL-SIZE SIZE ASCENT DESCENT SPACE-WIDTH AVERAGE-WIDTH
4559 CAPABILITY ]
4561 NAME is the font name, a string (or nil if the font backend doesn't
4562 provide a name).
4564 FILENAME is the font file name, a string (or nil if the font backend
4565 doesn't provide a file name).
4567 PIXEL-SIZE is a pixel size by which the font is opened.
4569 SIZE is a maximum advance width of the font in pixels.
4571 ASCENT, DESCENT, SPACE-WIDTH, AVERAGE-WIDTH are metrics of the font in
4572 pixels.
4574 CAPABILITY is a list whose first element is a symbol representing the
4575 font format \(x, opentype, truetype, type1, pcf, or bdf) and the
4576 remaining elements describe the details of the font capability.
4578 If the font is OpenType font, the form of the list is
4579 \(opentype GSUB GPOS)
4580 where GSUB shows which "GSUB" features the font supports, and GPOS
4581 shows which "GPOS" features the font supports. Both GSUB and GPOS are
4582 lists of the format:
4583 \((SCRIPT (LANGSYS FEATURE ...) ...) ...)
4585 If the font is not OpenType font, currently the length of the form is
4586 one.
4588 SCRIPT is a symbol representing OpenType script tag.
4590 LANGSYS is a symbol representing OpenType langsys tag, or nil
4591 representing the default langsys.
4593 FEATURE is a symbol representing OpenType feature tag.
4595 If the font is not OpenType font, CAPABILITY is nil. */)
4596 (Lisp_Object font_object)
4598 struct font *font;
4599 Lisp_Object val;
4601 CHECK_FONT_GET_OBJECT (font_object, font);
4603 val = Fmake_vector (make_number (9), Qnil);
4604 ASET (val, 0, AREF (font_object, FONT_NAME_INDEX));
4605 ASET (val, 1, AREF (font_object, FONT_FILE_INDEX));
4606 ASET (val, 2, make_number (font->pixel_size));
4607 ASET (val, 3, make_number (font->max_width));
4608 ASET (val, 4, make_number (font->ascent));
4609 ASET (val, 5, make_number (font->descent));
4610 ASET (val, 6, make_number (font->space_width));
4611 ASET (val, 7, make_number (font->average_width));
4612 if (font->driver->otf_capability)
4613 ASET (val, 8, Fcons (Qopentype, font->driver->otf_capability (font)));
4614 return val;
4617 DEFUN ("font-get-glyphs", Ffont_get_glyphs, Sfont_get_glyphs, 3, 4, 0,
4618 doc:
4619 /* Return a vector of FONT-OBJECT's glyphs for the specified characters.
4620 FROM and TO are positions (integers or markers) specifying a region
4621 of the current buffer.
4622 If the optional fourth arg OBJECT is not nil, it is a string or a
4623 vector containing the target characters.
4625 Each element is a vector containing information of a glyph in this format:
4626 [FROM-IDX TO-IDX C CODE WIDTH LBEARING RBEARING ASCENT DESCENT ADJUSTMENT]
4627 where
4628 FROM is an index numbers of a character the glyph corresponds to.
4629 TO is the same as FROM.
4630 C is the character of the glyph.
4631 CODE is the glyph-code of C in FONT-OBJECT.
4632 WIDTH thru DESCENT are the metrics (in pixels) of the glyph.
4633 ADJUSTMENT is always nil.
4634 If FONT-OBJECT doesn't have a glyph for a character,
4635 the corresponding element is nil. */)
4636 (Lisp_Object font_object, Lisp_Object from, Lisp_Object to,
4637 Lisp_Object object)
4639 struct font *font;
4640 int i, len;
4641 Lisp_Object *chars, vec;
4642 USE_SAFE_ALLOCA;
4644 CHECK_FONT_GET_OBJECT (font_object, font);
4645 if (NILP (object))
4647 EMACS_INT charpos, bytepos;
4649 validate_region (&from, &to);
4650 if (EQ (from, to))
4651 return Qnil;
4652 len = XFASTINT (to) - XFASTINT (from);
4653 SAFE_ALLOCA_LISP (chars, len);
4654 charpos = XFASTINT (from);
4655 bytepos = CHAR_TO_BYTE (charpos);
4656 for (i = 0; charpos < XFASTINT (to); i++)
4658 int c;
4659 FETCH_CHAR_ADVANCE (c, charpos, bytepos);
4660 chars[i] = make_number (c);
4663 else if (STRINGP (object))
4665 const unsigned char *p;
4667 CHECK_NUMBER (from);
4668 CHECK_NUMBER (to);
4669 if (XINT (from) < 0 || XINT (from) > XINT (to)
4670 || XINT (to) > SCHARS (object))
4671 args_out_of_range_3 (object, from, to);
4672 if (EQ (from, to))
4673 return Qnil;
4674 len = XFASTINT (to) - XFASTINT (from);
4675 SAFE_ALLOCA_LISP (chars, len);
4676 p = SDATA (object);
4677 if (STRING_MULTIBYTE (object))
4678 for (i = 0; i < len; i++)
4680 int c = STRING_CHAR_ADVANCE (p);
4681 chars[i] = make_number (c);
4683 else
4684 for (i = 0; i < len; i++)
4685 chars[i] = make_number (p[i]);
4687 else
4689 CHECK_VECTOR (object);
4690 CHECK_NUMBER (from);
4691 CHECK_NUMBER (to);
4692 if (XINT (from) < 0 || XINT (from) > XINT (to)
4693 || XINT (to) > ASIZE (object))
4694 args_out_of_range_3 (object, from, to);
4695 if (EQ (from, to))
4696 return Qnil;
4697 len = XFASTINT (to) - XFASTINT (from);
4698 for (i = 0; i < len; i++)
4700 Lisp_Object elt = AREF (object, XFASTINT (from) + i);
4701 CHECK_CHARACTER (elt);
4703 chars = &(AREF (object, XFASTINT (from)));
4706 vec = Fmake_vector (make_number (len), Qnil);
4707 for (i = 0; i < len; i++)
4709 Lisp_Object g;
4710 int c = XFASTINT (chars[i]);
4711 unsigned code;
4712 struct font_metrics metrics;
4714 code = font->driver->encode_char (font, c);
4715 if (code == FONT_INVALID_CODE)
4716 continue;
4717 g = Fmake_vector (make_number (LGLYPH_SIZE), Qnil);
4718 LGLYPH_SET_FROM (g, i);
4719 LGLYPH_SET_TO (g, i);
4720 LGLYPH_SET_CHAR (g, c);
4721 LGLYPH_SET_CODE (g, code);
4722 font->driver->text_extents (font, &code, 1, &metrics);
4723 LGLYPH_SET_WIDTH (g, metrics.width);
4724 LGLYPH_SET_LBEARING (g, metrics.lbearing);
4725 LGLYPH_SET_RBEARING (g, metrics.rbearing);
4726 LGLYPH_SET_ASCENT (g, metrics.ascent);
4727 LGLYPH_SET_DESCENT (g, metrics.descent);
4728 ASET (vec, i, g);
4730 if (! VECTORP (object))
4731 SAFE_FREE ();
4732 return vec;
4735 DEFUN ("font-match-p", Ffont_match_p, Sfont_match_p, 2, 2, 0,
4736 doc: /* Return t if and only if font-spec SPEC matches with FONT.
4737 FONT is a font-spec, font-entity, or font-object. */)
4738 (Lisp_Object spec, Lisp_Object font)
4740 CHECK_FONT_SPEC (spec);
4741 CHECK_FONT (font);
4743 return (font_match_p (spec, font) ? Qt : Qnil);
4746 DEFUN ("font-at", Ffont_at, Sfont_at, 1, 3, 0,
4747 doc: /* Return a font-object for displaying a character at POSITION.
4748 Optional second arg WINDOW, if non-nil, is a window displaying
4749 the current buffer. It defaults to the currently selected window. */)
4750 (Lisp_Object position, Lisp_Object window, Lisp_Object string)
4752 struct window *w;
4753 EMACS_INT pos;
4755 if (NILP (string))
4757 CHECK_NUMBER_COERCE_MARKER (position);
4758 pos = XINT (position);
4759 if (pos < BEGV || pos >= ZV)
4760 args_out_of_range_3 (position, make_number (BEGV), make_number (ZV));
4762 else
4764 CHECK_NUMBER (position);
4765 CHECK_STRING (string);
4766 pos = XINT (position);
4767 if (pos < 0 || pos >= SCHARS (string))
4768 args_out_of_range (string, position);
4770 if (NILP (window))
4771 window = selected_window;
4772 CHECK_LIVE_WINDOW (window);
4773 w = XWINDOW (window);
4775 return font_at (-1, pos, NULL, w, string);
4778 #if 0
4779 DEFUN ("draw-string", Fdraw_string, Sdraw_string, 2, 2, 0,
4780 doc: /* Draw STRING by FONT-OBJECT on the top left corner of the current frame.
4781 The value is a number of glyphs drawn.
4782 Type C-l to recover what previously shown. */)
4783 (Lisp_Object font_object, Lisp_Object string)
4785 Lisp_Object frame = selected_frame;
4786 FRAME_PTR f = XFRAME (frame);
4787 struct font *font;
4788 struct face *face;
4789 int i, len, width;
4790 unsigned *code;
4792 CHECK_FONT_GET_OBJECT (font_object, font);
4793 CHECK_STRING (string);
4794 len = SCHARS (string);
4795 code = alloca (sizeof (unsigned) * len);
4796 for (i = 0; i < len; i++)
4798 Lisp_Object ch = Faref (string, make_number (i));
4799 Lisp_Object val;
4800 int c = XINT (ch);
4802 code[i] = font->driver->encode_char (font, c);
4803 if (code[i] == FONT_INVALID_CODE)
4804 break;
4806 face = FACE_FROM_ID (f, DEFAULT_FACE_ID);
4807 face->fontp = font;
4808 if (font->driver->prepare_face)
4809 font->driver->prepare_face (f, face);
4810 width = font->driver->text_extents (font, code, i, NULL);
4811 len = font->driver->draw_text (f, face, 0, font->ascent, code, i, width);
4812 if (font->driver->done_face)
4813 font->driver->done_face (f, face);
4814 face->fontp = NULL;
4815 return make_number (len);
4817 #endif
4819 #endif /* FONT_DEBUG */
4821 #ifdef HAVE_WINDOW_SYSTEM
4823 DEFUN ("font-info", Ffont_info, Sfont_info, 1, 2, 0,
4824 doc: /* Return information about a font named NAME on frame FRAME.
4825 If FRAME is omitted or nil, use the selected frame.
4826 The returned value is a vector of OPENED-NAME, FULL-NAME, SIZE,
4827 HEIGHT, BASELINE-OFFSET, RELATIVE-COMPOSE, and DEFAULT-ASCENT,
4828 where
4829 OPENED-NAME is the name used for opening the font,
4830 FULL-NAME is the full name of the font,
4831 SIZE is the pixelsize of the font,
4832 HEIGHT is the pixel-height of the font (i.e ascent + descent),
4833 BASELINE-OFFSET is the upward offset pixels from ASCII baseline,
4834 RELATIVE-COMPOSE and DEFAULT-ASCENT are the numbers controlling
4835 how to compose characters.
4836 If the named font is not yet loaded, return nil. */)
4837 (Lisp_Object name, Lisp_Object frame)
4839 FRAME_PTR f;
4840 struct font *font;
4841 Lisp_Object info;
4842 Lisp_Object font_object;
4844 (*check_window_system_func) ();
4846 if (! FONTP (name))
4847 CHECK_STRING (name);
4848 if (NILP (frame))
4849 frame = selected_frame;
4850 CHECK_LIVE_FRAME (frame);
4851 f = XFRAME (frame);
4853 if (STRINGP (name))
4855 int fontset = fs_query_fontset (name, 0);
4857 if (fontset >= 0)
4858 name = fontset_ascii (fontset);
4859 font_object = font_open_by_name (f, SSDATA (name));
4861 else if (FONT_OBJECT_P (name))
4862 font_object = name;
4863 else if (FONT_ENTITY_P (name))
4864 font_object = font_open_entity (f, name, 0);
4865 else
4867 struct face *face = FACE_FROM_ID (f, DEFAULT_FACE_ID);
4868 Lisp_Object entity = font_matching_entity (f, face->lface, name);
4870 font_object = ! NILP (entity) ? font_open_entity (f, entity, 0) : Qnil;
4872 if (NILP (font_object))
4873 return Qnil;
4874 font = XFONT_OBJECT (font_object);
4876 info = Fmake_vector (make_number (7), Qnil);
4877 XVECTOR (info)->contents[0] = AREF (font_object, FONT_NAME_INDEX);
4878 XVECTOR (info)->contents[1] = AREF (font_object, FONT_FULLNAME_INDEX);
4879 XVECTOR (info)->contents[2] = make_number (font->pixel_size);
4880 XVECTOR (info)->contents[3] = make_number (font->height);
4881 XVECTOR (info)->contents[4] = make_number (font->baseline_offset);
4882 XVECTOR (info)->contents[5] = make_number (font->relative_compose);
4883 XVECTOR (info)->contents[6] = make_number (font->default_ascent);
4885 #if 0
4886 /* As font_object is still in FONT_OBJLIST of the entity, we can't
4887 close it now. Perhaps, we should manage font-objects
4888 by `reference-count'. */
4889 font_close_object (f, font_object);
4890 #endif
4891 return info;
4893 #endif
4896 #define BUILD_STYLE_TABLE(TBL) \
4897 build_style_table ((TBL), sizeof TBL / sizeof (struct table_entry))
4899 static Lisp_Object
4900 build_style_table (const struct table_entry *entry, int nelement)
4902 int i, j;
4903 Lisp_Object table, elt;
4905 table = Fmake_vector (make_number (nelement), Qnil);
4906 for (i = 0; i < nelement; i++)
4908 for (j = 0; entry[i].names[j]; j++);
4909 elt = Fmake_vector (make_number (j + 1), Qnil);
4910 ASET (elt, 0, make_number (entry[i].numeric));
4911 for (j = 0; entry[i].names[j]; j++)
4912 ASET (elt, j + 1, intern_c_string (entry[i].names[j]));
4913 ASET (table, i, elt);
4915 return table;
4918 /* The deferred font-log data of the form [ACTION ARG RESULT].
4919 If ACTION is not nil, that is added to the log when font_add_log is
4920 called next time. At that time, ACTION is set back to nil. */
4921 static Lisp_Object Vfont_log_deferred;
4923 /* Prepend the font-related logging data in Vfont_log if it is not
4924 `t'. ACTION describes a kind of font-related action (e.g. listing,
4925 opening), ARG is the argument for the action, and RESULT is the
4926 result of the action. */
4927 void
4928 font_add_log (const char *action, Lisp_Object arg, Lisp_Object result)
4930 Lisp_Object val;
4931 int i;
4933 if (EQ (Vfont_log, Qt))
4934 return;
4935 if (STRINGP (AREF (Vfont_log_deferred, 0)))
4937 char *str = SSDATA (AREF (Vfont_log_deferred, 0));
4939 ASET (Vfont_log_deferred, 0, Qnil);
4940 font_add_log (str, AREF (Vfont_log_deferred, 1),
4941 AREF (Vfont_log_deferred, 2));
4944 if (FONTP (arg))
4946 Lisp_Object tail, elt;
4947 Lisp_Object equalstr = build_string ("=");
4949 val = Ffont_xlfd_name (arg, Qt);
4950 for (tail = AREF (arg, FONT_EXTRA_INDEX); CONSP (tail);
4951 tail = XCDR (tail))
4953 elt = XCAR (tail);
4954 if (EQ (XCAR (elt), QCscript)
4955 && SYMBOLP (XCDR (elt)))
4956 val = concat3 (val, SYMBOL_NAME (QCscript),
4957 concat2 (equalstr, SYMBOL_NAME (XCDR (elt))));
4958 else if (EQ (XCAR (elt), QClang)
4959 && SYMBOLP (XCDR (elt)))
4960 val = concat3 (val, SYMBOL_NAME (QClang),
4961 concat2 (equalstr, SYMBOL_NAME (XCDR (elt))));
4962 else if (EQ (XCAR (elt), QCotf)
4963 && CONSP (XCDR (elt)) && SYMBOLP (XCAR (XCDR (elt))))
4964 val = concat3 (val, SYMBOL_NAME (QCotf),
4965 concat2 (equalstr,
4966 SYMBOL_NAME (XCAR (XCDR (elt)))));
4968 arg = val;
4971 if (CONSP (result)
4972 && VECTORP (XCAR (result))
4973 && ASIZE (XCAR (result)) > 0
4974 && FONTP (AREF (XCAR (result), 0)))
4975 result = font_vconcat_entity_vectors (result);
4976 if (FONTP (result))
4978 val = Ffont_xlfd_name (result, Qt);
4979 if (! FONT_SPEC_P (result))
4980 val = concat3 (SYMBOL_NAME (AREF (result, FONT_TYPE_INDEX)),
4981 build_string (":"), val);
4982 result = val;
4984 else if (CONSP (result))
4986 Lisp_Object tail;
4987 result = Fcopy_sequence (result);
4988 for (tail = result; CONSP (tail); tail = XCDR (tail))
4990 val = XCAR (tail);
4991 if (FONTP (val))
4992 val = Ffont_xlfd_name (val, Qt);
4993 XSETCAR (tail, val);
4996 else if (VECTORP (result))
4998 result = Fcopy_sequence (result);
4999 for (i = 0; i < ASIZE (result); i++)
5001 val = AREF (result, i);
5002 if (FONTP (val))
5003 val = Ffont_xlfd_name (val, Qt);
5004 ASET (result, i, val);
5007 Vfont_log = Fcons (list3 (intern (action), arg, result), Vfont_log);
5010 /* Record a font-related logging data to be added to Vfont_log when
5011 font_add_log is called next time. ACTION, ARG, RESULT are the same
5012 as font_add_log. */
5014 void
5015 font_deferred_log (const char *action, Lisp_Object arg, Lisp_Object result)
5017 if (EQ (Vfont_log, Qt))
5018 return;
5019 ASET (Vfont_log_deferred, 0, build_string (action));
5020 ASET (Vfont_log_deferred, 1, arg);
5021 ASET (Vfont_log_deferred, 2, result);
5024 void
5025 syms_of_font (void)
5027 sort_shift_bits[FONT_TYPE_INDEX] = 0;
5028 sort_shift_bits[FONT_SLANT_INDEX] = 2;
5029 sort_shift_bits[FONT_WEIGHT_INDEX] = 9;
5030 sort_shift_bits[FONT_SIZE_INDEX] = 16;
5031 sort_shift_bits[FONT_WIDTH_INDEX] = 23;
5032 /* Note that the other elements in sort_shift_bits are not used. */
5034 staticpro (&font_charset_alist);
5035 font_charset_alist = Qnil;
5037 DEFSYM (Qopentype, "opentype");
5039 DEFSYM (Qascii_0, "ascii-0");
5040 DEFSYM (Qiso8859_1, "iso8859-1");
5041 DEFSYM (Qiso10646_1, "iso10646-1");
5042 DEFSYM (Qunicode_bmp, "unicode-bmp");
5043 DEFSYM (Qunicode_sip, "unicode-sip");
5045 DEFSYM (QCf, "Cf");
5047 DEFSYM (QCotf, ":otf");
5048 DEFSYM (QClang, ":lang");
5049 DEFSYM (QCscript, ":script");
5050 DEFSYM (QCantialias, ":antialias");
5052 DEFSYM (QCfoundry, ":foundry");
5053 DEFSYM (QCadstyle, ":adstyle");
5054 DEFSYM (QCregistry, ":registry");
5055 DEFSYM (QCspacing, ":spacing");
5056 DEFSYM (QCdpi, ":dpi");
5057 DEFSYM (QCscalable, ":scalable");
5058 DEFSYM (QCavgwidth, ":avgwidth");
5059 DEFSYM (QCfont_entity, ":font-entity");
5060 DEFSYM (QCfc_unknown_spec, ":fc-unknown-spec");
5062 DEFSYM (Qc, "c");
5063 DEFSYM (Qm, "m");
5064 DEFSYM (Qp, "p");
5065 DEFSYM (Qd, "d");
5067 DEFSYM (Qja, "ja");
5068 DEFSYM (Qko, "ko");
5070 DEFSYM (QCuser_spec, "user-spec");
5072 staticpro (&null_vector);
5073 null_vector = Fmake_vector (make_number (0), Qnil);
5075 staticpro (&scratch_font_spec);
5076 scratch_font_spec = Ffont_spec (0, NULL);
5077 staticpro (&scratch_font_prefer);
5078 scratch_font_prefer = Ffont_spec (0, NULL);
5080 staticpro (&Vfont_log_deferred);
5081 Vfont_log_deferred = Fmake_vector (make_number (3), Qnil);
5083 #if 0
5084 #ifdef HAVE_LIBOTF
5085 staticpro (&otf_list);
5086 otf_list = Qnil;
5087 #endif /* HAVE_LIBOTF */
5088 #endif /* 0 */
5090 defsubr (&Sfontp);
5091 defsubr (&Sfont_spec);
5092 defsubr (&Sfont_get);
5093 #ifdef HAVE_WINDOW_SYSTEM
5094 defsubr (&Sfont_face_attributes);
5095 #endif
5096 defsubr (&Sfont_put);
5097 defsubr (&Slist_fonts);
5098 defsubr (&Sfont_family_list);
5099 defsubr (&Sfind_font);
5100 defsubr (&Sfont_xlfd_name);
5101 defsubr (&Sclear_font_cache);
5102 defsubr (&Sfont_shape_gstring);
5103 defsubr (&Sfont_variation_glyphs);
5104 #if 0
5105 defsubr (&Sfont_drive_otf);
5106 defsubr (&Sfont_otf_alternates);
5107 #endif /* 0 */
5109 #ifdef FONT_DEBUG
5110 defsubr (&Sopen_font);
5111 defsubr (&Sclose_font);
5112 defsubr (&Squery_font);
5113 defsubr (&Sfont_get_glyphs);
5114 defsubr (&Sfont_match_p);
5115 defsubr (&Sfont_at);
5116 #if 0
5117 defsubr (&Sdraw_string);
5118 #endif
5119 #endif /* FONT_DEBUG */
5120 #ifdef HAVE_WINDOW_SYSTEM
5121 defsubr (&Sfont_info);
5122 #endif
5124 DEFVAR_LISP ("font-encoding-alist", Vfont_encoding_alist,
5125 doc: /*
5126 Alist of fontname patterns vs the corresponding encoding and repertory info.
5127 Each element looks like (REGEXP . (ENCODING . REPERTORY)),
5128 where ENCODING is a charset or a char-table,
5129 and REPERTORY is a charset, a char-table, or nil.
5131 If ENCODING and REPERTORY are the same, the element can have the form
5132 \(REGEXP . ENCODING).
5134 ENCODING is for converting a character to a glyph code of the font.
5135 If ENCODING is a charset, encoding a character by the charset gives
5136 the corresponding glyph code. If ENCODING is a char-table, looking up
5137 the table by a character gives the corresponding glyph code.
5139 REPERTORY specifies a repertory of characters supported by the font.
5140 If REPERTORY is a charset, all characters belonging to the charset are
5141 supported. If REPERTORY is a char-table, all characters who have a
5142 non-nil value in the table are supported. If REPERTORY is nil, Emacs
5143 gets the repertory information by an opened font and ENCODING. */);
5144 Vfont_encoding_alist = Qnil;
5146 /* FIXME: These 3 vars are not quite what they appear: setq on them
5147 won't have any effect other than disconnect them from the style
5148 table used by the font display code. So we make them read-only,
5149 to avoid this confusing situation. */
5151 DEFVAR_LISP_NOPRO ("font-weight-table", Vfont_weight_table,
5152 doc: /* Vector of valid font weight values.
5153 Each element has the form:
5154 [NUMERIC-VALUE SYMBOLIC-NAME ALIAS-NAME ...]
5155 NUMERIC-VALUE is an integer, and SYMBOLIC-NAME and ALIAS-NAME are symbols. */);
5156 Vfont_weight_table = BUILD_STYLE_TABLE (weight_table);
5157 XSYMBOL (intern_c_string ("font-weight-table"))->constant = 1;
5159 DEFVAR_LISP_NOPRO ("font-slant-table", Vfont_slant_table,
5160 doc: /* Vector of font slant symbols vs the corresponding numeric values.
5161 See `font-weight-table' for the format of the vector. */);
5162 Vfont_slant_table = BUILD_STYLE_TABLE (slant_table);
5163 XSYMBOL (intern_c_string ("font-slant-table"))->constant = 1;
5165 DEFVAR_LISP_NOPRO ("font-width-table", Vfont_width_table,
5166 doc: /* Alist of font width symbols vs the corresponding numeric values.
5167 See `font-weight-table' for the format of the vector. */);
5168 Vfont_width_table = BUILD_STYLE_TABLE (width_table);
5169 XSYMBOL (intern_c_string ("font-width-table"))->constant = 1;
5171 staticpro (&font_style_table);
5172 font_style_table = Fmake_vector (make_number (3), Qnil);
5173 ASET (font_style_table, 0, Vfont_weight_table);
5174 ASET (font_style_table, 1, Vfont_slant_table);
5175 ASET (font_style_table, 2, Vfont_width_table);
5177 DEFVAR_LISP ("font-log", Vfont_log, doc: /*
5178 *Logging list of font related actions and results.
5179 The value t means to suppress the logging.
5180 The initial value is set to nil if the environment variable
5181 EMACS_FONT_LOG is set. Otherwise, it is set to t. */);
5182 Vfont_log = Qnil;
5184 #ifdef HAVE_WINDOW_SYSTEM
5185 #ifdef HAVE_FREETYPE
5186 syms_of_ftfont ();
5187 #ifdef HAVE_X_WINDOWS
5188 syms_of_xfont ();
5189 syms_of_ftxfont ();
5190 #ifdef HAVE_XFT
5191 syms_of_xftfont ();
5192 #endif /* HAVE_XFT */
5193 #endif /* HAVE_X_WINDOWS */
5194 #else /* not HAVE_FREETYPE */
5195 #ifdef HAVE_X_WINDOWS
5196 syms_of_xfont ();
5197 #endif /* HAVE_X_WINDOWS */
5198 #endif /* not HAVE_FREETYPE */
5199 #ifdef HAVE_BDFFONT
5200 syms_of_bdffont ();
5201 #endif /* HAVE_BDFFONT */
5202 #ifdef WINDOWSNT
5203 syms_of_w32font ();
5204 #endif /* WINDOWSNT */
5205 #ifdef HAVE_NS
5206 syms_of_nsfont ();
5207 #endif /* HAVE_NS */
5208 #endif /* HAVE_WINDOW_SYSTEM */
5211 void
5212 init_font (void)
5214 Vfont_log = egetenv ("EMACS_FONT_LOG") ? Qnil : Qt;