|
428
|
1 ;;; faces.el --- Lisp interface to the C "face" structure
|
|
|
2
|
|
|
3 ;; Copyright (C) 1992-4, 1997 Free Software Foundation, Inc.
|
|
|
4 ;; Copyright (C) 1995 Board of Trustees, University of Illinois
|
|
3027
|
5 ;; Copyright (C) 1995, 1996, 2002, 2005 Ben Wing
|
|
428
|
6
|
|
|
7 ;; Author: Ben Wing <ben@xemacs.org>
|
|
|
8 ;; Keywords: faces, internal, dumped
|
|
|
9
|
|
|
10 ;; This file is part of XEmacs.
|
|
|
11
|
|
|
12 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
13 ;; under the terms of the GNU General Public License as published by
|
|
|
14 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
15 ;; any later version.
|
|
|
16
|
|
|
17 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
20 ;; General Public License for more details.
|
|
|
21
|
|
|
22 ;; You should have received a copy of the GNU General Public License
|
|
|
23 ;; along with XEmacs; see the file COPYING. If not, write to the
|
|
|
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
25 ;; Boston, MA 02111-1307, USA.
|
|
|
26
|
|
|
27 ;;; Synched up with: Not synched with FSF. Almost completely divergent.
|
|
|
28
|
|
|
29 ;;; Commentary:
|
|
|
30
|
|
|
31 ;; This file is dumped with XEmacs.
|
|
|
32
|
|
|
33 ;; face implementation #1 (used Lisp vectors and parallel C vectors;
|
|
|
34 ;; FSFmacs still uses this) authored by Jamie Zawinski <jwz@jwz.org>
|
|
|
35 ;; pre Lucid-Emacs 19.0.
|
|
|
36
|
|
|
37 ;; face implementation #2 (used one face object per frame per face)
|
|
|
38 ;; authored by Jamie Zawinski for 19.9.
|
|
|
39
|
|
|
40 ;; face implementation #3 (use one face object per face) originally
|
|
|
41 ;; authored for 19.12 by Chuck Thompson <cthomp@cs.uiuc.edu>,
|
|
|
42 ;; rewritten by Ben Wing with the advent of specifiers.
|
|
|
43
|
|
|
44
|
|
|
45 ;;; Some stuff in FSF's faces.el is in our x-faces.el.
|
|
|
46
|
|
|
47 ;;; Code:
|
|
|
48
|
|
771
|
49 ;; To elude the warnings for font functions. (Normally autoloaded when
|
|
|
50 ;; font-create-object is called)
|
|
|
51 (eval-when-compile
|
|
3094
|
52 (require 'font)
|
|
|
53 (load "cl-macs"))
|
|
771
|
54
|
|
428
|
55 (defgroup faces nil
|
|
|
56 "Support for multiple text attributes (fonts, colors, ...)
|
|
|
57 Such a collection of attributes is called a \"face\"."
|
|
|
58 :group 'emacs)
|
|
|
59
|
|
|
60
|
|
|
61 (defun read-face-name (prompt)
|
|
|
62 (let (face)
|
|
|
63 (while (= (length face) 0) ; nil or ""
|
|
|
64 (setq face (completing-read prompt
|
|
|
65 (mapcar (lambda (x) (list (symbol-name x)))
|
|
|
66 (face-list))
|
|
|
67 nil t)))
|
|
|
68 (intern face)))
|
|
|
69
|
|
|
70 (defun face-interactive (what &optional bool)
|
|
|
71 (let* ((fn (intern (concat "face-" what "-instance")))
|
|
|
72 (face (read-face-name (format "Set %s of face: " what)))
|
|
|
73 (default (if (fboundp fn)
|
|
|
74 ;; #### we should distinguish here between
|
|
|
75 ;; explicitly setting the value to be the
|
|
|
76 ;; same as the default face's value, and
|
|
|
77 ;; not setting a value at all.
|
|
|
78 (funcall fn face)))
|
|
|
79 (value (if bool
|
|
|
80 (y-or-n-p (format "Should face %s be %s? "
|
|
|
81 (symbol-name face) bool))
|
|
|
82 (read-string (format "Set %s of face %s to: "
|
|
|
83 what (symbol-name face))
|
|
|
84 (cond ((font-instance-p default)
|
|
|
85 (font-instance-name default))
|
|
|
86 ((color-instance-p default)
|
|
|
87 (color-instance-name default))
|
|
|
88 ((image-instance-p default)
|
|
|
89 (image-instance-file-name default))
|
|
|
90 (t default))))))
|
|
|
91 (list face (if (equal value "") nil value))))
|
|
|
92
|
|
|
93 (defconst built-in-face-specifiers
|
|
|
94 (built-in-face-specifiers)
|
|
|
95 "A list of the built-in face properties that are specifiers.")
|
|
|
96
|
|
|
97 (defun face-property (face property &optional locale tag-set exact-p)
|
|
|
98 "Return FACE's value of the given PROPERTY.
|
|
|
99
|
|
3027
|
100 NOTE: If you are looking for the \"value\" of a built-in face property
|
|
|
101 (`foreground', `background', `font', `background-pixmap', etc.), you
|
|
|
102 are probably better off calling `face-property-instance'. The return
|
|
|
103 value of `face-property' for built-in properties describes the original
|
|
|
104 specification used to determine the face property, which may be nil,
|
|
|
105 a list of instantiators, or something else that is unexpected. For
|
|
|
106 example, if you ask for a face property in a particular buffer (by
|
|
|
107 specifying a buffer for LOCALE), you will get a non-nil return value
|
|
|
108 only if a buffer-local specification for that particular buffer had
|
|
|
109 previously been given.
|
|
|
110
|
|
|
111 For a full list of built-in property names and their semantics, see
|
|
|
112 `set-face-property'.
|
|
428
|
113
|
|
3027
|
114 If LOCALE is omitted, the FACE's actual value for PROPERTY will be
|
|
|
115 returned. In this case, this function appears to behave rather
|
|
|
116 differently depending on whether PROPERTY is a built-in face property of
|
|
|
117 a user-defined face property. This is because the most basic value of a
|
|
|
118 user-defined property is simply whatever was set using
|
|
|
119 `set-face-property', but for a built-in property it's always a specifier,
|
|
|
120 which is an abstract object encapsulating all the specifications for that
|
|
|
121 particular property.
|
|
|
122
|
|
|
123 LOCALE, if supplied, will generally be a buffer, frame or
|
|
|
124 `global' (for the global value), but there are other possibilities -- see
|
|
|
125 the following paragraph. This mostly applies to built-in properties. In
|
|
|
126 this case, the return value will not be a specifier object but the
|
|
|
127 specification(s) for the given locale or locale type will be returned
|
|
|
128 (equivalent to calling `specifier-specs' on the specifier).
|
|
|
129 (Technically, the same thing happens if the basic value of a user-
|
|
|
130 defined property is a specifier, although this usage is rare.)
|
|
428
|
131
|
|
|
132 The return value will be a list of instantiators (e.g. strings
|
|
|
133 specifying a font or color name), or a list of specifications, each
|
|
|
134 of which is a cons of a locale and a list of instantiators.
|
|
|
135 Specifically, if LOCALE is a particular locale (a buffer, window,
|
|
3027
|
136 frame, device, or `global'), a list of instantiators for that locale
|
|
428
|
137 will be returned. Otherwise, if LOCALE is a locale type (one of
|
|
3027
|
138 the symbols `buffer', `window', `frame', or `device'), the specifications
|
|
428
|
139 for all locales of that type will be returned. Finally, if LOCALE is
|
|
3027
|
140 `all', the specifications for all locales of all types will be returned.
|
|
428
|
141
|
|
|
142 The specifications in a specifier determine what the value of
|
|
|
143 PROPERTY will be in a particular \"domain\" or set of circumstances,
|
|
3027
|
144 which is typically a particular Emacs window -- which in turn defines
|
|
|
145 a buffer (the buffer in the window), a frame (the frame that the window
|
|
|
146 is in), and a device (the device that the frame is in). The value is
|
|
442
|
147 derived from the instantiator associated with the most specific
|
|
3027
|
148 locale (in the order buffer, window, frame, device, and `global')
|
|
428
|
149 that matches the domain in question. In other words, given a domain
|
|
442
|
150 (i.e. an Emacs window, usually), the specifier for PROPERTY will
|
|
|
151 first be searched for a specification whose locale is the buffer
|
|
|
152 contained within that window; then for a specification whose locale
|
|
|
153 is the window itself; then for a specification whose locale is the
|
|
|
154 frame that the window is contained within; etc. The first
|
|
|
155 instantiator that is valid for the domain (usually this means that
|
|
|
156 the instantiator is recognized by the device [i.e. MS Windows, the X
|
|
3027
|
157 server or TTY device]) will be \"instantiated\", which generates
|
|
|
158 a Lisp object encapsulating the original instantiator and the underlying
|
|
|
159 window-system object describing the property. The function
|
|
|
160 `face-property-instance' actually does all this."
|
|
428
|
161
|
|
|
162 (setq face (get-face face))
|
|
|
163 (let ((value (get face property)))
|
|
|
164 (if (and locale
|
|
|
165 (or (memq property built-in-face-specifiers)
|
|
|
166 (specifierp value)))
|
|
|
167 (setq value (specifier-specs value locale tag-set exact-p)))
|
|
|
168 value))
|
|
|
169
|
|
|
170 (defun convert-face-property-into-specifier (face property)
|
|
|
171 "Convert PROPERTY on FACE into a specifier, if it's not already."
|
|
|
172 (setq face (get-face face))
|
|
|
173 (let ((specifier (get face property)))
|
|
|
174 ;; if a user-property does not have a specifier but a
|
|
|
175 ;; locale was specified, put a specifier there.
|
|
|
176 ;; If there was already a value there, convert it to a
|
|
3027
|
177 ;; specifier with the value as its `global' instantiator.
|
|
428
|
178 (unless (specifierp specifier)
|
|
|
179 (let ((new-specifier (make-specifier 'generic)))
|
|
|
180 (if (or (not (null specifier))
|
|
|
181 ;; make sure the nil returned from `get' wasn't
|
|
|
182 ;; actually the value of the property
|
|
|
183 (null (get face property t)))
|
|
|
184 (add-spec-to-specifier new-specifier specifier))
|
|
|
185 (setq specifier new-specifier)
|
|
|
186 (put face property specifier)))))
|
|
|
187
|
|
|
188 (defun face-property-instance (face property
|
|
872
|
189 &optional domain default no-fallback)
|
|
428
|
190 "Return the instance of FACE's PROPERTY in the specified DOMAIN.
|
|
|
191
|
|
|
192 Under most circumstances, DOMAIN will be a particular window,
|
|
|
193 and the returned instance describes how the specified property
|
|
|
194 actually is displayed for that window and the particular buffer
|
|
|
195 in it. Note that this may not be the same as how the property
|
|
|
196 appears when the buffer is displayed in a different window or
|
|
|
197 frame, or how the property appears in the same window if you
|
|
|
198 switch to another buffer in that window; and in those cases,
|
|
|
199 the returned instance would be different.
|
|
|
200
|
|
|
201 The returned instance will typically be a color-instance,
|
|
3027
|
202 font-instance, or image-instance object, and you can query
|
|
428
|
203 it using the appropriate object-specific functions. For example,
|
|
|
204 you could use `color-instance-rgb-components' to find out the
|
|
3027
|
205 RGB (red, green, and blue) components of how the `background'
|
|
|
206 property of the `highlight' face is displayed in a particular
|
|
428
|
207 window. The results might be different from the results
|
|
|
208 you would get for another window (perhaps the user
|
|
|
209 specified a different color for the frame that window is on;
|
|
|
210 or perhaps the same color was specified but the window is
|
|
|
211 on a different X server, and that X server has different RGB
|
|
|
212 values for the color from this one).
|
|
|
213
|
|
|
214 DOMAIN defaults to the selected window if omitted.
|
|
|
215
|
|
|
216 DOMAIN can be a frame or device, instead of a window. The value
|
|
|
217 returned for a such a domain is used in special circumstances
|
|
|
218 when a more specific domain does not apply; for example, a frame
|
|
|
219 value might be used for coloring a toolbar, which is conceptually
|
|
|
220 attached to a frame rather than a particular window. The value
|
|
|
221 is also useful in determining what the value would be for a
|
|
|
222 particular window within the frame or device, if it is not
|
|
|
223 overridden by a more specific specification.
|
|
|
224
|
|
|
225 If PROPERTY does not name a built-in property, its value will
|
|
|
226 simply be returned unless it is a specifier object, in which case
|
|
|
227 it will be instanced using `specifier-instance'.
|
|
|
228
|
|
|
229 Optional arguments DEFAULT and NO-FALLBACK are the same as in
|
|
|
230 `specifier-instance'."
|
|
|
231
|
|
|
232 (setq face (get-face face))
|
|
|
233 (let ((value (get face property)))
|
|
|
234 (if (specifierp value)
|
|
|
235 (setq value (specifier-instance value domain default no-fallback)))
|
|
|
236 value))
|
|
|
237
|
|
|
238 (defun face-property-matching-instance (face property matchspec
|
|
872
|
239 &optional domain default
|
|
|
240 no-fallback)
|
|
428
|
241 "Return the instance of FACE's PROPERTY matching MATCHSPEC in DOMAIN.
|
|
|
242 Currently the only useful value for MATCHSPEC is a charset, when used
|
|
|
243 in conjunction with the face's font; this allows you to retrieve a
|
|
|
244 font that can be used to display a particular charset, rather than just
|
|
|
245 any font.
|
|
|
246
|
|
|
247 Other than MATCHSPEC, this function is identical to `face-property-instance'.
|
|
|
248 See also `specifier-matching-instance' for a fuller description of the
|
|
|
249 matching process."
|
|
|
250
|
|
|
251 (setq face (get-face face))
|
|
|
252 (let ((value (get face property)))
|
|
3659
|
253 (when (specifierp value)
|
|
|
254 (setq value (specifier-matching-instance value matchspec domain
|
|
|
255 default no-fallback)))
|
|
428
|
256 value))
|
|
|
257
|
|
|
258 (defun set-face-property (face property value &optional locale tag-set
|
|
872
|
259 how-to-add)
|
|
428
|
260 "Change a property of FACE.
|
|
|
261
|
|
|
262 NOTE: If you want to remove a property from a face, use `remove-face-property'
|
|
|
263 rather than attempting to set a value of nil for the property.
|
|
|
264
|
|
|
265 For built-in properties, the actual value of the property is a
|
|
|
266 specifier and you cannot change this; but you can change the
|
|
|
267 specifications within the specifier, and that is what this function
|
|
|
268 will do. For user-defined properties, you can use this function
|
|
|
269 to either change the actual value of the property or, if this value
|
|
|
270 is a specifier, change the specifications within it.
|
|
|
271
|
|
|
272 If PROPERTY is a built-in property, the specifications to be added to
|
|
|
273 this property can be supplied in many different ways:
|
|
|
274
|
|
|
275 -- If VALUE is a simple instantiator (e.g. a string naming a font or
|
|
|
276 color) or a list of instantiators, then the instantiator(s) will
|
|
|
277 be added as a specification of the property for the given LOCALE
|
|
3027
|
278 (which defaults to `global' if omitted).
|
|
428
|
279 -- If VALUE is a list of specifications (each of which is a cons of
|
|
|
280 a locale and a list of instantiators), then LOCALE must be nil
|
|
|
281 (it does not make sense to explicitly specify a locale in this
|
|
|
282 case), and specifications will be added as given.
|
|
|
283 -- If VALUE is a specifier (as would be returned by `face-property'
|
|
|
284 if no LOCALE argument is given), then some or all of the
|
|
|
285 specifications in the specifier will be added to the property.
|
|
|
286 In this case, the function is really equivalent to
|
|
|
287 `copy-specifier' and LOCALE has the same semantics (if it is
|
|
|
288 a particular locale, the specification for the locale will be
|
|
|
289 copied; if a locale type, specifications for all locales of
|
|
3027
|
290 that type will be copied; if nil or `all', then all
|
|
428
|
291 specifications will be copied).
|
|
|
292
|
|
3027
|
293 HOW-TO-ADD should be either nil or one of the symbols `prepend',
|
|
|
294 `append', `remove-tag-set-prepend', `remove-tag-set-append', `remove-locale',
|
|
|
295 `remove-locale-type', or `remove-all'. See `copy-specifier' and
|
|
428
|
296 `add-spec-to-specifier' for a description of what each of
|
|
|
297 these means. Most of the time, you do not need to worry about
|
|
|
298 this argument; the default behavior usually is fine.
|
|
|
299
|
|
|
300 In general, it is OK to pass an instance object (e.g. as returned
|
|
|
301 by `face-property-instance') as an instantiator in place of
|
|
|
302 an actual instantiator. In such a case, the instantiator used
|
|
|
303 to create that instance object will be used (for example, if
|
|
3027
|
304 you set a font-instance object as the value of the `font'
|
|
428
|
305 property, then the font name used to create that object will
|
|
|
306 be used instead). If some cases, however, doing this
|
|
|
307 conversion does not make sense, and this will be noted in
|
|
|
308 the documentation for particular types of instance objects.
|
|
|
309
|
|
|
310 If PROPERTY is not a built-in property, then this function will
|
|
|
311 simply set its value if LOCALE is nil. However, if LOCALE is
|
|
|
312 given, then this function will attempt to add VALUE as the
|
|
|
313 instantiator for the given LOCALE, using `add-spec-to-specifier'.
|
|
|
314 If the value of the property is not a specifier, it will
|
|
3027
|
315 automatically be converted into a `generic' specifier.
|
|
428
|
316
|
|
|
317
|
|
|
318 The following symbols have predefined meanings:
|
|
|
319
|
|
|
320 foreground The foreground color of the face.
|
|
442
|
321 For valid instantiators, see `make-color-specifier'.
|
|
428
|
322
|
|
|
323 background The background color of the face.
|
|
442
|
324 For valid instantiators, see `make-color-specifier'.
|
|
428
|
325
|
|
|
326 font The font used to display text covered by this face.
|
|
442
|
327 For valid instantiators, see `make-font-specifier'.
|
|
428
|
328
|
|
|
329 display-table The display table of the face.
|
|
|
330 This should be a vector of 256 elements.
|
|
|
331
|
|
|
332 background-pixmap The pixmap displayed in the background of the face.
|
|
442
|
333 Only used by faces on X and MS Windows devices.
|
|
|
334 For valid instantiators, see `make-image-specifier'.
|
|
428
|
335
|
|
|
336 underline Underline all text covered by this face.
|
|
442
|
337 For valid instantiators, see `make-face-boolean-specifier'.
|
|
428
|
338
|
|
|
339 strikethru Draw a line through all text covered by this face.
|
|
442
|
340 For valid instantiators, see `make-face-boolean-specifier'.
|
|
428
|
341
|
|
|
342 highlight Highlight all text covered by this face.
|
|
|
343 Only used by faces on TTY devices.
|
|
442
|
344 For valid instantiators, see `make-face-boolean-specifier'.
|
|
428
|
345
|
|
|
346 dim Dim all text covered by this face.
|
|
442
|
347 For valid instantiators, see `make-face-boolean-specifier'.
|
|
428
|
348
|
|
|
349 blinking Blink all text covered by this face.
|
|
|
350 Only used by faces on TTY devices.
|
|
442
|
351 For valid instantiators, see `make-face-boolean-specifier'.
|
|
428
|
352
|
|
|
353 reverse Reverse the foreground and background colors.
|
|
|
354 Only used by faces on TTY devices.
|
|
442
|
355 For valid instantiators, see `make-face-boolean-specifier'.
|
|
428
|
356
|
|
3027
|
357 inherit Face name or face object from which to inherit attributes,
|
|
|
358 or a list of such elements. Attributes from inherited
|
|
|
359 faces are merged into the face like an underlying face
|
|
|
360 would be, with higher priority than underlying faces.
|
|
|
361
|
|
428
|
362 doc-string Description of what the face's normal use is.
|
|
|
363 NOTE: This is not a specifier, unlike all
|
|
|
364 the other built-in properties, and cannot
|
|
|
365 contain locale-specific values."
|
|
|
366
|
|
|
367 (setq face (get-face face))
|
|
|
368 (if (memq property built-in-face-specifiers)
|
|
|
369 (set-specifier (get face property) value locale tag-set how-to-add)
|
|
|
370
|
|
|
371 ;; This section adds user defined properties.
|
|
|
372 (if (not locale)
|
|
|
373 (put face property value)
|
|
|
374 (convert-face-property-into-specifier face property)
|
|
|
375 (add-spec-to-specifier (get face property) value locale tag-set
|
|
|
376 how-to-add)))
|
|
|
377 value)
|
|
|
378
|
|
|
379 (defun remove-face-property (face property &optional locale tag-set exact-p)
|
|
|
380 "Remove a property from FACE.
|
|
|
381 For built-in properties, this is analogous to `remove-specifier'.
|
|
|
382 See `remove-specifier' for the meaning of the LOCALE, TAG-SET, and EXACT-P
|
|
|
383 arguments."
|
|
|
384 (or locale (setq locale 'all))
|
|
|
385 (if (memq property built-in-face-specifiers)
|
|
|
386 (remove-specifier (face-property face property) locale tag-set exact-p)
|
|
|
387 (if (eq locale 'all)
|
|
|
388 (remprop (get-face face) property)
|
|
|
389 (convert-face-property-into-specifier face property)
|
|
|
390 (remove-specifier (face-property face property) locale tag-set
|
|
|
391 exact-p))))
|
|
|
392
|
|
|
393 (defun reset-face (face &optional locale tag-set exact-p)
|
|
|
394 "Clear all existing built-in specifications from FACE.
|
|
3027
|
395 This makes FACE inherit all its display properties from `default'.
|
|
428
|
396 WARNING: Be absolutely sure you want to do this!!! It is a dangerous
|
|
|
397 operation and is not undoable.
|
|
|
398
|
|
|
399 The arguments LOCALE, TAG-SET and EXACT-P are the same as for
|
|
|
400 `remove-specifier'."
|
|
3918
|
401 ;; Don't reset the default face.
|
|
|
402 (unless (eq 'default face)
|
|
|
403 (dolist (x built-in-face-specifiers nil)
|
|
|
404 (remove-specifier (face-property face x) locale tag-set exact-p))))
|
|
428
|
405
|
|
|
406 (defun set-face-parent (face parent &optional locale tag-set how-to-add)
|
|
|
407 "Set the parent of FACE to PARENT, for all properties.
|
|
|
408 This makes all properties of FACE inherit from PARENT."
|
|
|
409 (setq parent (get-face parent))
|
|
|
410 (mapcar (lambda (x)
|
|
|
411 (set-face-property face x (vector parent) locale tag-set
|
|
|
412 how-to-add))
|
|
3027
|
413 (set-difference built-in-face-specifiers
|
|
|
414 '(display-table background-pixmap inherit)))
|
|
428
|
415 (set-face-background-pixmap face (vector 'inherit ':face parent)
|
|
|
416 locale tag-set how-to-add)
|
|
|
417 nil)
|
|
|
418
|
|
|
419 (defun face-doc-string (face)
|
|
|
420 "Return the documentation string for FACE."
|
|
|
421 (face-property face 'doc-string))
|
|
|
422
|
|
|
423 (defun set-face-doc-string (face doc-string)
|
|
|
424 "Change the documentation string of FACE to DOC-STRING."
|
|
|
425 (interactive (face-interactive "doc-string"))
|
|
|
426 (set-face-property face 'doc-string doc-string))
|
|
|
427
|
|
|
428 (defun face-font-name (face &optional domain charset)
|
|
|
429 "Return the font name of FACE in DOMAIN, or nil if it is unspecified.
|
|
3027
|
430 DOMAIN is as in `face-font-instance'.
|
|
|
431
|
|
|
432 Font names are strings, as described in `make-font-specifier'."
|
|
428
|
433 (let ((f (face-font-instance face domain charset)))
|
|
|
434 (and f (font-instance-name f))))
|
|
|
435
|
|
|
436 (defun face-font (face &optional locale tag-set exact-p)
|
|
3027
|
437 "Return the font spec of FACE in LOCALE, or nil if it is unspecified.
|
|
|
438
|
|
|
439 NOTE: This returns a locale-specific specification, not any sort of value
|
|
|
440 corresponding to the actual font being used. If you want to know the
|
|
|
441 actual font used in a particular domain, use `face-font-instance', or
|
|
|
442 `face-font-name' for its name (i.e. the instantiator used to create it).
|
|
428
|
443
|
|
|
444 FACE may be either a face object or a symbol representing a face.
|
|
|
445
|
|
|
446 LOCALE may be a locale (the instantiators for that particular locale
|
|
|
447 will be returned), a locale type (the specifications for all locales
|
|
3027
|
448 of that type will be returned), `all' (all specifications will be
|
|
428
|
449 returned), or nil (the actual specifier object will be returned).
|
|
|
450
|
|
|
451 See `face-property' for more information."
|
|
|
452 (face-property face 'font locale tag-set exact-p))
|
|
|
453
|
|
|
454 (defun face-font-instance (face &optional domain charset)
|
|
|
455 "Return the instance of FACE's font in DOMAIN.
|
|
|
456
|
|
3027
|
457 Return value will be a font instance object; query its properties using
|
|
|
458 `font-instance-name', `font-instance-height', `font-instance-width', etc.
|
|
|
459
|
|
428
|
460 FACE may be either a face object or a symbol representing a face.
|
|
|
461
|
|
|
462 Normally DOMAIN will be a window or nil (meaning the selected window),
|
|
|
463 and an instance object describing how the font appears in that
|
|
|
464 particular window and buffer will be returned.
|
|
|
465
|
|
3659
|
466 CHARSET is a Mule charset (meaning return the font used for that charset) or
|
|
|
467 nil (meaning return the font used for ASCII.)
|
|
|
468
|
|
428
|
469 See `face-property-instance' for more information."
|
|
3659
|
470 (if (null charset)
|
|
|
471 (face-property-instance face 'font domain)
|
|
|
472 (let (matchspec)
|
|
|
473 ;; get-charset signals an error if its argument doesn't have an
|
|
|
474 ;; associated charset.
|
|
4222
|
475 (setq charset (if-fboundp #'get-charset
|
|
|
476 (get-charset charset)
|
|
|
477 (error 'unimplemented "Charset support not available"))
|
|
3659
|
478 matchspec (cons charset nil))
|
|
|
479 (or (null (setcdr matchspec 'initial))
|
|
|
480 (face-property-matching-instance
|
|
|
481 face 'font matchspec domain)
|
|
|
482 (null (setcdr matchspec 'final))
|
|
|
483 (face-property-matching-instance
|
|
|
484 face 'font matchspec domain)))))
|
|
428
|
485
|
|
|
486 (defun set-face-font (face font &optional locale tag-set how-to-add)
|
|
|
487 "Change the font of FACE to FONT in LOCALE.
|
|
|
488
|
|
|
489 FACE may be either a face object or a symbol representing a face.
|
|
|
490
|
|
3659
|
491 FONT should be an instantiator (see `make-font-specifier'; a common
|
|
|
492 instantiator is a platform-dependent string naming the font), a list
|
|
|
493 of instantiators, an alist of specifications (each mapping a locale
|
|
|
494 to an instantiator list), or a font specifier object.
|
|
428
|
495
|
|
3659
|
496 If FONT is an alist, LOCALE must be omitted. If FONT is a specifier
|
|
|
497 object, LOCALE can be a locale, a locale type, `all', or nil; see
|
|
|
498 `copy-specifier' for its semantics. Common LOCALEs are buffer
|
|
|
499 objects, window objects, device objects and `global'. Otherwise
|
|
|
500 LOCALE specifies the locale under which the specified
|
|
|
501 instantiator(s) will be added, and defaults to `global'.
|
|
428
|
502
|
|
|
503 See `set-face-property' for more information."
|
|
|
504 (interactive (face-interactive "font"))
|
|
|
505 (set-face-property face 'font font locale tag-set how-to-add))
|
|
|
506
|
|
|
507 (defun face-foreground (face &optional locale tag-set exact-p)
|
|
3027
|
508 "Return the foreground spec of FACE in LOCALE, or nil if it is unspecified.
|
|
|
509
|
|
|
510 NOTE: This returns a locale-specific specification, not any sort of value
|
|
|
511 corresponding to the actual foreground being used. If you want to know the
|
|
|
512 actual foreground color used in a particular domain, use
|
|
|
513 `face-foreground-instance', or `face-foreground-name' for its name
|
|
|
514 \(i.e. the instantiator used to create it).
|
|
428
|
515
|
|
|
516 FACE may be either a face object or a symbol representing a face.
|
|
|
517
|
|
|
518 LOCALE may be a locale (the instantiators for that particular locale
|
|
|
519 will be returned), a locale type (the specifications for all locales
|
|
3027
|
520 of that type will be returned), `all' (all specifications will be
|
|
428
|
521 returned), or nil (the actual specifier object will be returned).
|
|
|
522
|
|
|
523 See `face-property' for more information."
|
|
|
524 (face-property face 'foreground locale tag-set exact-p))
|
|
|
525
|
|
|
526 (defun face-foreground-instance (face &optional domain default no-fallback)
|
|
|
527 "Return the instance of FACE's foreground in DOMAIN.
|
|
|
528
|
|
3027
|
529 Return value will be a color instance object; query its properties using
|
|
|
530 `color-instance-name' or `color-instance-rgb-properties'.
|
|
|
531
|
|
428
|
532 FACE may be either a face object or a symbol representing a face.
|
|
|
533
|
|
|
534 Normally DOMAIN will be a window or nil (meaning the selected window),
|
|
|
535 and an instance object describing how the foreground appears in that
|
|
|
536 particular window and buffer will be returned.
|
|
|
537
|
|
|
538 See `face-property-instance' for more information."
|
|
|
539 (face-property-instance face 'foreground domain default no-fallback))
|
|
|
540
|
|
|
541 (defun face-foreground-name (face &optional domain default no-fallback)
|
|
|
542 "Return the name of FACE's foreground color in DOMAIN.
|
|
|
543
|
|
|
544 FACE may be either a face object or a symbol representing a face.
|
|
|
545
|
|
|
546 Normally DOMAIN will be a window or nil (meaning the selected window),
|
|
|
547 and an instance object describing how the background appears in that
|
|
|
548 particular window and buffer will be returned.
|
|
|
549
|
|
|
550 See `face-property-instance' for more information."
|
|
|
551 (color-instance-name (face-foreground-instance
|
|
|
552 face domain default no-fallback)))
|
|
|
553
|
|
|
554 (defun set-face-foreground (face color &optional locale tag-set how-to-add)
|
|
|
555 "Change the foreground color of FACE to COLOR in LOCALE.
|
|
|
556
|
|
|
557 FACE may be either a face object or a symbol representing a face.
|
|
|
558
|
|
442
|
559 COLOR should be an instantiator (see `make-color-specifier'), a list of
|
|
428
|
560 instantiators, an alist of specifications (each mapping a locale to
|
|
|
561 an instantiator list), or a color specifier object.
|
|
|
562
|
|
|
563 If COLOR is an alist, LOCALE must be omitted. If COLOR is a
|
|
3027
|
564 specifier object, LOCALE can be a locale, a locale type, `all',
|
|
428
|
565 or nil; see `copy-specifier' for its semantics. Otherwise LOCALE
|
|
|
566 specifies the locale under which the specified instantiator(s)
|
|
3027
|
567 will be added, and defaults to `global'.
|
|
428
|
568
|
|
|
569 See `set-face-property' for more information."
|
|
|
570 (interactive (face-interactive "foreground"))
|
|
|
571 (set-face-property face 'foreground color locale tag-set how-to-add))
|
|
|
572
|
|
|
573 (defun face-background (face &optional locale tag-set exact-p)
|
|
|
574 "Return the background color of FACE in LOCALE, or nil if it is unspecified.
|
|
|
575
|
|
3027
|
576 NOTE: This returns a locale-specific specification, not any sort of value
|
|
|
577 corresponding to the actual background being used. If you want to know the
|
|
|
578 actual background color used in a particular domain, use
|
|
|
579 `face-background-instance', or `face-background-name' for its name
|
|
|
580 \(i.e. the instantiator used to create it).
|
|
|
581
|
|
428
|
582 FACE may be either a face object or a symbol representing a face.
|
|
|
583
|
|
|
584 LOCALE may be a locale (the instantiators for that particular locale
|
|
|
585 will be returned), a locale type (the specifications for all locales
|
|
3027
|
586 of that type will be returned), `all' (all specifications will be
|
|
428
|
587 returned), or nil (the actual specifier object will be returned).
|
|
|
588
|
|
|
589 See `face-property' for more information."
|
|
|
590 (face-property face 'background locale tag-set exact-p))
|
|
|
591
|
|
|
592 (defun face-background-instance (face &optional domain default no-fallback)
|
|
|
593 "Return the instance of FACE's background in DOMAIN.
|
|
|
594
|
|
3027
|
595 Return value will be a color instance object; query its properties using
|
|
|
596 `color-instance-name' or `color-instance-rgb-properties'.
|
|
|
597
|
|
428
|
598 FACE may be either a face object or a symbol representing a face.
|
|
|
599
|
|
|
600 Normally DOMAIN will be a window or nil (meaning the selected window),
|
|
|
601 and an instance object describing how the background appears in that
|
|
|
602 particular window and buffer will be returned.
|
|
|
603
|
|
|
604 See `face-property-instance' for more information."
|
|
|
605 (face-property-instance face 'background domain default no-fallback))
|
|
|
606
|
|
|
607 (defun face-background-name (face &optional domain default no-fallback)
|
|
|
608 "Return the name of FACE's background color in DOMAIN.
|
|
|
609
|
|
|
610 FACE may be either a face object or a symbol representing a face.
|
|
|
611
|
|
|
612 Normally DOMAIN will be a window or nil (meaning the selected window),
|
|
|
613 and an instance object describing how the background appears in that
|
|
|
614 particular window and buffer will be returned.
|
|
|
615
|
|
|
616 See `face-property-instance' for more information."
|
|
|
617 (color-instance-name (face-background-instance
|
|
|
618 face domain default no-fallback)))
|
|
|
619
|
|
|
620 (defun set-face-background (face color &optional locale tag-set how-to-add)
|
|
|
621 "Change the background color of FACE to COLOR in LOCALE.
|
|
|
622
|
|
|
623 FACE may be either a face object or a symbol representing a face.
|
|
|
624
|
|
442
|
625 COLOR should be an instantiator (see `make-color-specifier'), a list of
|
|
428
|
626 instantiators, an alist of specifications (each mapping a locale to
|
|
|
627 an instantiator list), or a color specifier object.
|
|
|
628
|
|
|
629 If COLOR is an alist, LOCALE must be omitted. If COLOR is a
|
|
3027
|
630 specifier object, LOCALE can be a locale, a locale type, `all',
|
|
428
|
631 or nil; see `copy-specifier' for its semantics. Otherwise LOCALE
|
|
|
632 specifies the locale under which the specified instantiator(s)
|
|
3027
|
633 will be added, and defaults to `global'.
|
|
428
|
634
|
|
|
635 See `set-face-property' for more information."
|
|
|
636 (interactive (face-interactive "background"))
|
|
|
637 (set-face-property face 'background color locale tag-set how-to-add))
|
|
|
638
|
|
|
639 (defun face-background-pixmap (face &optional locale tag-set exact-p)
|
|
3027
|
640 "Return the background pixmap spec of FACE in LOCALE, or nil if unspecified.
|
|
428
|
641 This property is only used on window system devices.
|
|
|
642
|
|
3027
|
643 NOTE: This returns a locale-specific specification, not any sort of value
|
|
|
644 corresponding to the actual background pixmap being used. If you want to
|
|
|
645 know the actual background pixmap used in a particular domain, use
|
|
|
646 `face-background-pixmap-instance'.
|
|
|
647
|
|
428
|
648 FACE may be either a face object or a symbol representing a face.
|
|
|
649
|
|
|
650 LOCALE may be a locale (the instantiators for that particular locale
|
|
|
651 will be returned), a locale type (the specifications for all locales
|
|
3027
|
652 of that type will be returned), `all' (all specifications will be
|
|
428
|
653 returned), or nil (the actual specifier object will be returned).
|
|
|
654
|
|
|
655 See `face-property' for more information."
|
|
|
656 (face-property face 'background-pixmap locale tag-set exact-p))
|
|
|
657
|
|
|
658 (defun face-background-pixmap-instance (face &optional domain default
|
|
|
659 no-fallback)
|
|
|
660 "Return the instance of FACE's background pixmap in DOMAIN.
|
|
|
661
|
|
3027
|
662 Return value will be an image instance object; query its properties using
|
|
|
663 `image-instance-instantiator' (the original instantiator used to create
|
|
|
664 the image, which may be a complex beast -- see `make-image-specifier'),
|
|
|
665 `image-instance-file-name' (the file, if any, from which the image was
|
|
|
666 created), `image-instance-height', etc.
|
|
|
667
|
|
428
|
668 FACE may be either a face object or a symbol representing a face.
|
|
|
669
|
|
|
670 Normally DOMAIN will be a window or nil (meaning the selected window),
|
|
|
671 and an instance object describing how the background appears in that
|
|
|
672 particular window and buffer will be returned.
|
|
|
673
|
|
|
674 See `face-property-instance' for more information."
|
|
|
675 (face-property-instance face 'background-pixmap domain default no-fallback))
|
|
|
676
|
|
|
677 (defun set-face-background-pixmap (face pixmap &optional locale tag-set
|
|
|
678 how-to-add)
|
|
|
679 "Change the background pixmap of FACE to PIXMAP in LOCALE.
|
|
|
680 This property is only used on window system devices.
|
|
|
681
|
|
|
682 FACE may be either a face object or a symbol representing a face.
|
|
|
683
|
|
442
|
684 PIXMAP should be an instantiator (see `make-image-specifier'), a list
|
|
428
|
685 of instantiators, an alist of specifications (each mapping a locale
|
|
|
686 to an instantiator list), or an image specifier object.
|
|
|
687
|
|
|
688 If PIXMAP is an alist, LOCALE must be omitted. If PIXMAP is a
|
|
3027
|
689 specifier object, LOCALE can be a locale, a locale type, `all',
|
|
428
|
690 or nil; see `copy-specifier' for its semantics. Otherwise LOCALE
|
|
|
691 specifies the locale under which the specified instantiator(s)
|
|
3027
|
692 will be added, and defaults to `global'.
|
|
428
|
693
|
|
|
694 See `set-face-property' for more information."
|
|
|
695 (interactive (face-interactive "background-pixmap"))
|
|
|
696 (set-face-property face 'background-pixmap pixmap locale tag-set how-to-add))
|
|
|
697
|
|
1137
|
698 (defvar background-pixmap-file-history nil
|
|
|
699 ;; History for `set-face-background-pixmap-file'
|
|
|
700 )
|
|
|
701
|
|
|
702 (defun set-face-background-pixmap-file (face file)
|
|
|
703 "Read (and set) the background pixmap of FACE from FILE.
|
|
|
704 This function is a simplified version of `set-face-background-pixmap',
|
|
|
705 designed for interactive use."
|
|
|
706 (interactive
|
|
|
707 (let* ((face (read-face-name "Set background pixmap of face: "))
|
|
1139
|
708 (default (and (face-background-pixmap-instance face)
|
|
|
709 ((image-instance-file-name
|
|
|
710 (face-background-pixmap-instance face)))))
|
|
1137
|
711 (file (read-file-name
|
|
|
712 (format "Set background pixmap of face %s to: "
|
|
|
713 (symbol-name face))
|
|
1139
|
714 nil default t nil
|
|
1137
|
715 'background-pixmap-file-history)))
|
|
|
716 (list face (if (equal file "") nil file))))
|
|
|
717 (set-face-property face 'background-pixmap file))
|
|
|
718
|
|
428
|
719 (defun face-display-table (face &optional locale tag-set exact-p)
|
|
3027
|
720 "Return the display table spec of FACE in LOCALE, or nil if unspecified..
|
|
428
|
721
|
|
3027
|
722 NOTE: This returns a locale-specific specification, not any sort of value
|
|
|
723 corresponding to the actual display table being used. If you want to
|
|
|
724 know the actual display table used in a particular domain, use
|
|
|
725 `face-display-table-instance'.
|
|
|
726
|
|
|
727 FACE may be either a face object or a symbol representing a face.
|
|
428
|
728
|
|
|
729 LOCALE may be a locale (the instantiators for that particular locale
|
|
|
730 will be returned), a locale type (the specifications for all locales
|
|
3027
|
731 of that type will be returned), `all' (all specifications will be
|
|
428
|
732 returned), or nil (the actual specifier object will be returned).
|
|
|
733
|
|
|
734 See `face-property' for more information."
|
|
|
735 (face-property face 'display-table locale tag-set exact-p))
|
|
|
736
|
|
|
737 (defun face-display-table-instance (face &optional domain default no-fallback)
|
|
|
738 "Return the instance of FACE's display table in DOMAIN.
|
|
3027
|
739
|
|
|
740 Return value will be a vector, char table or range table; see
|
|
|
741 `current-display-table'.
|
|
|
742
|
|
|
743 FACE may be either a face object or a symbol representing a face.
|
|
428
|
744
|
|
3027
|
745 Normally DOMAIN will be a window or nil (meaning the selected window),
|
|
|
746 and the actual display table used in that particular window and buffer
|
|
|
747 will be returned.
|
|
|
748
|
|
|
749 See `face-property-instance' for more information."
|
|
428
|
750 (face-property-instance face 'display-table domain default no-fallback))
|
|
|
751
|
|
|
752 (defun set-face-display-table (face display-table &optional locale tag-set
|
|
872
|
753 how-to-add)
|
|
428
|
754 "Change the display table of FACE to DISPLAY-TABLE in LOCALE.
|
|
|
755 DISPLAY-TABLE should be a vector as returned by `make-display-table'.
|
|
|
756
|
|
|
757 See `set-face-property' for the semantics of the LOCALE, TAG-SET, and
|
|
|
758 HOW-TO-ADD arguments."
|
|
|
759 (interactive (face-interactive "display-table"))
|
|
|
760 (set-face-property face 'display-table display-table locale tag-set
|
|
|
761 how-to-add))
|
|
|
762
|
|
|
763 ;; The following accessors and mutators are, IMHO, good
|
|
|
764 ;; implementation. Cf. with `make-face-bold'.
|
|
|
765
|
|
|
766 (defun face-underline-p (face &optional domain default no-fallback)
|
|
|
767 "Return t if FACE is underlined in DOMAIN.
|
|
|
768 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
769 (face-property-instance face 'underline domain default no-fallback))
|
|
|
770
|
|
|
771 (defun set-face-underline-p (face underline-p &optional locale tag-set
|
|
872
|
772 how-to-add)
|
|
428
|
773 "Change the underline property of FACE to UNDERLINE-P.
|
|
|
774 UNDERLINE-P is normally a face-boolean instantiator; see
|
|
442
|
775 `make-face-boolean-specifier'.
|
|
428
|
776 See `set-face-property' for the semantics of the LOCALE, TAG-SET, and
|
|
|
777 HOW-TO-ADD arguments."
|
|
|
778 (interactive (face-interactive "underline-p" "underlined"))
|
|
|
779 (set-face-property face 'underline underline-p locale tag-set how-to-add))
|
|
|
780
|
|
|
781 (defun face-strikethru-p (face &optional domain default no-fallback)
|
|
|
782 "Return t if FACE is strikethru-d (i.e. struck through) in DOMAIN.
|
|
|
783 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
784 (face-property-instance face 'strikethru domain default no-fallback))
|
|
|
785
|
|
|
786 (defun set-face-strikethru-p (face strikethru-p &optional locale tag-set
|
|
872
|
787 how-to-add)
|
|
428
|
788 "Change whether FACE is strikethru-d (i.e. struck through) in LOCALE.
|
|
|
789 STRIKETHRU-P is normally a face-boolean instantiator; see
|
|
442
|
790 `make-face-boolean-specifier'.
|
|
428
|
791 See `set-face-property' for the semantics of the LOCALE, TAG-SET, and
|
|
|
792 HOW-TO-ADD arguments."
|
|
|
793 (interactive (face-interactive "strikethru-p" "strikethru-d"))
|
|
|
794 (set-face-property face 'strikethru strikethru-p locale tag-set how-to-add))
|
|
|
795
|
|
|
796 (defun face-highlight-p (face &optional domain default no-fallback)
|
|
|
797 "Return t if FACE is highlighted in DOMAIN (TTY domains only).
|
|
|
798 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
799 (face-property-instance face 'highlight domain default no-fallback))
|
|
|
800
|
|
|
801 (defun set-face-highlight-p (face highlight-p &optional locale tag-set
|
|
872
|
802 how-to-add)
|
|
428
|
803 "Change whether FACE is highlighted in LOCALE (TTY locales only).
|
|
|
804 HIGHLIGHT-P is normally a face-boolean instantiator; see
|
|
442
|
805 `make-face-boolean-specifier'.
|
|
428
|
806 See `set-face-property' for the semantics of the LOCALE, TAG-SET, and
|
|
|
807 HOW-TO-ADD arguments."
|
|
|
808 (interactive (face-interactive "highlight-p" "highlighted"))
|
|
|
809 (set-face-property face 'highlight highlight-p locale tag-set how-to-add))
|
|
|
810
|
|
|
811 (defun face-dim-p (face &optional domain default no-fallback)
|
|
|
812 "Return t if FACE is dimmed in DOMAIN.
|
|
|
813 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
814 (face-property-instance face 'dim domain default no-fallback))
|
|
|
815
|
|
|
816 (defun set-face-dim-p (face dim-p &optional locale tag-set how-to-add)
|
|
|
817 "Change whether FACE is dimmed in LOCALE.
|
|
|
818 DIM-P is normally a face-boolean instantiator; see
|
|
442
|
819 `make-face-boolean-specifier'.
|
|
428
|
820 See `set-face-property' for the semantics of the LOCALE, TAG-SET, and
|
|
|
821 HOW-TO-ADD arguments."
|
|
|
822 (interactive (face-interactive "dim-p" "dimmed"))
|
|
|
823 (set-face-property face 'dim dim-p locale tag-set how-to-add))
|
|
|
824
|
|
|
825 (defun face-blinking-p (face &optional domain default no-fallback)
|
|
|
826 "Return t if FACE is blinking in DOMAIN (TTY domains only).
|
|
|
827 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
828 (face-property-instance face 'blinking domain default no-fallback))
|
|
|
829
|
|
|
830 (defun set-face-blinking-p (face blinking-p &optional locale tag-set
|
|
872
|
831 how-to-add)
|
|
428
|
832 "Change whether FACE is blinking in LOCALE (TTY locales only).
|
|
|
833 BLINKING-P is normally a face-boolean instantiator; see
|
|
442
|
834 `make-face-boolean-specifier'.
|
|
428
|
835 See `set-face-property' for the semantics of the LOCALE, TAG-SET, and
|
|
|
836 HOW-TO-ADD arguments."
|
|
|
837 (interactive (face-interactive "blinking-p" "blinking"))
|
|
|
838 (set-face-property face 'blinking blinking-p locale tag-set how-to-add))
|
|
|
839
|
|
|
840 (defun face-reverse-p (face &optional domain default no-fallback)
|
|
|
841 "Return t if FACE is reversed in DOMAIN (TTY domains only).
|
|
|
842 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
843 (face-property-instance face 'reverse domain default no-fallback))
|
|
|
844
|
|
|
845 (defun set-face-reverse-p (face reverse-p &optional locale tag-set how-to-add)
|
|
|
846 "Change whether FACE is reversed in LOCALE (TTY locales only).
|
|
|
847 REVERSE-P is normally a face-boolean instantiator; see
|
|
442
|
848 `make-face-boolean-specifier'.
|
|
428
|
849 See `set-face-property' for the semantics of the LOCALE, TAG-SET, and
|
|
|
850 HOW-TO-ADD arguments."
|
|
|
851 (interactive (face-interactive "reverse-p" "reversed"))
|
|
|
852 (set-face-property face 'reverse reverse-p locale tag-set how-to-add))
|
|
|
853
|
|
|
854
|
|
|
855 (defun face-property-equal (face1 face2 prop domain)
|
|
|
856 (equal (face-property-instance face1 prop domain)
|
|
|
857 (face-property-instance face2 prop domain)))
|
|
|
858
|
|
|
859 (defun face-equal-loop (props face1 face2 domain)
|
|
|
860 (while (and props
|
|
|
861 (face-property-equal face1 face2 (car props) domain))
|
|
|
862 (setq props (cdr props)))
|
|
|
863 (null props))
|
|
|
864
|
|
|
865 (defun face-equal (face1 face2 &optional domain)
|
|
|
866 "Return t if FACE1 and FACE2 will display in the same way in DOMAIN.
|
|
|
867 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
868 (if (null domain) (setq domain (selected-window)))
|
|
|
869 (if (not (valid-specifier-domain-p domain))
|
|
|
870 (error "Invalid specifier domain"))
|
|
|
871 (let ((device (dfw-device domain))
|
|
|
872 (common-props '(foreground background font display-table underline
|
|
3027
|
873 dim inherit))
|
|
428
|
874 (win-props '(background-pixmap strikethru))
|
|
|
875 (tty-props '(highlight blinking reverse)))
|
|
|
876
|
|
|
877 ;; First check the properties which are used in common between the
|
|
|
878 ;; x and tty devices. Then, check those properties specific to
|
|
|
879 ;; the particular device type.
|
|
|
880 (and (face-equal-loop common-props face1 face2 domain)
|
|
|
881 (cond ((eq 'tty (device-type device))
|
|
|
882 (face-equal-loop tty-props face1 face2 domain))
|
|
872
|
883 ((console-on-window-system-p (device-console device))
|
|
428
|
884 (face-equal-loop win-props face1 face2 domain))
|
|
|
885 (t t)))))
|
|
|
886
|
|
|
887 (defun face-differs-from-default-p (face &optional domain)
|
|
|
888 "Return t if FACE will display differently from the default face in DOMAIN.
|
|
|
889 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
890 (not (face-equal face 'default domain)))
|
|
|
891
|
|
|
892 (defun try-font-name (name &optional device)
|
|
872
|
893 "Return NAME if it's a valid font name on DEVICE, else nil."
|
|
428
|
894 ;; yes, name really should be here twice.
|
|
|
895 (and name (make-font-instance name device t) name))
|
|
|
896
|
|
|
897
|
|
872
|
898
|
|
|
899 (defcustom face-frob-from-locale-first nil
|
|
|
900 "*If non nil, use kludgy way of frobbing fonts suitable for non-mule
|
|
|
901 multi-charset environments."
|
|
|
902 :group 'faces
|
|
|
903 :type 'boolean)
|
|
|
904
|
|
428
|
905 ;; This function is a terrible, disgusting hack!!!! Need to
|
|
|
906 ;; separate out the font elements as separate face properties!
|
|
|
907
|
|
|
908 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
909 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
910 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
911 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
912 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
913 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
914 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
915 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
916 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
917 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
918 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
919 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
920 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
921 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
|
922 ;; WE DEMAND LEXICAL SCOPING!!!
|
|
872
|
923
|
|
|
924 ;; When we are initializing a device, it won't be selected; we communicate
|
|
|
925 ;; the device to consider as selected using this variable.
|
|
|
926 (defvar Face-frob-property-device-considered-current nil)
|
|
428
|
927
|
|
872
|
928 (defun Face-frob-property (face locale tag-set exact-p
|
|
|
929 unfrobbed-face frobbed-face
|
|
|
930 win-prop tty-props
|
|
|
931 frob-mapping standard-face-mapping)
|
|
|
932 ;; implement the semantics of `make-face-bold' et al. FACE, LOCALE, TAG-SET
|
|
|
933 ;; and EXACT-P are as in that call. UNFROBBED-FACE and FROBBED-FACE are
|
|
|
934 ;; what we expect the original face and the result to look like,
|
|
|
935 ;; respectively. TTY-PROPS is a list of face properties to frob in place
|
|
|
936 ;; of `font' for TTY's. FROB-MAPPING is either a plist mapping device
|
|
|
937 ;; types to functions of two args (NAME DEVICE) that will frob the
|
|
|
938 ;; instantiator as appropriate for the device type (this includes TTY's),
|
|
|
939 ;; or a function to handle the mapping for all device types.
|
|
|
940 ;; STANDARD-FACE-MAPPING is an alist of mappings of inheritance
|
|
|
941 ;; instantiators to be replaced with other inheritance instantiators, meant
|
|
|
942 ;; for e.g. converting [bold] into [bold-italic].
|
|
|
943
|
|
|
944 ;; #### it would be nice if this function could be generalized to be
|
|
|
945 ;; a general specifier frobber. but so much of what it does is specific
|
|
|
946 ;; to faces -- e.g. handling of inheritance, standard faces,
|
|
|
947 ;; special-casing in various ways for tty's, etc. i've already extracted
|
|
|
948 ;; as much of the functionality as i can into subfunctions in the
|
|
|
949 ;; heuristic section of specifier.el.
|
|
442
|
950
|
|
872
|
951 ;; #### Note: The old code was totally different (and there was much less
|
|
|
952 ;; of it). It didn't bother with trying to frob all the instantiators,
|
|
|
953 ;; or handle inheritance vectors as instantiators, or do something
|
|
|
954 ;; sensible with buffer locales, or many other things. (It always, or
|
|
|
955 ;; usually, did a specifier-instance and frobbed the result.) But it did
|
|
|
956 ;; do three things we don't:
|
|
|
957 ;;
|
|
|
958 ;; (1) Map over all devices when processing global or buffer locales.
|
|
|
959 ;; Should we be doing this in stages 2 and/or 3? The fact that we
|
|
|
960 ;; now process all fallback instantiators seems to make this less
|
|
|
961 ;; necessary, at least for global locales.
|
|
|
962 ;;
|
|
|
963 ;; (2) Remove all instantiators tagged with `default' when putting the
|
|
|
964 ;; instantiators back. I don't see why this is necessary, but maybe
|
|
|
965 ;; it is.
|
|
|
966 ;;
|
|
|
967 ;; (3) Pay attention to the face-frob-from-locale-first variable. ####
|
|
|
968 ;; I don't understand its purpose. Undocumented hacks like this,
|
|
|
969 ;; clearly added after-the-fact, don't deserve to live. DOCUMENT
|
|
|
970 ;; THIS SHIT!
|
|
428
|
971
|
|
872
|
972 (flet
|
|
|
973 (
|
|
|
974
|
|
|
975 ;; non-nil if either instantiator non-nil, or nil instantiators allowed.
|
|
|
976 (nil-instantiator-ok (inst devtype-spec)
|
|
|
977 (or inst (eq devtype-spec 'tty)))
|
|
|
978
|
|
|
979 ;; if LOCALE is a global locale (all, nil, global), return 'global,
|
|
|
980 ;; else nil.
|
|
|
981 (global-locale (locale)
|
|
|
982 (and (memq locale '(all nil global)) 'global))
|
|
444
|
983
|
|
872
|
984 ;; Given a locale and the inst-list from that locale, frob the
|
|
|
985 ;; instantiators according to FROB-MAPPING, a plist mapping device
|
|
|
986 ;; types to functions that frob instantiators of that device type.
|
|
|
987 ;; NOTE: TAG-SET and FROB-MAPPING from environment.
|
|
|
988 (frob-face-inst-list (locale inst-list prop devtype-spec)
|
|
|
989 (let* ((ffpdev Face-frob-property-device-considered-current)
|
|
|
990 (results
|
|
|
991 ;; for each inst-pair, frob it (the result will be 0 or
|
|
|
992 ;; more inst-pairs; we may get more than one if, e.g. the
|
|
|
993 ;; instantiator specifies inheritance and we expand the
|
|
|
994 ;; inheritance); then nconc the results together
|
|
|
995 (loop for (tag-set . x) in inst-list
|
|
|
996 for devtype = (derive-device-type-from-locale-and-tag-set
|
|
|
997 locale tag-set devtype-spec ffpdev)
|
|
|
998 ;; devtype may be nil if it fails to match DEVTYPE-SPEC
|
|
|
999 if devtype
|
|
3360
|
1000 if (let* ((mapper
|
|
|
1001 (cond ((functionp frob-mapping) frob-mapping)
|
|
|
1002 ((plist-get frob-mapping devtype))
|
|
|
1003 (t (error 'unimplemented "mapper" devtype))))
|
|
872
|
1004 (result
|
|
|
1005 (cond
|
|
|
1006 ;; if a vector ...
|
|
|
1007 ((vectorp x)
|
|
|
1008 (let ((change-to
|
|
|
1009 (cdr (assoc x standard-face-mapping))))
|
|
|
1010 (cond
|
|
|
1011 ;; (1) handle standard mappings/null vectors
|
|
|
1012 ((or change-to (null (length x)))
|
|
|
1013 (list (cons tag-set
|
|
|
1014 (cond ((eq change-to t) x)
|
|
|
1015 (change-to)
|
|
|
1016 (t x)))))
|
|
|
1017 ;; (2) inheritance vectors. retrieve the
|
|
|
1018 ;; inherited value and recursively frob.
|
|
|
1019 ;; stick the tag-set into the result.
|
|
|
1020 (t (let*
|
|
|
1021 ((subprop
|
|
|
1022 (if (> (length x) 1) (elt x 1)
|
|
|
1023 prop))
|
|
|
1024 (subinsts
|
|
|
1025 (frob-face-inst-list
|
|
|
1026 locale
|
|
|
1027 (cdar
|
|
|
1028 (specifier-spec-list
|
|
|
1029 (face-property (elt x 0)
|
|
|
1030 subprop)))
|
|
|
1031 subprop devtype-spec)))
|
|
|
1032 ;; #### we don't currently handle
|
|
|
1033 ;; the "reverse the sense" flag on
|
|
|
1034 ;; tty inheritance vectors.
|
|
|
1035 (add-tag-to-inst-list subinsts
|
|
|
1036 tag-set))))))
|
|
|
1037 ;; (3) not a vector. just process it.
|
|
|
1038 (t
|
|
|
1039 (let ((value
|
|
|
1040 (if (eq devtype-spec 'tty)
|
|
|
1041 (funcall mapper x)
|
|
|
1042 (funcall mapper x
|
|
|
1043 (derive-domain-from-locale
|
|
|
1044 locale devtype-spec
|
|
|
1045 ffpdev)))))
|
|
|
1046 (and (nil-instantiator-ok value devtype-spec)
|
|
|
1047 (list (cons tag-set value))))))))
|
|
|
1048 ;; if we're adding to a tty, we need to tag our
|
|
|
1049 ;; additions with `tty'; see [note 1] below. we leave
|
|
|
1050 ;; the old spec in place, however -- if e.g. we're
|
|
|
1051 ;; italicizing a font that was always set to be
|
|
|
1052 ;; underlined, even on window systems, then we still
|
|
|
1053 ;; want the underline there. unless we put the old
|
|
|
1054 ;; spec back, the underline will disappear, since
|
|
|
1055 ;; the new specs are all tagged with `tty'. this
|
|
|
1056 ;; doesn't apply to the [note 1] situations below
|
|
|
1057 ;; because there we're just adding, not substituting.
|
|
|
1058 (if (and (eq 'tty devtype-spec)
|
|
|
1059 (not (or (eq 'tty tag-set)
|
|
|
1060 (memq 'tty tag-set))))
|
|
|
1061 (nconc (add-tag-to-inst-list result 'tty)
|
|
|
1062 (list (cons tag-set x)))
|
|
|
1063 result))
|
|
|
1064 nconc it)))
|
|
|
1065 (delete-duplicates results :test #'equal)))
|
|
428
|
1066
|
|
872
|
1067 ;; Frob INST-LIST, which came from LOCALE, and put the new value back
|
|
|
1068 ;; into SP at LOCALE. THUNK is a cons of (PROP . DEVTYPE-SPEC), the
|
|
|
1069 ;; property being processed and whether this is a TTY property or a
|
|
|
1070 ;; win property.
|
|
|
1071 (frob-locale (sp locale inst-list thunk)
|
|
|
1072 (let ((newinst (frob-face-inst-list locale inst-list
|
|
|
1073 (car thunk) (cdr thunk))))
|
|
|
1074 (remove-specifier sp locale tag-set exact-p)
|
|
|
1075 (add-spec-list-to-specifier sp (list (cons locale newinst))))
|
|
|
1076 ;; map-specifier should keep going
|
|
|
1077 nil)
|
|
428
|
1078
|
|
872
|
1079 ;; map over all specified locales in LOCALE; for each locale,
|
|
|
1080 ;; frob the instantiators in that locale in the specifier in both
|
|
|
1081 ;; WIN-PROP and TTY-PROPS in FACE. Takes values from environment.
|
|
|
1082 (map-over-locales (locale)
|
|
|
1083 (map-specifier (get face win-prop) #'frob-locale locale
|
|
|
1084 (cons win-prop 'window-system)
|
|
|
1085 tag-set exact-p)
|
|
|
1086 (loop for prop in tty-props do
|
|
|
1087 (map-specifier (get face prop) #'frob-locale locale
|
|
|
1088 (cons prop 'tty)
|
|
|
1089 tag-set exact-p)))
|
|
|
1090
|
|
|
1091 ;; end of flets
|
|
|
1092 )
|
|
|
1093
|
|
|
1094 ;; the function itself
|
|
452
|
1095
|
|
872
|
1096 (let* ((ffpdev Face-frob-property-device-considered-current)
|
|
|
1097 (do-later-stages
|
|
|
1098 (or (global-locale locale)
|
|
|
1099 (valid-specifier-domain-p locale)
|
|
|
1100 (bufferp locale)))
|
|
|
1101 (domain (and do-later-stages
|
|
|
1102 (derive-domain-from-locale locale 'window-system
|
|
|
1103 ffpdev)))
|
|
|
1104 (check-differences
|
|
|
1105 (and unfrobbed-face frobbed-face domain
|
|
|
1106 (not (memq (face-name face)
|
|
|
1107 '(default bold italic bold-italic)))))
|
|
|
1108 (orig-instance
|
|
|
1109 (and check-differences
|
|
|
1110 (face-property-instance face win-prop domain))))
|
|
|
1111
|
|
|
1112 ;; first do the frobbing
|
|
|
1113 (setq face (get-face face))
|
|
|
1114 (map-over-locales locale)
|
|
|
1115
|
|
|
1116 (when do-later-stages
|
|
|
1117
|
|
|
1118 (if (global-locale locale) (setq locale 'global))
|
|
428
|
1119
|
|
872
|
1120 ;; now do the second stage -- if there's nothing there, try
|
|
|
1121 ;; harder to find an instantiator, and frob it.
|
|
|
1122 (let (do-something)
|
|
|
1123 (loop for prop in (cons win-prop tty-props)
|
|
|
1124 for propspec = (get face prop)
|
|
|
1125 for devtype-spec = (if (eq prop win-prop) 'window-system 'tty)
|
|
|
1126 if propspec
|
|
|
1127 do
|
|
|
1128 (or (specifier-spec-list propspec locale)
|
|
|
1129 (let ((doit (derive-specifier-specs-from-locale
|
|
|
1130 propspec locale devtype-spec ffpdev
|
|
|
1131 ;; #### does this make sense? When no tags
|
|
|
1132 ;; given, frob the whole list of fallbacks when
|
|
|
1133 ;; global, else just retrieve a current-device
|
|
|
1134 ;; value. this tries to mirror normal practices,
|
|
|
1135 ;; where with no tags you want everything frobbed,
|
|
|
1136 ;; but with a tag you want only the tag frobbed
|
|
|
1137 ;; and hence you probably don't want lots and lots
|
|
|
1138 ;; of items there. (#### Perhaps the best way --
|
|
|
1139 ;; or at least a way with some theoretical
|
|
|
1140 ;; justifiability -- is to fetch the fallbacks
|
|
|
1141 ;; that match the TAG-SET/EXACT-P, and if none,
|
|
|
1142 ;; fall back onto doing the selected-device
|
|
|
1143 ;; trick.)
|
|
|
1144 (and (not tag-set) (not exact-p)))))
|
|
|
1145 (if (and (not doit) (eq locale 'global))
|
|
|
1146 (error
|
|
|
1147 "No fallback for specifier property %s in face %s???"
|
|
|
1148 prop face))
|
|
|
1149 ;; [note 1] whenever we add to a tty property,
|
|
|
1150 ;; make sure we tag our additions with `tty' to
|
|
|
1151 ;; avoid accidentally messing things up on window
|
|
|
1152 ;; systems (e.g. when making things italic we
|
|
|
1153 ;; don't want to set the underline property on
|
|
|
1154 ;; window systems)
|
|
|
1155 (when doit
|
|
|
1156 (add-spec-list-to-specifier
|
|
|
1157 propspec
|
|
|
1158 (list (cons locale
|
|
|
1159 (add-tag-to-inst-list
|
|
|
1160 doit
|
|
|
1161 (append (if (listp tag-set) tag-set
|
|
|
1162 (list tag-set))
|
|
|
1163 (if (eq devtype-spec 'tty) '(tty)))
|
|
|
1164 ))))
|
|
|
1165 (setq do-something t)))))
|
|
|
1166 (when do-something
|
|
|
1167 (map-over-locales (or (global-locale locale) locale))))
|
|
|
1168
|
|
|
1169 ;; then do the third stage -- check for whether we have to do
|
|
|
1170 ;; the inheritance trick.
|
|
|
1171
|
|
|
1172 (when (and check-differences
|
|
|
1173 (let ((new-instance
|
|
|
1174 (face-property-instance face win-prop domain)))
|
|
|
1175 (and
|
|
|
1176 (equal orig-instance new-instance)
|
|
|
1177 (equal orig-instance
|
|
|
1178 (face-property-instance unfrobbed-face win-prop
|
|
|
1179 domain)))))
|
|
|
1180 (set-face-property face win-prop (vector frobbed-face)
|
|
|
1181 (or (global-locale locale) locale) tag-set))))))
|
|
428
|
1182
|
|
707
|
1183 ;; WE DEMAND FOUNDRY FROBBING!
|
|
|
1184
|
|
|
1185 ;; Family frobbing
|
|
|
1186 ;; Thx Jan Vroonhof, Ref xemacs-beta <87oflypbum.fsf@petteflet.ntlworld.com>
|
|
|
1187 ;; Brainlessly derived from make-face-size by Stephen; don't blame Jan.
|
|
|
1188 ;; I'm long since flown to Rio, it does you little good to blame me, either.
|
|
872
|
1189 (defun make-face-family (face family &optional locale tags exact-p)
|
|
|
1190 "Set FACE's family to FAMILY in LOCALE, if possible."
|
|
|
1191 (interactive (list (read-face-name "Set family of which face: ")
|
|
|
1192 (read-string "Family to set: ")))
|
|
707
|
1193
|
|
872
|
1194 (Face-frob-property face locale tags exact-p
|
|
|
1195 nil nil 'font nil
|
|
|
1196 `(lambda (f d)
|
|
707
|
1197 ;; keep the dependency on font.el for now
|
|
872
|
1198 (let ((fo (font-create-object f d)))
|
|
|
1199 (set-font-family fo ,family)
|
|
707
|
1200 (font-create-name fo d)))
|
|
872
|
1201 nil))
|
|
707
|
1202
|
|
|
1203 ;; Style (ie, typographical face) frobbing
|
|
872
|
1204 (defun make-face-bold (face &optional locale tags exact-p)
|
|
428
|
1205 "Make FACE bold in LOCALE, if possible.
|
|
872
|
1206 This will attempt to make the font bold for window-system locales and will
|
|
|
1207 set the highlight flag for TTY locales.
|
|
|
1208
|
|
|
1209 The actual behavior of this function is somewhat messy, in an attempt to
|
|
|
1210 get more intuitive behavior in quite a lot of different circumstances. (You
|
|
|
1211 might view this as indicative of design failures with specifiers, but in
|
|
|
1212 fact almost all code that attempts to interface to humans and produce
|
|
|
1213 \"intuitive\" results gets messy, particularly with a system as complicated
|
|
|
1214 as specifiers, whose complexity results from an attempt to work well in
|
|
|
1215 many different circumstances.)
|
|
|
1216
|
|
|
1217 The meaning of LOCALE is the same as for `specifier-spec-list', i.e.:
|
|
|
1218
|
|
|
1219 -- If LOCALE is nil, omitted, or `all', this will attempt to \"frob\" all
|
|
|
1220 font specifications for FACE to make them appear bold (i.e. the
|
|
|
1221 specifications are replaced with equivalent specifications, where the
|
|
|
1222 font names have been changed to the closest bold font).
|
|
|
1223
|
|
|
1224 -- If LOCALE is a locale type \(`buffer', `window', etc.), this frobs all
|
|
|
1225 font specifications for locales of that type.
|
|
|
1226
|
|
|
1227 -- If LOCALE is a particular locale, this frobs all font specifications for
|
|
|
1228 that locale.
|
|
428
|
1229
|
|
872
|
1230 If TAGS is given, this only processes instantiators whose tag set includes
|
|
|
1231 all tags mentioned in TAGS. In addition, if EXACT-P is non-nil, only
|
|
|
1232 instantiators whose tag set exactly matches TAGS are processed; otherwise,
|
|
|
1233 additional tags may be present in the instantiator's tag set.
|
|
|
1234
|
|
|
1235 This function proceeeds in three stages.
|
|
|
1236
|
|
|
1237 STAGE 1: Frob the settings that are already present.
|
|
|
1238 STAGE 2: (if called for) Ensure that *some* setting exists in the locale
|
|
|
1239 that was given, finding it in various ways and frobbing it as in
|
|
|
1240 stage 1. This ensures that there is an actual setting for
|
|
|
1241 the locale, so you will get the expected buffer-local/frame-local
|
|
|
1242 behavior -- changes to the global value, to other locales, won't
|
|
|
1243 affect this locale, (b) the face will actually look bold in
|
|
|
1244 the locale.
|
|
1137
|
1245 STAGE 3: (if called for)
|
|
872
|
1246
|
|
|
1247 The way the frobbing works depends on the device type -- first on whether
|
|
|
1248 or not it's TTY, and second, if it's a window-system device type, on which
|
|
|
1249 particular window-system device type. For locales with a specific device
|
|
|
1250 type, we do the frobbing in the context of that device type -- this means
|
|
|
1251 that for TTY device types we set the highlight flag, and for window-system
|
|
|
1252 device types we modify the font spec according to the rules for font specs
|
|
|
1253 of that device type. For global locales, we may process both the highlight
|
|
|
1254 flag and the font specs (depending on the device types compiled into this
|
|
|
1255 XEmacs). When processing font specs, we check the tag set associated with
|
|
|
1256 each font spec to see if it's specific to a particular device type; if so,
|
|
|
1257 we frob it in the context of that type, else we use the type of the current
|
|
|
1258 device. (A hack, but works well in practice -- and if a new device is
|
|
|
1259 created, we will automatically frob all the standard fonts to make sure
|
|
|
1260 they display OK on that device.)
|
|
|
1261
|
|
|
1262 If LOCALE is not a locale type, and both TAGS and EXACT-P are omitted, we
|
|
|
1263 do further frobbing in an attempt to give more intuitive behavior.
|
|
428
|
1264
|
|
872
|
1265 First, if there are no specifications in LOCALE (if LOCALE is `all', we act
|
|
|
1266 as if it were `global' for this step), we do our utmost to put a
|
|
|
1267 specification there; otherwise, this function will have no effect. For
|
|
|
1268 device, frame, or window locales, the face's font is instantiated using the
|
|
|
1269 locale as a domain, and the resulting font is frobbed and added back as a
|
|
|
1270 specification for this locale. If LOCALE is `global', we retrieve the
|
|
|
1271 fallback specs and frob them. If LOCALE is a buffer, things get tricky
|
|
|
1272 since you can't instantiate a specifier in a buffer domain \(the buffer can
|
|
|
1273 appear in multiple places, or in different places over time, so this
|
|
|
1274 operation is not well-defined). We used to signal an error in this case,
|
|
|
1275 but now we instead try to do something logical so that we work somewhat
|
|
|
1276 similarly to buffer-local variables. Specifically, we use
|
|
|
1277 `get-buffer-window' to find a window viewing the buffer, and if there is
|
|
|
1278 one, use this as a domain to instantiate the font, and frob the resulting
|
|
|
1279 value. Otherwise, we use the selected window for the same purpose.
|
|
|
1280
|
|
|
1281 Finally, if the frobbing didn't actually make the font look any different
|
|
|
1282 in whatever domain we instantiated the font in (this happens, for example,
|
|
|
1283 if your font specification is already bold or has no bold equivalent; note
|
|
|
1284 that in this step, we use the selected device in place of `global' or `all'
|
|
|
1285 -- another hack, but works well in practice since there's usually only one
|
|
|
1286 device), and the font currently looks like the font of the `default' face,
|
|
|
1287 it is set to inherit from the `bold' face.
|
|
|
1288
|
|
|
1289 NOTE: For the other functions defined below, the identity of these two
|
|
|
1290 standard faces mentioned in the previous paragraph, and the TTY properties
|
|
|
1291 that are modified, may be different, and whether the TTY property or
|
|
|
1292 properties are set or unset may be different. For example, for
|
|
|
1293 `make-face-unitalic', the last sentence in the previous paragraph would
|
|
|
1294 read \"... and the font currently looks like the font of the `italic' face,
|
|
|
1295 it is set to inherit from the `default' face.\", and the second sentence in
|
|
|
1296 the first paragraph would read \"This will attempt to make the font
|
|
|
1297 non-italic for window-system locales and will unset the underline flag for
|
|
|
1298 TTY locales.\"
|
|
|
1299
|
|
|
1300 Here's a table indicating the behavior differences with the different
|
|
|
1301 functions:
|
|
|
1302
|
|
|
1303 function face1 face2 tty-props tty-val
|
|
|
1304 ----------------------------------------------------------------------------
|
|
|
1305 make-face-bold default bold highlight t
|
|
|
1306 make-face-italic default italic underline t
|
|
|
1307 make-face-bold-italic default bold-italic highlight,underline t
|
|
|
1308 make-face-unbold bold default highlight nil
|
|
|
1309 make-face-unitalic italic default underline nil
|
|
|
1310 "
|
|
428
|
1311 (interactive (list (read-face-name "Make which face bold: ")))
|
|
872
|
1312 (Face-frob-property face locale tags exact-p
|
|
|
1313 'default 'bold 'font '(highlight)
|
|
|
1314 '(tty (lambda (x) t)
|
|
|
1315 x x-make-font-bold
|
|
|
1316 gtk gtk-make-font-bold
|
|
|
1317 mswindows mswindows-make-font-bold
|
|
|
1318 msprinter mswindows-make-font-bold)
|
|
|
1319 '(([default] . [bold])
|
|
|
1320 ([bold] . t)
|
|
|
1321 ([italic] . [bold-italic])
|
|
|
1322 ([bold-italic] . t))))
|
|
428
|
1323
|
|
872
|
1324 (defun make-face-italic (face &optional locale tags exact-p)
|
|
428
|
1325 "Make FACE italic in LOCALE, if possible.
|
|
442
|
1326 This will attempt to make the font italic for X/MS Windows locales and
|
|
|
1327 will set the underline flag for TTY locales. See `make-face-bold' for
|
|
|
1328 the semantics of the LOCALE argument and for more specifics on exactly
|
|
|
1329 how this function works."
|
|
428
|
1330 (interactive (list (read-face-name "Make which face italic: ")))
|
|
872
|
1331 (Face-frob-property face locale tags exact-p
|
|
|
1332 'default 'italic 'font '(underline)
|
|
|
1333 '(tty (lambda (x) t)
|
|
|
1334 x x-make-font-italic
|
|
|
1335 gtk gtk-make-font-italic
|
|
|
1336 mswindows mswindows-make-font-italic
|
|
|
1337 msprinter mswindows-make-font-italic)
|
|
|
1338 '(([default] . [italic])
|
|
|
1339 ([bold] . [bold-italic])
|
|
|
1340 ([italic] . t)
|
|
|
1341 ([bold-italic] . t))))
|
|
428
|
1342
|
|
872
|
1343 (defun make-face-bold-italic (face &optional locale tags exact-p)
|
|
428
|
1344 "Make FACE bold and italic in LOCALE, if possible.
|
|
442
|
1345 This will attempt to make the font bold-italic for X/MS Windows
|
|
|
1346 locales and will set the highlight and underline flags for TTY
|
|
|
1347 locales. See `make-face-bold' for the semantics of the LOCALE
|
|
|
1348 argument and for more specifics on exactly how this function works."
|
|
428
|
1349 (interactive (list (read-face-name "Make which face bold-italic: ")))
|
|
872
|
1350 (Face-frob-property face locale tags exact-p
|
|
|
1351 'default 'bold-italic 'font '(underline highlight)
|
|
|
1352 '(tty (lambda (x) t)
|
|
|
1353 x x-make-font-bold-italic
|
|
|
1354 gtk gtk-make-font-bold-italic
|
|
|
1355 mswindows mswindows-make-font-bold-italic
|
|
|
1356 msprinter mswindows-make-font-bold-italic)
|
|
|
1357 '(([default] . [italic])
|
|
|
1358 ([bold] . [bold-italic])
|
|
|
1359 ([italic] . [bold-italic])
|
|
|
1360 ([bold-italic] . t))))
|
|
428
|
1361
|
|
872
|
1362
|
|
|
1363 (defun make-face-unbold (face &optional locale tags exact-p)
|
|
428
|
1364 "Make FACE non-bold in LOCALE, if possible.
|
|
442
|
1365 This will attempt to make the font non-bold for X/MS Windows locales
|
|
|
1366 and will unset the highlight flag for TTY locales. See
|
|
|
1367 `make-face-bold' for the semantics of the LOCALE argument and for more
|
|
|
1368 specifics on exactly how this function works."
|
|
428
|
1369 (interactive (list (read-face-name "Make which face non-bold: ")))
|
|
872
|
1370 (Face-frob-property face locale tags exact-p
|
|
|
1371 'bold 'default 'font '(highlight)
|
|
|
1372 '(tty (lambda (x) nil)
|
|
|
1373 x x-make-font-unbold
|
|
|
1374 gtk gtk-make-font-unbold
|
|
|
1375 mswindows mswindows-make-font-unbold
|
|
|
1376 msprinter mswindows-make-font-unbold)
|
|
|
1377 '(([default] . t)
|
|
|
1378 ([bold] . [default])
|
|
|
1379 ([italic] . t)
|
|
|
1380 ([bold-italic] . [italic]))))
|
|
428
|
1381
|
|
872
|
1382 (defun make-face-unitalic (face &optional locale tags exact-p)
|
|
428
|
1383 "Make FACE non-italic in LOCALE, if possible.
|
|
442
|
1384 This will attempt to make the font non-italic for X/MS Windows locales
|
|
|
1385 and will unset the underline flag for TTY locales. See
|
|
|
1386 `make-face-bold' for the semantics of the LOCALE argument and for more
|
|
|
1387 specifics on exactly how this function works."
|
|
428
|
1388 (interactive (list (read-face-name "Make which face non-italic: ")))
|
|
872
|
1389 (Face-frob-property face locale tags exact-p
|
|
|
1390 'italic 'default 'font '(underline)
|
|
|
1391 '(tty (lambda (x) nil)
|
|
|
1392 x x-make-font-unitalic
|
|
|
1393 gtk gtk-make-font-unitalic
|
|
|
1394 mswindows mswindows-make-font-unitalic
|
|
|
1395 msprinter mswindows-make-font-unitalic)
|
|
|
1396 '(([default] . t)
|
|
|
1397 ([bold] . t)
|
|
|
1398 ([italic] . [default])
|
|
|
1399 ([bold-italic] . [bold]))))
|
|
428
|
1400
|
|
|
1401
|
|
707
|
1402 ;; Size frobbing
|
|
|
1403 ;; Thx Jan Vroonhof, Ref xemacs-beta <87oflypbum.fsf@petteflet.ntlworld.com>
|
|
1137
|
1404 ;; Jan had a separate helper function
|
|
872
|
1405 (defun make-face-size (face size &optional locale tags exact-p)
|
|
|
1406 "Adjust FACE to SIZE in LOCALE, if possible."
|
|
|
1407 (interactive (list (read-face-name "Set size of which face: ")
|
|
|
1408 (read-number "Size to set: " t 10)))
|
|
|
1409 (Face-frob-property face locale tags exact-p
|
|
|
1410 nil nil 'font nil
|
|
|
1411 `(lambda (f d)
|
|
|
1412 ;; keep the dependency on font.el for now
|
|
|
1413 (let ((fo (font-create-object f d)))
|
|
|
1414 (set-font-size fo ,size)
|
|
|
1415 (font-create-name fo d)))
|
|
|
1416 nil))
|
|
707
|
1417
|
|
428
|
1418 ;; Why do the following two functions lose so badly in so many
|
|
|
1419 ;; circumstances?
|
|
|
1420
|
|
872
|
1421 (defun make-face-smaller (face &optional locale tags exact-p)
|
|
428
|
1422 "Make the font of FACE be smaller, if possible.
|
|
|
1423 LOCALE works as in `make-face-bold' et al., but the ``inheriting-
|
|
|
1424 from-the-bold-face'' operations described there are not done
|
|
|
1425 because they don't make sense in this context."
|
|
|
1426 (interactive (list (read-face-name "Shrink which face: ")))
|
|
872
|
1427 (Face-frob-property face locale tags exact-p
|
|
|
1428 nil nil 'font nil
|
|
|
1429 '(x x-find-smaller-font
|
|
|
1430 gtk gtk-find-smaller-font
|
|
|
1431 mswindows mswindows-find-smaller-font
|
|
|
1432 msprinter mswindows-find-smaller-font)
|
|
|
1433 nil))
|
|
428
|
1434
|
|
872
|
1435 (defun make-face-larger (face &optional locale tags exact-p)
|
|
428
|
1436 "Make the font of FACE be larger, if possible.
|
|
|
1437 See `make-face-smaller' for the semantics of the LOCALE argument."
|
|
|
1438 (interactive (list (read-face-name "Enlarge which face: ")))
|
|
872
|
1439 (Face-frob-property face locale tags exact-p
|
|
|
1440 nil nil 'font nil
|
|
|
1441 '(x x-find-larger-font
|
|
|
1442 gtk gtk-find-larger-font
|
|
|
1443 mswindows mswindows-find-larger-font
|
|
|
1444 msprinter mswindows-find-larger-font)
|
|
|
1445 nil))
|
|
428
|
1446
|
|
|
1447 (defun invert-face (face &optional locale)
|
|
|
1448 "Swap the foreground and background colors of the face."
|
|
|
1449 (interactive (list (read-face-name "Invert face: ")))
|
|
|
1450 (if (valid-specifier-domain-p locale)
|
|
|
1451 (let ((foreface (face-foreground-instance face locale)))
|
|
|
1452 (set-face-foreground face (face-background-instance face locale)
|
|
|
1453 locale)
|
|
|
1454 (set-face-background face foreface locale))
|
|
|
1455 (let ((forespec (copy-specifier (face-foreground face) nil locale)))
|
|
|
1456 (copy-specifier (face-background face) (face-foreground face) locale)
|
|
|
1457 (copy-specifier forespec (face-background face) locale))))
|
|
|
1458
|
|
|
1459
|
|
|
1460 ;;; Convenience functions
|
|
|
1461
|
|
|
1462 (defun face-ascent (face &optional domain charset)
|
|
|
1463 "Return the ascent of FACE in DOMAIN.
|
|
|
1464 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
1465 (font-ascent (face-font face) domain charset))
|
|
|
1466
|
|
|
1467 (defun face-descent (face &optional domain charset)
|
|
|
1468 "Return the descent of FACE in DOMAIN.
|
|
|
1469 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
1470 (font-descent (face-font face) domain charset))
|
|
|
1471
|
|
|
1472 (defun face-width (face &optional domain charset)
|
|
|
1473 "Return the width of FACE in DOMAIN.
|
|
|
1474 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
1475 (font-width (face-font face) domain charset))
|
|
|
1476
|
|
|
1477 (defun face-height (face &optional domain charset)
|
|
|
1478 "Return the height of FACE in DOMAIN.
|
|
|
1479 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
1480 (+ (face-ascent face domain charset) (face-descent face domain charset)))
|
|
|
1481
|
|
|
1482 (defun face-proportional-p (face &optional domain charset)
|
|
|
1483 "Return t if FACE is proportional in DOMAIN.
|
|
|
1484 See `face-property-instance' for the semantics of the DOMAIN argument."
|
|
|
1485 (font-proportional-p (face-font face) domain charset))
|
|
|
1486
|
|
|
1487
|
|
|
1488 ;; Functions that used to be in cus-face.el, but logically go here.
|
|
|
1489
|
|
|
1490 (defcustom frame-background-mode nil
|
|
|
1491 "*The brightness of the background.
|
|
|
1492 Set this to the symbol dark if your background color is dark, light if
|
|
|
1493 your background is light, or nil (default) if you want Emacs to
|
|
|
1494 examine the brightness for you."
|
|
|
1495 :group 'faces
|
|
|
1496 :type '(choice (choice-item dark)
|
|
|
1497 (choice-item light)
|
|
|
1498 (choice-item :tag "Auto" nil)))
|
|
|
1499
|
|
|
1500 ;; The old variable that many people still have in .emacs files.
|
|
|
1501 (define-obsolete-variable-alias 'custom-background-mode
|
|
|
1502 'frame-background-mode)
|
|
|
1503
|
|
|
1504 (defun get-frame-background-mode (frame)
|
|
|
1505 "Detect background mode for FRAME."
|
|
|
1506 (let* ((color-instance (face-background-instance 'default frame))
|
|
|
1507 (mode (condition-case nil
|
|
|
1508 (if (< (apply '+ (color-instance-rgb-components
|
|
|
1509 color-instance)) 65536)
|
|
|
1510 'dark 'light)
|
|
872
|
1511 ;; Here, we get an error on a TTY (Return value from
|
|
|
1512 ;; color-instance-rgb-components is nil), and on the
|
|
|
1513 ;; initial stream device (Return value from
|
|
|
1514 ;; face-background-instance is nil). As we don't have a
|
|
|
1515 ;; good way of detecting whether a TTY is light or dark,
|
|
|
1516 ;; we'll guess it's dark.
|
|
428
|
1517 (error 'dark))))
|
|
|
1518 (set-frame-property frame 'background-mode mode)
|
|
|
1519 mode))
|
|
|
1520
|
|
|
1521 (defun extract-custom-frame-properties (frame)
|
|
|
1522 "Return a plist with the frame properties of FRAME used by custom."
|
|
|
1523 (list 'type (or (frame-property frame 'display-type)
|
|
|
1524 (device-type (frame-device frame)))
|
|
|
1525 'class (device-class (frame-device frame))
|
|
|
1526 'background (or frame-background-mode
|
|
|
1527 (frame-property frame 'background-mode)
|
|
|
1528 (get-frame-background-mode frame))))
|
|
|
1529
|
|
|
1530 (defcustom init-face-from-resources t
|
|
|
1531 "If non nil, attempt to initialize faces from the resource database."
|
|
|
1532 :group 'faces
|
|
|
1533 :type 'boolean)
|
|
|
1534
|
|
|
1535 ;; Old name, used by custom. Also, FSFmacs name.
|
|
|
1536 (defvaralias 'initialize-face-resources 'init-face-from-resources)
|
|
|
1537
|
|
|
1538 ;; Make sure all custom setting are added with this tag so we can
|
|
|
1539 ;; identify-them
|
|
|
1540 (define-specifier-tag 'custom)
|
|
|
1541
|
|
|
1542 (defun face-spec-set (face spec &optional frame tags)
|
|
|
1543 "Set FACE's face attributes according to the first matching entry in SPEC.
|
|
|
1544 If optional FRAME is non-nil, set it for that frame only.
|
|
|
1545 If it is nil, then apply SPEC to each frame individually.
|
|
|
1546 See `defface' for information about SPEC."
|
|
|
1547 (if frame
|
|
|
1548 (progn
|
|
|
1549 (reset-face face frame tags)
|
|
|
1550 (face-display-set face spec frame tags)
|
|
|
1551 (init-face-from-resources face frame))
|
|
|
1552 (let ((frames (relevant-custom-frames)))
|
|
|
1553 (reset-face face nil tags)
|
|
|
1554 ;; This should not be needed. We only remove our own specifiers
|
|
|
1555 ;; (if (and (eq 'default face) (featurep 'x))
|
|
|
1556 ;; (x-init-global-faces))
|
|
|
1557 (face-display-set face spec nil tags)
|
|
|
1558 (while frames
|
|
|
1559 (face-display-set face spec (car frames) tags)
|
|
|
1560 (pop frames))
|
|
|
1561 (init-face-from-resources face))))
|
|
|
1562
|
|
|
1563 (defun face-display-set (face spec &optional frame tags)
|
|
|
1564 "Set FACE to the attributes to the first matching entry in SPEC.
|
|
|
1565 Iff optional FRAME is non-nil, set it for that frame only.
|
|
|
1566 See `defface' for information about SPEC."
|
|
|
1567 (while spec
|
|
|
1568 (let ((display (caar spec))
|
|
|
1569 (atts (cadar spec)))
|
|
|
1570 (pop spec)
|
|
|
1571 (when (face-spec-set-match-display display frame)
|
|
|
1572 ;; Avoid creating frame local duplicates of the global face.
|
|
|
1573 (unless (and frame (eq display (get face 'custom-face-display)))
|
|
|
1574 (apply 'face-custom-attributes-set face frame tags atts))
|
|
|
1575 (unless frame
|
|
|
1576 (put face 'custom-face-display display))
|
|
|
1577 (setq spec nil)))))
|
|
|
1578
|
|
|
1579 (defvar default-custom-frame-properties nil
|
|
|
1580 "The frame properties used for the global faces.
|
|
442
|
1581 Frames not matching these properties should have frame local faces.
|
|
428
|
1582 The value should be nil, if uninitialized, or a plist otherwise.
|
|
|
1583 See `defface' for a list of valid keys and values for the plist.")
|
|
|
1584
|
|
|
1585 (defun get-custom-frame-properties (&optional frame)
|
|
|
1586 "Return a plist with the frame properties of FRAME used by custom.
|
|
|
1587 If FRAME is nil, return the default frame properties."
|
|
|
1588 (cond (frame
|
|
|
1589 ;; Try to get from cache.
|
|
|
1590 (let ((cache (frame-property frame 'custom-properties)))
|
|
|
1591 (unless cache
|
|
|
1592 ;; Oh well, get it then.
|
|
|
1593 (setq cache (extract-custom-frame-properties frame))
|
|
|
1594 ;; and cache it...
|
|
|
1595 (set-frame-property frame 'custom-properties cache))
|
|
|
1596 cache))
|
|
|
1597 (default-custom-frame-properties)
|
|
|
1598 (t
|
|
|
1599 (setq default-custom-frame-properties
|
|
|
1600 (extract-custom-frame-properties (selected-frame))))))
|
|
|
1601
|
|
|
1602 (defun face-spec-update-all-matching (spec display plist)
|
|
|
1603 "Update all entries in the face spec that could match display to
|
|
444
|
1604 have the entries from the new plist and return the new spec."
|
|
428
|
1605 (mapcar
|
|
|
1606 (lambda (e)
|
|
|
1607 (let ((entries (car e))
|
|
|
1608 (options (cadr e))
|
|
|
1609 (match t)
|
|
|
1610 dplist
|
|
|
1611 (new-options plist)
|
|
|
1612 )
|
|
|
1613 (unless (eq display t)
|
|
|
1614 (mapc (lambda (arg)
|
|
|
1615 (setq dplist (plist-put dplist (car arg) (cadr arg))))
|
|
|
1616 display))
|
|
|
1617 (unless (eq entries t)
|
|
|
1618 (mapc (lambda (arg)
|
|
|
1619 (setq match (and match (eq (cadr arg)
|
|
|
1620 (plist-get
|
|
|
1621 dplist (car arg)
|
|
|
1622 (cadr arg))))))
|
|
|
1623 entries))
|
|
|
1624 (if (not match)
|
|
|
1625 e
|
|
|
1626 (while new-options
|
|
|
1627 (setq options
|
|
|
1628 (plist-put options (car new-options) (cadr new-options)))
|
|
|
1629 (setq new-options (cddr new-options)))
|
|
|
1630 (list entries options))))
|
|
|
1631 (copy-sequence spec)))
|
|
444
|
1632
|
|
|
1633
|
|
428
|
1634
|
|
|
1635 (defun face-spec-set-match-display (display &optional frame)
|
|
|
1636 "Return non-nil if DISPLAY matches FRAME.
|
|
|
1637 DISPLAY is part of a spec such as can be used in `defface'.
|
|
|
1638 If FRAME is nil or omitted, the selected frame is used."
|
|
|
1639 (if (eq display t)
|
|
|
1640 t
|
|
|
1641 (let* ((props (get-custom-frame-properties frame))
|
|
|
1642 (type (plist-get props 'type))
|
|
|
1643 (class (plist-get props 'class))
|
|
|
1644 (background (plist-get props 'background))
|
|
|
1645 (match t)
|
|
|
1646 (entries display)
|
|
|
1647 entry req options)
|
|
|
1648 (while (and entries match)
|
|
|
1649 (setq entry (car entries)
|
|
|
1650 entries (cdr entries)
|
|
|
1651 req (car entry)
|
|
|
1652 options (cdr entry)
|
|
|
1653 match (case req
|
|
|
1654 (type (memq type options))
|
|
|
1655 (class (memq class options))
|
|
|
1656 (background (memq background options))
|
|
|
1657 (t (warn "Unknown req `%S' with options `%S'"
|
|
|
1658 req options)
|
|
|
1659 nil))))
|
|
|
1660 match)))
|
|
|
1661
|
|
|
1662 (defun relevant-custom-frames ()
|
|
|
1663 "List of frames whose custom properties differ from the default."
|
|
|
1664 (let ((relevant nil)
|
|
|
1665 (default (get-custom-frame-properties))
|
|
|
1666 (frames (frame-list))
|
|
|
1667 frame)
|
|
|
1668 (while frames
|
|
|
1669 (setq frame (car frames)
|
|
|
1670 frames (cdr frames))
|
|
|
1671 (unless (equal default (get-custom-frame-properties frame))
|
|
|
1672 (push frame relevant)))
|
|
|
1673 relevant))
|
|
|
1674
|
|
|
1675 (defun initialize-custom-faces (&optional frame)
|
|
|
1676 "Initialize all custom faces for FRAME.
|
|
|
1677 If FRAME is nil or omitted, initialize them for all frames."
|
|
|
1678 (mapc (lambda (symbol)
|
|
|
1679 (let ((spec (or (get symbol 'saved-face)
|
|
|
1680 (get symbol 'face-defface-spec))))
|
|
|
1681 (when spec
|
|
|
1682 ;; No need to init-face-from-resources -- code in
|
|
|
1683 ;; `init-frame-faces' does it already.
|
|
|
1684 (face-display-set symbol spec frame))))
|
|
|
1685 (face-list)))
|
|
|
1686
|
|
|
1687 (defun custom-initialize-frame (frame)
|
|
|
1688 "Initialize frame-local custom faces for FRAME if necessary."
|
|
|
1689 (unless (equal (get-custom-frame-properties)
|
|
|
1690 (get-custom-frame-properties frame))
|
|
|
1691 (initialize-custom-faces frame)))
|
|
|
1692
|
|
440
|
1693 (defun startup-initialize-custom-faces ()
|
|
|
1694 "Reset faces created by defface. Only called at startup.
|
|
|
1695 Don't use this function in your program."
|
|
|
1696 (when default-custom-frame-properties
|
|
|
1697 ;; Reset default value to the actual frame, not stream.
|
|
|
1698 (setq default-custom-frame-properties
|
|
|
1699 (extract-custom-frame-properties (selected-frame)))
|
|
|
1700 ;; like initialize-custom-faces but removes property first.
|
|
|
1701 (mapc (lambda (symbol)
|
|
|
1702 (let ((spec (or (get symbol 'saved-face)
|
|
|
1703 (get symbol 'face-defface-spec))))
|
|
|
1704 (when spec
|
|
|
1705 ;; Reset faces created during auto-autoloads loading.
|
|
|
1706 (reset-face symbol)
|
|
|
1707 ;; And set it according to the spec.
|
|
|
1708 (face-display-set symbol spec nil))))
|
|
|
1709 (face-list))))
|
|
|
1710
|
|
428
|
1711
|
|
|
1712 (defun make-empty-face (name &optional doc-string temporary)
|
|
|
1713 "Like `make-face', but doesn't query the resource database."
|
|
|
1714 (let ((init-face-from-resources nil))
|
|
|
1715 (make-face name doc-string temporary)))
|
|
|
1716
|
|
|
1717 (defun init-face-from-resources (face &optional locale)
|
|
|
1718 "Initialize FACE from the resource database.
|
|
3027
|
1719 If LOCALE is specified, it should be a frame, device, or `global', and
|
|
428
|
1720 the face will be resourced over that locale. Otherwise, the face will
|
|
|
1721 be resourced over all possible locales (i.e. all frames, all devices,
|
|
3027
|
1722 and `global')."
|
|
428
|
1723 (cond ((null init-face-from-resources)
|
|
|
1724 ;; Do nothing.
|
|
|
1725 )
|
|
|
1726 ((not locale)
|
|
|
1727 ;; Global, set for all frames.
|
|
|
1728 (progn
|
|
|
1729 (init-face-from-resources face 'global)
|
|
|
1730 (let ((devices (device-list)))
|
|
|
1731 (while devices
|
|
|
1732 (init-face-from-resources face (car devices))
|
|
|
1733 (setq devices (cdr devices))))
|
|
|
1734 (let ((frames (frame-list)))
|
|
|
1735 (while frames
|
|
|
1736 (init-face-from-resources face (car frames))
|
|
|
1737 (setq frames (cdr frames))))))
|
|
|
1738 (t
|
|
|
1739 ;; Specific.
|
|
|
1740 (let ((devtype (cond ((devicep locale) (device-type locale))
|
|
|
1741 ((framep locale) (frame-type locale))
|
|
|
1742 (t nil))))
|
|
|
1743 (cond ((or (and (not devtype) (featurep 'x)) (eq 'x devtype))
|
|
502
|
1744 (declare-fboundp (x-init-face-from-resources face locale)))
|
|
428
|
1745 ((or (not devtype) (eq 'tty devtype))
|
|
|
1746 ;; Nothing to do for TTYs?
|
|
|
1747 ))))))
|
|
|
1748
|
|
|
1749 (defun init-device-faces (device)
|
|
|
1750 ;; First, add any device-local face resources.
|
|
|
1751 (when init-face-from-resources
|
|
|
1752 (loop for face in (face-list) do
|
|
|
1753 (init-face-from-resources face device))
|
|
|
1754 ;; Then do any device-specific initialization.
|
|
|
1755 (cond ((eq 'x (device-type device))
|
|
502
|
1756 (declare-fboundp (x-init-device-faces device)))
|
|
462
|
1757 ((eq 'gtk (device-type device))
|
|
502
|
1758 (declare-fboundp (gtk-init-device-faces device)))
|
|
428
|
1759 ((eq 'mswindows (device-type device))
|
|
502
|
1760 (declare-fboundp (mswindows-init-device-faces device)))
|
|
428
|
1761 ;; Nothing to do for TTYs?
|
|
|
1762 )
|
|
|
1763 (or (eq 'stream (device-type device))
|
|
|
1764 (init-other-random-faces device))))
|
|
|
1765
|
|
|
1766 (defun init-frame-faces (frame)
|
|
|
1767 (when init-face-from-resources
|
|
|
1768 ;; First, add any frame-local face resources.
|
|
|
1769 (loop for face in (face-list) do
|
|
|
1770 (init-face-from-resources face frame))
|
|
|
1771 ;; Then do any frame-specific initialization.
|
|
|
1772 (cond ((eq 'x (frame-type frame))
|
|
502
|
1773 (declare-fboundp (x-init-frame-faces frame)))
|
|
462
|
1774 ((eq 'gtk (frame-type frame))
|
|
502
|
1775 (declare-fboundp (gtk-init-frame-faces frame)))
|
|
428
|
1776 ((eq 'mswindows (frame-type frame))
|
|
502
|
1777 (declare-fboundp (mswindows-init-frame-faces frame)))
|
|
428
|
1778 ;; Is there anything which should be done for TTY's?
|
|
|
1779 )))
|
|
|
1780
|
|
872
|
1781 ;; Called when the first device created.
|
|
428
|
1782
|
|
872
|
1783 (defun init-global-faces (device)
|
|
|
1784 (let ((Face-frob-property-device-considered-current device))
|
|
|
1785 ;; Look for global face resources.
|
|
|
1786 (loop for face in (face-list) do
|
|
|
1787 (init-face-from-resources face 'global))
|
|
|
1788 ;; Further frobbing.
|
|
|
1789 (and (featurep 'x) (declare-fboundp (x-init-global-faces)))
|
|
|
1790 (and (featurep 'gtk) (declare-fboundp (gtk-init-global-faces)))
|
|
|
1791 (and (featurep 'mswindows) (declare-fboundp (mswindows-init-global-faces)))
|
|
462
|
1792
|
|
872
|
1793 ;; for bold and the like, make the global specification be bold etc.
|
|
|
1794 ;; if the user didn't already specify a value. These will also be
|
|
|
1795 ;; frobbed further in init-other-random-faces.
|
|
|
1796 (unless (face-font 'bold 'global)
|
|
|
1797 (make-face-bold 'bold 'global))
|
|
|
1798 ;;
|
|
|
1799 (unless (face-font 'italic 'global)
|
|
|
1800 (make-face-italic 'italic 'global))
|
|
|
1801 ;;
|
|
428
|
1802 (unless (face-font 'bold-italic 'global)
|
|
872
|
1803 (make-face-bold-italic 'bold-italic 'global)
|
|
|
1804 (unless (face-font 'bold-italic 'global)
|
|
|
1805 (copy-face 'bold 'bold-italic)
|
|
|
1806 (make-face-italic 'bold-italic)))
|
|
428
|
1807
|
|
872
|
1808 (when (face-equal 'bold 'bold-italic device)
|
|
|
1809 (copy-face 'italic 'bold-italic)
|
|
|
1810 (make-face-bold 'bold-italic))))
|
|
428
|
1811
|
|
|
1812
|
|
|
1813 ;; These warnings are there for a reason. Just specify your fonts
|
|
|
1814 ;; correctly. Deal with it. Additionally, one can use
|
|
|
1815 ;; `log-warning-minimum-level' instead of this.
|
|
|
1816 ;(defvar inhibit-font-complaints nil
|
|
|
1817 ; "Whether to suppress complaints about incomplete sets of fonts.")
|
|
|
1818
|
|
|
1819 (defun face-complain-about-font (face device)
|
|
|
1820 (if (symbolp face) (setq face (symbol-name face)))
|
|
|
1821 ;; (if (not inhibit-font-complaints)
|
|
707
|
1822 ;; complaining for printers is generally annoying.
|
|
|
1823 (unless (device-printer-p device)
|
|
|
1824 (display-warning
|
|
|
1825 'font
|
|
|
1826 (let ((default-name (face-font-name 'default device)))
|
|
|
1827 (format "%s: couldn't deduce %s %s version of the font
|
|
428
|
1828 %S.
|
|
|
1829
|
|
|
1830 Please specify X resources to make the %s face
|
|
|
1831 visually distinguishable from the default face.
|
|
|
1832 For example, you could add one of the following to $HOME/Emacs:
|
|
|
1833
|
|
2703
|
1834 XEmacs.%s.attributeFont: -dt-*-medium-i-*
|
|
428
|
1835 or
|
|
2703
|
1836 XEmacs.%s.attributeForeground: hotpink\n"
|
|
707
|
1837 invocation-name
|
|
|
1838 (if (string-match "\\`[aeiouAEIOU]" face) "an" "a")
|
|
|
1839 face
|
|
|
1840 default-name
|
|
|
1841 face
|
|
|
1842 face
|
|
|
1843 face
|
|
|
1844 )))))
|
|
428
|
1845
|
|
|
1846
|
|
|
1847 ;; #### This is quite a mess. We should use the custom mechanism for
|
|
|
1848 ;; most of this stuff. Currently we don't do it, because Custom
|
|
|
1849 ;; doesn't use specifiers (yet.) FSF does it the Right Way.
|
|
|
1850
|
|
|
1851 ;; For instance, the definition of `bold' should be something like
|
|
|
1852 ;; (defface bold ((t (:bold t))) "Bold text.") -- and `:bold t' should
|
|
|
1853 ;; make sure that everything works properly.
|
|
|
1854
|
|
|
1855 (defun init-other-random-faces (device)
|
|
|
1856 "Initialize the colors and fonts of the bold, italic, bold-italic,
|
|
|
1857 zmacs-region, list-mode-item-selected, highlight, primary-selection,
|
|
|
1858 secondary-selection, and isearch faces when each device is created. If
|
|
|
1859 you want to add code to do stuff like this, use the create-device-hook."
|
|
|
1860
|
|
|
1861 ;; try to make 'bold look different from the default on this device.
|
|
|
1862 ;; If that doesn't work at all, then issue a warning.
|
|
|
1863 (unless (face-differs-from-default-p 'bold device)
|
|
|
1864 (make-face-bold 'bold device)
|
|
|
1865 (unless (face-differs-from-default-p 'bold device)
|
|
|
1866 (make-face-unbold 'bold device)
|
|
|
1867 (unless (face-differs-from-default-p 'bold device)
|
|
|
1868 ;; the luser specified one of the bogus font names
|
|
|
1869 (face-complain-about-font 'bold device))))
|
|
|
1870
|
|
|
1871 ;; Similar for italic.
|
|
|
1872 ;; It's unreasonable to expect to be able to make a font italic all
|
|
|
1873 ;; the time. For many languages, italic is an alien concept.
|
|
|
1874 ;; Basically, because italic is not a globally meaningful concept,
|
|
440
|
1875 ;; the use of the italic face should really be obsoleted.
|
|
428
|
1876
|
|
|
1877 ;; I disagree with above. In many languages, the concept of capital
|
|
|
1878 ;; letters is just as alien, and yet we use them. Italic is here to
|
|
|
1879 ;; stay. -hniksic
|
|
|
1880
|
|
|
1881 ;; In a Solaris Japanese environment, there just aren't any italic
|
|
|
1882 ;; fonts - period. CDE recognizes this reality, and fonts
|
|
|
1883 ;; -dt-interface user-medium-r-normal-*-*-*-*-*-*-*-*-* don't come
|
|
|
1884 ;; in italic versions. So we first try to make the font bold before
|
|
|
1885 ;; complaining.
|
|
|
1886 (unless (face-differs-from-default-p 'italic device)
|
|
|
1887 (make-face-italic 'italic device)
|
|
|
1888 (unless (face-differs-from-default-p 'italic device)
|
|
|
1889 (make-face-bold 'italic device)
|
|
|
1890 (unless (face-differs-from-default-p 'italic device)
|
|
|
1891 (face-complain-about-font 'italic device))))
|
|
|
1892
|
|
|
1893 ;; similar for bold-italic.
|
|
|
1894 (unless (face-differs-from-default-p 'bold-italic device)
|
|
|
1895 (make-face-bold-italic 'bold-italic device)
|
|
|
1896 ;; if we couldn't get a bold-italic version, try just bold.
|
|
|
1897 (unless (face-differs-from-default-p 'bold-italic device)
|
|
|
1898 (make-face-bold 'bold-italic device)
|
|
|
1899 ;; if we couldn't get bold or bold-italic, then that's probably because
|
|
|
1900 ;; the default font is bold, so make the `bold-italic' face be unbold.
|
|
|
1901 (unless (face-differs-from-default-p 'bold-italic device)
|
|
|
1902 (make-face-unbold 'bold-italic device)
|
|
|
1903 (make-face-italic 'bold-italic device)
|
|
|
1904 (unless (face-differs-from-default-p 'bold-italic device)
|
|
|
1905 ;; if that didn't work, try plain italic
|
|
|
1906 ;; (can this ever happen? what the hell.)
|
|
|
1907 (make-face-italic 'bold-italic device)
|
|
|
1908 (unless (face-differs-from-default-p 'bold-italic device)
|
|
|
1909 ;; then bitch and moan.
|
|
|
1910 (face-complain-about-font 'bold-italic device))))))
|
|
|
1911
|
|
|
1912 ;; Set the text-cursor colors unless already specified.
|
|
|
1913 (when (and (not (eq 'tty (device-type device)))
|
|
|
1914 (not (face-background 'text-cursor 'global))
|
|
|
1915 (face-property-equal 'text-cursor 'default 'background device))
|
|
|
1916 (set-face-background 'text-cursor [default foreground] 'global
|
|
|
1917 nil 'append))
|
|
|
1918 (when (and (not (eq 'tty (device-type device)))
|
|
|
1919 (not (face-foreground 'text-cursor 'global))
|
|
|
1920 (face-property-equal 'text-cursor 'default 'foreground device))
|
|
|
1921 (set-face-foreground 'text-cursor [default background] 'global
|
|
|
1922 nil 'append))
|
|
|
1923 )
|
|
|
1924
|
|
442
|
1925 ;; New function with 20.1, suggested by Per Abrahamsen, coded by Kyle
|
|
|
1926 ;; Jones and Hrvoje Niksic.
|
|
428
|
1927 (defun set-face-stipple (face pixmap &optional frame)
|
|
|
1928 "Change the stipple pixmap of FACE to PIXMAP.
|
|
|
1929 This is an Emacs compatibility function; consider using
|
|
|
1930 set-face-background-pixmap instead.
|
|
|
1931
|
|
|
1932 PIXMAP should be a string, the name of a file of pixmap data.
|
|
442
|
1933 The directories listed in the variables `x-bitmap-file-path' and
|
|
|
1934 `mswindows-bitmap-file-path' under X and MS Windows respectively
|
|
|
1935 are searched.
|
|
428
|
1936
|
|
|
1937 Alternatively, PIXMAP may be a list of the form (WIDTH HEIGHT
|
|
|
1938 DATA) where WIDTH and HEIGHT are the size in pixels, and DATA is
|
|
|
1939 a string, containing the raw bits of the bitmap. XBM data is
|
|
|
1940 expected in this case, other types of image data will not work.
|
|
|
1941
|
|
|
1942 If the optional FRAME argument is provided, change only
|
|
|
1943 in that frame; otherwise change each frame."
|
|
|
1944 (while (not (find-face face))
|
|
446
|
1945 (setq face (wrong-type-argument 'facep face)))
|
|
502
|
1946 (let ((bitmap-path
|
|
|
1947 (ecase (console-type)
|
|
|
1948 (x (declare-boundp x-bitmap-file-path))
|
|
|
1949 (mswindows (declare-boundp mswindows-bitmap-file-path))))
|
|
442
|
1950 instantiator)
|
|
|
1951 (while
|
|
|
1952 (null
|
|
|
1953 (setq instantiator
|
|
|
1954 (cond ((stringp pixmap)
|
|
|
1955 (let ((file (if (file-name-absolute-p pixmap)
|
|
|
1956 pixmap
|
|
|
1957 (locate-file pixmap bitmap-path
|
|
|
1958 '(".xbm" "")))))
|
|
|
1959 (and file
|
|
|
1960 `[xbm :file ,file])))
|
|
|
1961 ((and (listp pixmap) (= (length pixmap) 3))
|
|
|
1962 `[xbm :data ,pixmap])
|
|
|
1963 (t nil))))
|
|
|
1964 ;; We're signaling a continuable error; let's make sure the
|
|
|
1965 ;; function `stipple-pixmap-p' at least exists.
|
|
|
1966 (flet ((stipple-pixmap-p (pixmap)
|
|
|
1967 (or (stringp pixmap)
|
|
|
1968 (and (listp pixmap) (= (length pixmap) 3)))))
|
|
|
1969 (setq pixmap (signal 'wrong-type-argument
|
|
|
1970 (list 'stipple-pixmap-p pixmap)))))
|
|
446
|
1971 (check-type frame (or null frame))
|
|
442
|
1972 (set-face-background-pixmap face instantiator frame)))
|
|
428
|
1973
|
|
|
1974
|
|
|
1975 ;; Create the remaining standard faces now. This way, packages that we dump
|
|
|
1976 ;; can reference these faces as parents.
|
|
|
1977 ;;
|
|
|
1978 ;; The default, modeline, left-margin, right-margin, text-cursor,
|
|
|
1979 ;; and pointer faces are created in C.
|
|
|
1980
|
|
|
1981 (make-face 'bold "Bold text.")
|
|
|
1982 (make-face 'italic "Italic text.")
|
|
|
1983 (make-face 'bold-italic "Bold-italic text.")
|
|
|
1984 (make-face 'underline "Underlined text.")
|
|
|
1985 (or (face-differs-from-default-p 'underline)
|
|
|
1986 (set-face-underline-p 'underline t 'global '(default)))
|
|
735
|
1987 (make-face 'zmacs-region "Used on highlighted region between point and mark.")
|
|
428
|
1988 (make-face 'isearch "Used on region matched by isearch.")
|
|
|
1989 (make-face 'isearch-secondary "Face to use for highlighting all matches.")
|
|
|
1990 (make-face 'list-mode-item-selected
|
|
|
1991 "Face for the selected list item in list-mode.")
|
|
|
1992 (make-face 'highlight "Highlight face.")
|
|
|
1993 (make-face 'primary-selection "Primary selection face.")
|
|
|
1994 (make-face 'secondary-selection "Secondary selection face.")
|
|
|
1995
|
|
|
1996 ;; Several useful color faces.
|
|
|
1997 (dolist (color '(red green blue yellow))
|
|
|
1998 (make-face color (concat (symbol-name color) " text."))
|
|
|
1999 (set-face-foreground color (symbol-name color) nil 'color))
|
|
|
2000
|
|
|
2001 ;; Make some useful faces. This happens very early, before creating
|
|
|
2002 ;; the first non-stream device.
|
|
|
2003
|
|
|
2004 (set-face-background 'text-cursor
|
|
711
|
2005 '(((win default) . "Red3"))
|
|
428
|
2006 'global)
|
|
|
2007
|
|
|
2008 ;; some older X servers don't recognize "darkseagreen2"
|
|
|
2009 (set-face-background 'highlight
|
|
711
|
2010 '(((win default color) . "darkseagreen2")
|
|
|
2011 ((win default color) . "green")
|
|
|
2012 ((win default grayscale) . "gray53"))
|
|
428
|
2013 'global)
|
|
|
2014 (set-face-background-pixmap 'highlight
|
|
711
|
2015 '(((win default mono) . "gray1"))
|
|
428
|
2016 'global)
|
|
|
2017
|
|
|
2018 (set-face-background 'zmacs-region
|
|
711
|
2019 '(((win default color) . "gray65")
|
|
|
2020 ((win default grayscale) . "gray65"))
|
|
428
|
2021 'global)
|
|
|
2022 (set-face-background-pixmap 'zmacs-region
|
|
711
|
2023 '(((win default mono) . "gray3"))
|
|
428
|
2024 'global)
|
|
|
2025
|
|
|
2026 (set-face-background 'list-mode-item-selected
|
|
711
|
2027 '(((win default color) . "gray68")
|
|
|
2028 ((win default grayscale) . "gray68")
|
|
|
2029 ((win default mono) . [default foreground]))
|
|
428
|
2030 'global)
|
|
|
2031 (set-face-foreground 'list-mode-item-selected
|
|
711
|
2032 '(((win default mono) . [default background]))
|
|
428
|
2033 'global)
|
|
|
2034
|
|
|
2035 (set-face-background 'primary-selection
|
|
711
|
2036 '(((win default color) . "gray65")
|
|
|
2037 ((win default grayscale) . "gray65"))
|
|
428
|
2038 'global)
|
|
|
2039 (set-face-background-pixmap 'primary-selection
|
|
711
|
2040 '(((win default mono) . "gray3"))
|
|
428
|
2041 'global)
|
|
|
2042
|
|
|
2043 (set-face-background 'secondary-selection
|
|
711
|
2044 '(((win default color) . "paleturquoise")
|
|
|
2045 ((win default color) . "green")
|
|
|
2046 ((win default grayscale) . "gray53"))
|
|
428
|
2047 'global)
|
|
|
2048 (set-face-background-pixmap 'secondary-selection
|
|
711
|
2049 '(((win default mono) . "gray1"))
|
|
428
|
2050 'global)
|
|
|
2051
|
|
|
2052 (set-face-background 'isearch
|
|
711
|
2053 '(((win default color) . "paleturquoise")
|
|
|
2054 ((win default color) . "green"))
|
|
428
|
2055 'global)
|
|
|
2056
|
|
|
2057 ;; #### This should really, I mean *really*, be converted to some form
|
|
|
2058 ;; of `defface' one day.
|
|
|
2059 (set-face-foreground 'isearch-secondary
|
|
711
|
2060 '(((win default color) . "red3"))
|
|
428
|
2061 'global)
|
|
|
2062
|
|
|
2063 ;; Define some logical color names to be used when reading the pixmap files.
|
|
4222
|
2064 (and-boundp
|
|
|
2065 'xpm-color-symbols
|
|
|
2066 (featurep 'xpm)
|
|
|
2067 (setq xpm-color-symbols
|
|
|
2068 (list
|
|
|
2069 '("foreground" (face-foreground 'default))
|
|
|
2070 '("background" (face-background 'default))
|
|
|
2071 '("backgroundToolBarColor"
|
|
|
2072 (or
|
|
|
2073 (and
|
|
|
2074 (featurep 'x)
|
|
|
2075 (x-get-resource "backgroundToolBarColor"
|
|
|
2076 "BackgroundToolBarColor" 'string
|
|
|
2077 nil nil 'warn))
|
|
428
|
2078
|
|
4222
|
2079 (face-background 'toolbar)))
|
|
|
2080 '("foregroundToolBarColor"
|
|
|
2081 (or
|
|
|
2082 (and
|
|
|
2083 (featurep 'x)
|
|
|
2084 (x-get-resource "foregroundToolBarColor"
|
|
|
2085 "ForegroundToolBarColor" 'string
|
|
|
2086 nil nil 'warn))
|
|
|
2087 (face-foreground 'toolbar)))
|
|
|
2088 )))
|
|
428
|
2089
|
|
|
2090 (when (featurep 'tty)
|
|
|
2091 (set-face-highlight-p 'bold t 'global '(default tty))
|
|
|
2092 (set-face-underline-p 'italic t 'global '(default tty))
|
|
|
2093 (set-face-highlight-p 'bold-italic t 'global '(default tty))
|
|
|
2094 (set-face-underline-p 'bold-italic t 'global '(default tty))
|
|
|
2095 (set-face-highlight-p 'highlight t 'global '(default tty))
|
|
|
2096 (set-face-reverse-p 'text-cursor t 'global '(default tty))
|
|
|
2097 (set-face-reverse-p 'modeline t 'global '(default tty))
|
|
|
2098 (set-face-reverse-p 'zmacs-region t 'global '(default tty))
|
|
|
2099 (set-face-reverse-p 'primary-selection t 'global '(default tty))
|
|
|
2100 (set-face-underline-p 'secondary-selection t 'global '(default tty))
|
|
|
2101 (set-face-reverse-p 'list-mode-item-selected t 'global '(default tty))
|
|
|
2102 (set-face-reverse-p 'isearch t 'global '(default tty))
|
|
|
2103 )
|
|
|
2104
|
|
|
2105 ;;; faces.el ends here
|
