|
3094
|
1 ;;; fontconfig.el --- New font model, NG
|
|
|
2
|
|
|
3 ;; Copyright (c) 2003 Eric Knauel and Matthias Neubauer
|
|
|
4 ;; Copyright (C) 2004, 2005 Free Software Foundation, Inc.
|
|
|
5
|
|
|
6 ;; Authors: Eric Knauel <knauel@informatik.uni-tuebingen.de>
|
|
|
7 ;; Matthias Neubauer <neubauer@informatik.uni-freiburg.de>
|
|
|
8 ;; Stephen J. Turnbull <stephen@xemacs.org>
|
|
|
9 ;; Created: 27 Oct 2003
|
|
|
10 ;; Updated: 05 Mar 2005 by Stephen J. Turnbull
|
|
|
11 ;; Keywords: faces
|
|
|
12
|
|
|
13 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
14 ;; under the terms of the GNU General Public License as published by
|
|
|
15 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
16 ;; any later version.
|
|
|
17
|
|
|
18 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
19 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
21 ;; General Public License for more details.
|
|
|
22
|
|
|
23 ;; You should have received a copy of the GNU General Public License
|
|
|
24 ;; along with XEmacs; see the file COPYING. If not, write to the Free
|
|
|
25 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
|
|
|
26 ;; 02111-1307, USA.
|
|
|
27
|
|
|
28 ;;; Synched up with: Not in GNU
|
|
|
29
|
|
|
30 ;;; Commentary:
|
|
|
31
|
|
|
32 ;; This file is one of the pillars of the face refactoring effort
|
|
|
33 ;; (another will be colorconfig.el, and there may be others).
|
|
|
34
|
|
|
35 ;; The overall plan is to have a sensible modern model for values of
|
|
|
36 ;; each of the components of a face (starting with fonts and colors),
|
|
|
37 ;; implemented in a single module. Of course we must be able to
|
|
|
38 ;; convert such values to appropriate descriptors for any device type
|
|
|
39 ;; on the one hand, but on the other it seems unreasonable to force
|
|
|
40 ;; users to deal with a large number of different (and arcane, in the
|
|
|
41 ;; case of XLFD) naming formats.
|
|
|
42
|
|
|
43 ;; This file implements font specification. We call a specification a
|
|
|
44 ;; *pattern* to conform to fontconfig usage. The internal
|
|
|
45 ;; representation of a pattern will have Keith Packard's fontconfig
|
|
|
46 ;; API. For one, there is a robust and free C implementation, which
|
|
|
47 ;; is available as a package for all platforms supported by X.org or
|
|
|
48 ;; XFree86. For another, it seems to be capable of representing any
|
|
|
49 ;; specification of any of the font models I know. Third, on X
|
|
|
50 ;; platforms that internal representation can be passed verbatim to
|
|
|
51 ;; libXft to get high quality TrueType fonts rendered with
|
|
|
52 ;; anti-aliasing and hinting.
|
|
|
53
|
|
|
54 ;; We will support the following user interfaces:
|
|
|
55
|
|
|
56 ;; 1. fontconfig font names
|
|
|
57 ;; 2. X Logical Font Descriptions (XLFD)
|
|
|
58 ;; 3. MS Windows font names
|
|
|
59 ;; 4. Mac OS X font names
|
|
|
60
|
|
|
61 ;; and possibly others (such as ad hoc abbreviations used in older X11
|
|
|
62 ;; implementations). This is called the *fontname UI* (for the
|
|
|
63 ;; platform) to distinguish it from XEmacs's internal model
|
|
|
64 ;; (fontconfig patterns) and the API for rendering engines (called the
|
|
|
65 ;; *font API* for the engine).
|
|
|
66
|
|
|
67 ;; We will support the following rendering engine APIs:
|
|
|
68
|
|
|
69 ;; 1. fontconfig patterns (the native language of Xft); to emphasize
|
|
|
70 ;; the engine-specific nature, we will call these *Xft fonts*
|
|
|
71 ;; 2. XLFD strings
|
|
|
72 ;; 3. MS Windows font names
|
|
|
73
|
|
|
74 ;; and possibly others (such as Mac OS X font names). This is called
|
|
|
75 ;; the *font API* (for the platform) to distinguish it from XEmacs's
|
|
|
76 ;; internal model (fontconfig *patterns*) and the names used by users
|
|
|
77 ;; (called the *fontname UI* for the platform).
|
|
|
78
|
|
|
79
|
|
|
80 ;; TODO (possible enhancements)
|
|
|
81 ;; 1. add a more complete docstring for properties as such (would be a
|
|
|
82 ;; hash table?) to describe things like special symbolic values, and
|
|
|
83 ;; Emacs-relevant semantics
|
|
|
84 ;; 2. add a special value defining macro for constants
|
|
|
85
|
|
|
86 ;;; Code:
|
|
|
87
|
|
|
88 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
|
89 ;;
|
|
|
90 ;; The fontconfig pattern API
|
|
|
91 ;;
|
|
|
92 ;; The basic interfaces are defined as API wrappers in C in xft-font.c
|
|
|
93 ;; #### which should be renamed to fontconfig.c. These are prefixed
|
|
|
94 ;; with "fc-pattern-". These are
|
|
|
95 ;;
|
|
|
96 ;; fc-pattern-p
|
|
|
97 ;; fc-pattern-create
|
|
|
98 ;; fc-pattern-duplicate
|
|
|
99 ;; fc-pattern-add
|
|
|
100 ;; fc-pattern-del
|
|
|
101 ;; fc-pattern-get
|
|
|
102 ;; fc-pattern-destroy
|
|
|
103
|
|
|
104 ;; We provide a LISP-y alias, `make-fc-pattern' for the pattern
|
|
|
105 ;; constructor function `fc-pattern-create'. #### It might make sense
|
|
|
106 ;; to generalize `make-fc-pattern' by allowing a plist of properties
|
|
|
107 ;; as an optional argument. We also provide accessors
|
|
3354
|
108 ;; `fc-pattern-get-PROPERTY' and mutators `fc-pattern-add-PROPERTY' and
|
|
|
109 ;; `fc-pattern-del-PROPERTY' for each of the standard properties used by
|
|
|
110 ;; Xft, which overlap substantially with the properties defined by X11.
|
|
|
111
|
|
|
112 (require 'font-mgr)
|
|
3094
|
113
|
|
|
114 (defalias 'make-fc-pattern 'fc-pattern-create)
|
|
|
115
|
|
|
116 (defmacro fc-define-property (property type docfrag &optional obsolete-p)
|
|
|
117 "Define PROPERTY as a fontconfig font property of type TYPE using DOCFRAG.
|
|
|
118
|
|
|
119 A font property is a key in a fontconfig pattern and is associated with
|
|
|
120 one or more values of a given type. This macro creates wrappers around
|
|
3354
|
121 `fc-pattern-get', `fc-pattern-add', and `fc-pattern-del' for PROPERTY.
|
|
|
122 \(Wrappers are preferred to use of primitives with a string as the OBJECT
|
|
|
123 argument because typos in wrappers result in \"not fboundp\" errors, while
|
|
|
124 a typo in a string produces a silent null return.)
|
|
3094
|
125
|
|
|
126 PROPERTY is a string.
|
|
|
127 TYPE is a symbol indicating the type of the property value. It is used only
|
|
|
128 to modify formatting of the wrapper function docstrings.
|
|
|
129 DOCFRAG is a string which briefly describes the use of the property, and is
|
|
|
130 interpolated into a format to create the doctstrings.
|
|
|
131 OBSOLETE-P if non-nil marks the property as pertaining only to older versions
|
|
|
132 of fontconfig or Xft. This merely adds a deprecation to the docstrings.
|
|
|
133
|
|
|
134 This macro defines an accessor named `fc-pattern-get-PROPERTY' which takes
|
|
|
135 a fontconfig pattern object and an integer as arguments, and returns the
|
|
|
136 value associated with PROPERTY and ID in the pattern object. Since it is
|
|
|
137 not possible to associate a value to PROPERTY for a particular ID, it is
|
|
|
138 not very useful to interpret the values associated with a given id for
|
|
|
139 different properties as being linked to each other in some way.
|
|
|
140
|
|
|
141 A mutator `fc-pattern-add-PROPERTY' which takes a fontconfig pattern object
|
|
|
142 and a value as arguments, and adds the value to the property with the next
|
|
|
143 id. The type of the value is recognized by `fc-pattern-add', and the id
|
|
3354
|
144 is chosen by the fontconfig implementation.
|
|
|
145
|
|
|
146 A mutator `fc-pattern-del-PROPERTY' which takes a fontconfig pattern object,
|
|
|
147 and deletes all values of that property from the pattern."
|
|
3094
|
148
|
|
|
149 `(progn
|
|
|
150 (defsubst ,(intern (concat "fc-pattern-get-" property))
|
|
|
151 (pattern id)
|
|
|
152 ,(format "\
|
|
|
153 Return %s %s fc pattern PATTERN %s.%s
|
|
|
154
|
|
|
155 This function is a convenience wrapper for `fc-pattern-get'.
|
|
|
156 See `fc-pattern-get' for documentation of patterns, ids, and error returns."
|
|
|
157 (if (eq type 'boolean)
|
|
|
158 "t"
|
|
|
159 docfrag)
|
|
|
160 (if (eq type 'boolean)
|
|
|
161 "if"
|
|
|
162 "associated with id ID in")
|
|
|
163 (if (eq type 'boolean)
|
|
|
164 docfrag
|
|
|
165 (format "as a%s %s" (if (eq type 'integer) "n" "") type))
|
|
|
166 (if obsolete-p "
|
|
|
167 \(Obsolete, only available on systems using Xft version 1.)"
|
|
|
168 ""))
|
|
|
169 (fc-pattern-get pattern ,property id))
|
|
|
170
|
|
|
171 (defsubst ,(intern (concat "fc-pattern-add-" property))
|
|
|
172 (pattern value)
|
|
|
173 ,(format "\
|
|
|
174 Add VALUE to the %s property of fontconfig pattern PATTERN.%s
|
|
|
175
|
|
|
176 The type of VALUE should be %s.
|
|
|
177
|
|
|
178 This function is a convenience wrapper for `fc-pattern-add'.
|
|
|
179 See `fc-pattern-add' for documentation of patterns, values, and error returns."
|
|
|
180 property
|
|
|
181 (if obsolete-p "
|
|
|
182 \(Obsolete, only available on systems using Xft version 1.)"
|
|
|
183 "")
|
|
|
184 type)
|
|
|
185 (fc-pattern-add pattern ,property value))
|
|
3354
|
186
|
|
|
187 (defsubst ,(intern (concat "fc-pattern-del-" property))
|
|
|
188 (pattern)
|
|
|
189 ,(format "\
|
|
|
190 Delete all values of the %s property of fontconfig pattern PATTERN.%s
|
|
|
191
|
|
|
192 This function is a convenience wrapper for `fc-pattern-del'.
|
|
|
193 See `fc-pattern-del' for documentation of patterns and error returns."
|
|
|
194 property
|
|
|
195 (if obsolete-p "
|
|
|
196 \(Obsolete, only available on systems using Xft version 1.)"
|
|
|
197 "")
|
|
|
198 type)
|
|
|
199 (fc-pattern-del pattern ,property))
|
|
3094
|
200 ,property))
|
|
|
201
|
|
|
202 ;; define the standard properties for Xft v.2 here
|
|
|
203 (fc-define-property "antialias" boolean "the font supports antialiasing")
|
|
|
204 (fc-define-property "dpi" float "the design resolution")
|
|
|
205 (fc-define-property "family" string "the font family")
|
|
|
206 (fc-define-property "file" string "the file containing glyph data")
|
|
|
207 (fc-define-property "foundry" string "the vendor")
|
|
|
208 (fc-define-property "index" integer "the index of the glyph set")
|
|
|
209 (fc-define-property "minspace" boolean "has a minimum spacing")
|
|
|
210 (fc-define-property "outline" boolean "is an outline font")
|
|
|
211 (fc-define-property "pixelsize" float "the size in pixels")
|
|
|
212 (fc-define-property "rasterizer" string "the name of the rasterizing engine")
|
|
|
213 (fc-define-property "rgba" integer "the subpixel rendering capabilities")
|
|
|
214 (fc-define-property "scalable" boolean "is scalable")
|
|
|
215 (fc-define-property "scale" float "the scale factor")
|
|
|
216 (fc-define-property "size" float "the size in points")
|
|
|
217 (fc-define-property "slant" integer "the slant")
|
|
|
218 (fc-define-property "spacing" integer "the spacing model")
|
|
|
219 (fc-define-property "style" string "the typographic face or style")
|
|
|
220 (fc-define-property "weight" integer "the weight")
|
|
|
221 (fc-define-property "xlfd" string "the XLFD (full name in X11)")
|
|
|
222
|
|
3354
|
223 ;; Xft v.1 properties (generally marked as obsolete)
|
|
|
224 ;; had different semantics from XLFD "encoding"
|
|
3094
|
225 (fc-define-property "encoding" string "the encoding" t)
|
|
3354
|
226 ;; also used by X11 XLFDs, so not obsolete
|
|
|
227 (fc-define-property "charwidth" integer "the average character width")
|
|
3094
|
228 (fc-define-property "charheight" integer "the average character height" t)
|
|
|
229 (fc-define-property "core" boolean "represents a core font" t)
|
|
|
230 (fc-define-property "render" boolean "represents a render (Xft) font" t)
|
|
|
231
|
|
3354
|
232 ;; X11 XLFD and other standard properties
|
|
|
233 (fc-define-property "x11-swidth" string "the 'set' width")
|
|
|
234 (fc-define-property "x11-adstyle" string "any additional style")
|
|
|
235 (fc-define-property "x11-resx" string "the horizontal design resolution")
|
|
|
236 (fc-define-property "x11-resy" string "the vertical design resolution")
|
|
|
237 ;; use "charwidth" instead of "x11-avgwidth"
|
|
|
238 (fc-define-property "x11-registry" string "the encoding registry")
|
|
|
239 ;; "x11-encoding" has different semantics from Xft v.1 "encoding"
|
|
|
240 (fc-define-property "x11-encoding" string "the encoding index")
|
|
3094
|
241
|
|
|
242
|
|
|
243 (defvar fc-find-available-font-families-fc-fonts-only t
|
|
|
244 "If `fc-find-available-font-families-fc-fonts-only' is set to `t',
|
|
|
245 `fc-find-available-font-families' will ignore core fonts.")
|
|
|
246
|
|
|
247 (defconst fc-font-name-slant-roman 0)
|
|
|
248 (defconst fc-font-name-slant-italic 100)
|
|
|
249 (defconst fc-font-name-slant-oblique 110)
|
|
|
250
|
|
|
251 (defconst fc-font-name-slant-mapping
|
|
|
252 `((,fc-font-name-slant-roman . :roman)
|
|
|
253 (,fc-font-name-slant-italic . :italic)
|
|
|
254 (,fc-font-name-slant-oblique . :oblique)))
|
|
|
255
|
|
|
256 (defconst fc-font-name-slant-mapping-string
|
|
|
257 `((,fc-font-name-slant-roman . "R")
|
|
|
258 (,fc-font-name-slant-roman . "I")
|
|
|
259 (,fc-font-name-slant-roman . "O")))
|
|
|
260
|
|
|
261 (defconst fc-font-name-slant-mapping-string-reverse
|
|
|
262 `(("R" . ,fc-font-name-slant-roman)
|
|
|
263 ("I" . ,fc-font-name-slant-italic)
|
|
|
264 ("O" . ,fc-font-name-slant-oblique)))
|
|
|
265
|
|
|
266 (defconst fc-font-name-slant-mapping-reverse
|
|
|
267 `((:roman . ,fc-font-name-slant-roman)
|
|
|
268 (:italic . ,fc-font-name-slant-italic)
|
|
|
269 (:oblique . ,fc-font-name-slant-oblique)))
|
|
|
270
|
|
|
271 (defun fc-font-slant-translate-from-constant (number)
|
|
|
272 "Translate the Xft font slant constant NUMBER to symbol."
|
|
|
273 (let ((pair (assoc number fc-font-name-slant-mapping)))
|
|
|
274 (if pair (cdr pair))))
|
|
|
275
|
|
|
276 (defun fc-font-slant-translate-from-symbol (symbol)
|
|
|
277 "Translate SYMBOL (`:roman', `:italic' or `:oblique') to the
|
|
|
278 corresponding Xft font slant constant."
|
|
|
279 (let ((pair (assoc symbol fc-font-name-slant-mapping-reverse)))
|
|
|
280 (if pair (cdr pair))))
|
|
|
281
|
|
|
282 (defun fc-font-slant-translate-to-string (num-or-sym)
|
|
|
283 (let* ((constant (if (symbolp num-or-sym)
|
|
|
284 (cdr (assoc num-or-sym fc-font-name-slant-mapping-reverse))
|
|
|
285 num-or-sym))
|
|
|
286 (pair (assoc constant fc-font-name-slant-mapping-string)))
|
|
|
287 (if pair (cdr pair))))
|
|
|
288
|
|
|
289 (defun fc-font-slant-translate-from-string (str)
|
|
|
290 (let ((pair (assoc str fc-font-name-slant-mapping-string-reverse)))
|
|
|
291 (if pair (cdr pair))))
|
|
|
292
|
|
|
293 (defconst fc-font-name-weight-light 0)
|
|
|
294 (defconst fc-font-name-weight-regular 80)
|
|
|
295 (defconst fc-font-name-weight-medium 100)
|
|
|
296 (defconst fc-font-name-weight-demibold 180)
|
|
|
297 (defconst fc-font-name-weight-bold 200)
|
|
|
298 (defconst fc-font-name-weight-black 210)
|
|
|
299
|
|
|
300 (defconst fc-font-name-weight-mapping
|
|
|
301 `((,fc-font-name-weight-light . :light)
|
|
|
302 (,fc-font-name-weight-regular . :regular)
|
|
|
303 (,fc-font-name-weight-medium . :medium)
|
|
|
304 (,fc-font-name-weight-demibold . :demibold)
|
|
|
305 (,fc-font-name-weight-bold . :bold)
|
|
|
306 (,fc-font-name-weight-black . :black)))
|
|
|
307
|
|
|
308 (defconst fc-font-name-weight-mapping-string
|
|
|
309 `((,fc-font-name-weight-light . "Light")
|
|
|
310 (,fc-font-name-weight-regular . "Regular")
|
|
|
311 (,fc-font-name-weight-medium . "Medium")
|
|
|
312 (,fc-font-name-weight-demibold . "Demibold")
|
|
|
313 (,fc-font-name-weight-bold . "Bold")
|
|
|
314 (,fc-font-name-weight-black . "Black")))
|
|
|
315
|
|
|
316 (defconst fc-font-name-weight-mapping-string-reverse
|
|
|
317 `(("Light" . ,fc-font-name-weight-light)
|
|
|
318 ("Regular" . ,fc-font-name-weight-regular)
|
|
|
319 ("Medium" . ,fc-font-name-weight-medium)
|
|
|
320 ("Demibold" . ,fc-font-name-weight-demibold)
|
|
|
321 ("Bold" . ,fc-font-name-weight-bold)
|
|
|
322 ("Black" . ,fc-font-name-weight-black)))
|
|
|
323
|
|
|
324 (defconst fc-font-name-weight-mapping-reverse
|
|
|
325 `((:light . ,fc-font-name-weight-light)
|
|
|
326 (:regular . ,fc-font-name-weight-regular)
|
|
|
327 (:medium . ,fc-font-name-weight-medium)
|
|
|
328 (:demibold . ,fc-font-name-weight-demibold)
|
|
|
329 (:bold . ,fc-font-name-weight-bold)
|
|
|
330 (:black . ,fc-font-name-weight-black)))
|
|
|
331
|
|
|
332 (defun fc-font-weight-translate-from-constant (number)
|
|
|
333 "Translate a Xft font weight constant NUMBER to symbol."
|
|
|
334 (let ((pair (assoc number fc-font-name-weight-mapping)))
|
|
|
335 (if pair (cdr pair))))
|
|
|
336
|
|
|
337 (defun fc-font-weight-translate-from-symbol (symbol)
|
|
|
338 "Translate SYMBOL (`:light', `:regular', `:medium', `:demibold',
|
|
|
339 `:bold' or `:black') to the corresponding Xft font weight constant."
|
|
|
340 (let ((pair (assoc symbol fc-font-name-weight-mapping-reverse)))
|
|
|
341 (if pair (cdr pair))))
|
|
|
342
|
|
|
343 (defun fc-font-weight-translate-to-string (num-or-sym)
|
|
|
344 (let* ((constant (if (symbolp num-or-sym)
|
|
|
345 (cdr (assoc num-or-sym fc-font-name-weight-mapping-reverse))
|
|
|
346 num-or-sym))
|
|
|
347 (pair (assoc constant fc-font-name-weight-mapping-string)))
|
|
|
348 (if pair (cdr pair))))
|
|
|
349
|
|
|
350 (defun fc-font-weight-translate-from-string (str)
|
|
|
351 (let ((pair (assoc str fc-font-name-weight-mapping-string-reverse)))
|
|
|
352 (if pair (cdr pair))))
|
|
|
353
|
|
|
354 (defun fc-copy-pattern-partial (pattern attribute-list)
|
|
|
355 "Return a copy of PATTERN restricted to ATTRIBUTE-LIST.
|
|
|
356
|
|
|
357 PATTERN is a fontconfig pattern object.
|
|
|
358 ATTRIBUTE-LIST is a list of strings denoting font properties.
|
|
|
359 A new object is allocated and returned."
|
|
|
360 (let ((new (make-fc-pattern))
|
|
|
361 (attrs attribute-list))
|
|
|
362 ;;; We demand proper tail recursion!
|
|
|
363 (while (not (null attrs))
|
|
|
364 (let ((get (intern (concat "fc-pattern-get-" (car attrs))))
|
|
|
365 (set (intern (concat "fc-pattern-add-" (car attrs)))))
|
|
|
366 (if (and (fboundp get) (fboundp set))
|
|
|
367 (funcall set new (funcall get pattern 0))
|
|
|
368 (warn "property '%s' not defined, ignoring" (car attrs))))
|
|
|
369 (setq attrs (cdr attrs)))
|
|
|
370 new))
|
|
|
371
|
|
|
372 (defun fc-pattern-get-all-attributes (fc-pattern fc-pattern-get-function)
|
|
|
373 (let ((count 0)
|
|
|
374 res end val)
|
|
|
375 (while (not end)
|
|
|
376 (setq val (funcall fc-pattern-get-function fc-pattern count))
|
|
|
377 (if (or (equal val 'fc-result-no-id)
|
|
|
378 (equal val 'fc-result-no-match))
|
|
|
379 (setq end t)
|
|
|
380 (setq res (append res (list val))
|
|
|
381 count (+ count 1))))
|
|
|
382 res))
|
|
|
383
|
|
|
384 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
|
385 ;;
|
|
|
386 ;; The fontconfig fontname UI
|
|
|
387 ;;
|
|
|
388 ;; The basic interfaces are defined as API wrappers in C in xft-font.c
|
|
|
389 ;; #### which should be renamed to fontconfig.c. These are prefixed
|
|
|
390 ;; with "fc-name-". These are
|
|
|
391 ;;
|
|
|
392 ;; fc-name-parse
|
|
|
393 ;; fc-name-unparse
|
|
3354
|
394 ;; xft-name-unparse (nonfunctional and presumably obsolete)
|
|
|
395 ;;
|
|
|
396 ;; For interfacing with various font rendering systems, we need to be able
|
|
|
397 ;; to convert the fontconfig patterns to names, and vice versa. The high-
|
|
|
398 ;; level API is
|
|
|
399 ;;
|
|
|
400 ;; font-default-name-syntax
|
|
|
401 ;; variable naming the default naming syntax
|
|
|
402 ;; maybe this could be a list to try in order?
|
|
|
403 ;;
|
|
|
404 ;; font-name-to-pattern NAME &optional SYNTAX
|
|
|
405 ;; returns a fontconfig pattern, or nil if the name could not be parsed
|
|
|
406 ;; NAME is a string
|
|
|
407 ;; SYNTAX is a name syntax symbol
|
|
|
408 ;;
|
|
|
409 ;; font-pattern-to-name PATTERN &optional SYNTAX
|
|
|
410 ;; returns a string
|
|
|
411 ;; PATTERN is a fontconfig pattern
|
|
|
412 ;; SYNTAX is a name syntax symbol
|
|
|
413 ;;
|
|
|
414 ;; A "name syntax symbol" is a symbol for a font naming syntax. This may be
|
|
|
415 ;; a rendering engine syntax or a font manager syntax. Initially, 'x and
|
|
|
416 ;; 'fontconfig will be supported. Patterns may be unambiguous (one value for
|
|
|
417 ;; each specified property) or ambiguous (multiple values are allowed for
|
|
|
418 ;; some specified properties). `font-name-to-pattern' should be unambiguous,
|
|
|
419 ;; but `font-pattern-to-name' may not be an exact conversion for some
|
|
|
420 ;; syntaxes, especially for ambiguous patterns.
|
|
3094
|
421
|
|
|
422 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
|
423 ;;
|
|
|
424 ;; The fontconfig font API
|
|
|
425 ;;
|
|
|
426 ;; The basic interfaces are defined as API wrappers in C in xft-font.c
|
|
|
427 ;; #### which should be renamed to fontconfig.c. These are prefixed
|
|
|
428 ;; with "fc-font-". These are
|
|
|
429 ;;
|
|
|
430 ;; fc-font-match
|
|
|
431 ;; fc-list-fonts-pattern-objects
|
|
|
432 ;; fc-font-sort
|
|
|
433 ;; fc-font-real-pattern
|
|
3354
|
434 ;;
|
|
|
435 ;; The high-level API is
|
|
|
436 ;;
|
|
|
437 ;; font-list &optional PATTERN DEVICE ATTRIBUTE-LIST OPTION-LIST
|
|
|
438 ;; returns a list of patterns matching pattern
|
|
|
439 ;; PATTERN is an ambiguous pattern, defaulting to the empty pattern
|
|
|
440 ;; DEVICE is the display device to query (default: selected device)
|
|
|
441 ;; ATTRIBUTE-LIST is a list of font attributes to restrict the patterns
|
|
|
442 ;; in the returned list to; other attributes will not be present in
|
|
|
443 ;; the patterns, and duplicates will be removed after pruning unwanted
|
|
|
444 ;; attributes; ATTRIBUTE-LIST has no necessary relation to the active
|
|
|
445 ;; attributes in PATTERN, both subset and superset make sense; if nil,
|
|
|
446 ;; the active attributes in PATTERN is used
|
|
|
447 ;; OPTION-LIST is a list of presentation options, such as sort order
|
|
|
448 ;; and refresh-cache (if any).
|
|
|
449 ;;
|
|
|
450 ;; font-match PATTERN &optional DEVICE
|
|
|
451 ;; returns a pattern representing the platform match for PATTERN,
|
|
|
452 ;; which should unambiguously select the same font
|
|
|
453 ;; PATTERN is an ambiguous pattern
|
|
|
454 ;; DEVICE is the display device to query (default: selected device)
|
|
|
455 ;;
|
|
|
456 ;; Maybe these APIs should get an error-behavior argument?
|
|
3094
|
457
|
|
|
458 ;; #### it might make sense to generalize `fc-try-font' by having a
|
|
|
459 ;; global variable that contains a list of font name parsers. They are
|
|
|
460 ;; tried in order, and the first one to return an fc-pattern is matched.
|
|
|
461
|
|
|
462 (defun fc-try-font (font &optional device)
|
|
|
463 "Return list of pattern objects matching FONT on DEVICE.
|
|
|
464
|
|
|
465 FONT may be a fontconfig pattern object or a fontconfig font name (a string).
|
|
|
466 Optional DEVICE is the device object to query, defaulting to the currently
|
|
|
467 selected device."
|
|
|
468 (fc-list-fonts-pattern-objects (or device (default-x-device))
|
|
|
469 (if (fc-pattern-p font)
|
|
|
470 font
|
|
|
471 (fc-name-parse font))
|
|
|
472 nil))
|
|
|
473
|
|
3354
|
474 ;; for example, we'd like these next two to be implementable as
|
|
|
475 ;; (font-list (fc-create-pattern) device '("family" "style")) and
|
|
|
476 ;; (font-list (let ((p (fc-create-pattern))) (fc-pattern-add "family" family))
|
|
|
477 ;; device
|
|
|
478 ;; '("weight"))
|
|
|
479
|
|
3094
|
480 (defun fc-find-available-font-families (&optional device filter-fun)
|
|
|
481 "Find all available font families."
|
|
|
482 (let ((device (or device (default-x-device)))
|
|
|
483 (pattern (make-fc-pattern))
|
|
|
484 (objectset '("family" "style")))
|
|
|
485 (let* ((all-fonts
|
|
|
486 (fc-list-fonts-pattern-objects device pattern objectset)))
|
|
|
487 (fc-delete-duplicates
|
|
|
488 (mapcar
|
|
|
489 '(lambda (pattern)
|
|
|
490 (fc-pattern-get-family pattern 0))
|
|
|
491 (if filter-fun
|
|
|
492 (fc-filter all-fonts filter-fun)
|
|
|
493 all-fonts))))))
|
|
|
494
|
|
|
495 (defun fc-find-available-weights-for-family (family &optional style device)
|
|
|
496 "Find available weights for font FAMILY."
|
|
|
497 (let* ((device (or device (default-x-device)))
|
|
|
498 (pattern (make-fc-pattern))
|
|
|
499 (objectset '("weight")))
|
|
3354
|
500 (fc-pattern-add-family pattern family)
|
|
3094
|
501 (if style
|
|
3354
|
502 (fc-pattern-add-style pattern style))
|
|
3094
|
503 (mapcar
|
|
|
504 '(lambda (pattern)
|
|
|
505 (let ((fc-weight-constant (fc-pattern-get-weight pattern 0)))
|
|
|
506 (if fc-weight-constant
|
|
|
507 (fc-font-weight-translate-from-constant fc-weight-constant))))
|
|
|
508 (fc-list-fonts-pattern-objects device pattern objectset))))
|
|
|
509
|
|
|
510 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
|
511 ;;
|
|
|
512 ;; The XLFD fontname UI
|
|
|
513 ;;
|
|
|
514
|
|
|
515 ;; xlfd-font-name-p
|
|
|
516
|
|
|
517 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
|
518 ;;
|
|
|
519 ;; Utility functions
|
|
|
520 ;;
|
|
|
521
|
|
|
522 (defun fc-pattern-get-successp (result)
|
|
|
523 (and (not (equal result 'fc-result-no-match))
|
|
|
524 (not (equal result 'fc-result-no-id))
|
|
|
525 (not (equal result 'fc-internal-error))))
|
|
|
526
|
|
|
527 ;;; DELETE-DUPLICATES and REMOVE-DUPLICATES from cl-seq.el do not
|
|
|
528 ;;; seem to work on list of strings...
|
|
|
529 ;;; #### Presumably just use :test 'equal!
|
|
|
530 (defun fc-delete-duplicates (l)
|
|
|
531 (let ((res nil)
|
|
|
532 (in l))
|
|
|
533 (while (not (null in))
|
|
|
534 (if (not (member (car in) res))
|
|
|
535 (setq res (append res (list (car in)))))
|
|
|
536 (setq in (cdr in)))
|
|
|
537 res))
|
|
|
538
|
|
|
539 ;; #### Use delete-if with :test 'equal.
|
|
|
540 (defun fc-filter (l fun)
|
|
|
541 (let ((res nil)
|
|
|
542 (in l))
|
|
|
543 (while (not (null in))
|
|
|
544 (if (funcall fun (car in))
|
|
|
545 (setq res (append res (list (car in)))))
|
|
|
546 (setq in (cdr in)))
|
|
|
547 res))
|
|
|
548
|
|
|
549 (provide 'fontconfig)
|
|
|
550
|
|
|
551 ;;; fontconfig.el ends here
|
