mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-11-26 07:33:47 +00:00
6d7132563c
* lisp/color.el (color-name-to-rgb): Rename from color-rgb->normalize. Autoload. Add optional arg FRAME, and pass it to color-values. (color-complement): Caller changed. Doc fix. (color-gradient): Rewrite for better clarity and efficiency. (color-rgb-to-hex): Rename from color-rgb->hex. (color-rgb-to-hsv): Rename from color-rgb->hsv. Force hue and saturation to zero if the value is too small. (color-rgb-to-hsl): Rename from color-rgb->hsl. (color-srgb-to-xyz): Rename from color-srgb->xyz. Doc fix. (color-xyz-to-srgb): Rename from color-xyz->srgb. Doc fix. (color-xyz-to-lab): Rename from color-xyz->lab. Doc fix. (color-lab-to-xyz): Rename from color-lab->xyz. Doc fix. (color-lab-to-srgb): Rename from color-lab->srgb. Doc fix. (color-cie-de2000): Doc fix. * lisp/facemenu.el (color-rgb-to-hsv): Deleted; use the version in lisp/color.el instead. (list-colors-sort-key, list-colors-print): Use color-normalized-values. * lisp/faces.el (color-values): Use cond for clarity. Doc fix. * lisp/gnus/shr-color.el (shr-color->hexadecimal): Use renamed function names color-rgb-to-hex, color-name-to-rgb, color-srgb-to-lab, and color-lab-to-srgb.
2607 lines
97 KiB
EmacsLisp
2607 lines
97 KiB
EmacsLisp
;;; faces.el --- Lisp faces
|
||
|
||
;; Copyright (C) 1992-1996, 1998-2011 Free Software Foundation, Inc.
|
||
|
||
;; Maintainer: FSF
|
||
;; Keywords: internal
|
||
;; Package: emacs
|
||
|
||
;; This file is part of GNU Emacs.
|
||
|
||
;; GNU Emacs is free software: you can redistribute it and/or modify
|
||
;; it under the terms of the GNU General Public License as published by
|
||
;; the Free Software Foundation, either version 3 of the License, or
|
||
;; (at your option) any later version.
|
||
|
||
;; GNU Emacs is distributed in the hope that it will be useful,
|
||
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;; GNU General Public License for more details.
|
||
|
||
;; You should have received a copy of the GNU General Public License
|
||
;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
;;; Commentary:
|
||
|
||
;;; Code:
|
||
|
||
(eval-when-compile
|
||
(require 'cl))
|
||
|
||
(declare-function xw-defined-colors "term/common-win" (&optional frame))
|
||
|
||
(defvar help-xref-stack-item)
|
||
|
||
(defvar face-name-history nil
|
||
"History list for some commands that read face names.
|
||
Maximum length of the history list is determined by the value
|
||
of `history-length', which see.")
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Font selection.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defgroup font-selection nil
|
||
"Influencing face font selection."
|
||
:group 'faces)
|
||
|
||
|
||
(defcustom face-font-selection-order
|
||
'(:width :height :weight :slant)
|
||
"A list specifying how face font selection chooses fonts.
|
||
Each of the four symbols `:width', `:height', `:weight', and `:slant'
|
||
must appear once in the list, and the list must not contain any other
|
||
elements. Font selection first tries to find a best matching font
|
||
for those face attributes that appear before in the list. For
|
||
example, if `:slant' appears before `:height', font selection first
|
||
tries to find a font with a suitable slant, even if this results in
|
||
a font height that isn't optimal."
|
||
:tag "Font selection order"
|
||
:type '(list symbol symbol symbol symbol)
|
||
:group 'font-selection
|
||
:set #'(lambda (symbol value)
|
||
(set-default symbol value)
|
||
(internal-set-font-selection-order value)))
|
||
|
||
|
||
;; In the absence of Fontconfig support, Monospace and Sans Serif are
|
||
;; unavailable, and we fall back on the courier and helv families,
|
||
;; which are generally available.
|
||
(defcustom face-font-family-alternatives
|
||
(mapcar (lambda (arg) (mapcar 'purecopy arg))
|
||
'(("Monospace" "courier" "fixed")
|
||
("courier" "CMU Typewriter Text" "fixed")
|
||
("Sans Serif" "helv" "helvetica" "arial" "fixed")
|
||
("helv" "helvetica" "arial" "fixed")))
|
||
"Alist of alternative font family names.
|
||
Each element has the form (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...).
|
||
If fonts of family FAMILY can't be loaded, try ALTERNATIVE1, then
|
||
ALTERNATIVE2 etc."
|
||
:tag "Alternative font families to try"
|
||
:type '(repeat (repeat string))
|
||
:group 'font-selection
|
||
:set #'(lambda (symbol value)
|
||
(set-default symbol value)
|
||
(internal-set-alternative-font-family-alist value)))
|
||
|
||
|
||
;; This is defined originally in xfaces.c.
|
||
(defcustom face-font-registry-alternatives
|
||
(mapcar (lambda (arg) (mapcar 'purecopy arg))
|
||
(if (eq system-type 'windows-nt)
|
||
'(("iso8859-1" "ms-oemlatin")
|
||
("gb2312.1980" "gb2312" "gbk" "gb18030")
|
||
("jisx0208.1990" "jisx0208.1983" "jisx0208.1978")
|
||
("ksc5601.1989" "ksx1001.1992" "ksc5601.1987")
|
||
("muletibetan-2" "muletibetan-0"))
|
||
'(("gb2312.1980" "gb2312.80&gb8565.88" "gbk" "gb18030")
|
||
("jisx0208.1990" "jisx0208.1983" "jisx0208.1978")
|
||
("ksc5601.1989" "ksx1001.1992" "ksc5601.1987")
|
||
("muletibetan-2" "muletibetan-0"))))
|
||
"Alist of alternative font registry names.
|
||
Each element has the form (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...).
|
||
If fonts of registry REGISTRY can be loaded, font selection
|
||
tries to find a best matching font among all fonts of registry
|
||
REGISTRY, ALTERNATIVE1, ALTERNATIVE2, and etc."
|
||
:tag "Alternative font registries to try"
|
||
:type '(repeat (repeat string))
|
||
:version "21.1"
|
||
:group 'font-selection
|
||
:set #'(lambda (symbol value)
|
||
(set-default symbol value)
|
||
(internal-set-alternative-font-registry-alist value)))
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Creation, copying.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
|
||
(defun face-list ()
|
||
"Return a list of all defined face names."
|
||
(mapcar #'car face-new-frame-defaults))
|
||
|
||
|
||
;;; ### If not frame-local initialize by what X resources?
|
||
|
||
(defun make-face (face &optional no-init-from-resources)
|
||
"Define a new face with name FACE, a symbol.
|
||
NO-INIT-FROM-RESOURCES non-nil means don't initialize frame-local
|
||
variants of FACE from X resources. (X resources recognized are found
|
||
in the global variable `face-x-resources'.) If FACE is already known
|
||
as a face, leave it unmodified. Value is FACE."
|
||
(interactive (list (read-from-minibuffer
|
||
"Make face: " nil nil t 'face-name-history)))
|
||
(unless (facep face)
|
||
;; Make frame-local faces (this also makes the global one).
|
||
(dolist (frame (frame-list))
|
||
(internal-make-lisp-face face frame))
|
||
;; Add the face to the face menu.
|
||
(when (fboundp 'facemenu-add-new-face)
|
||
(facemenu-add-new-face face))
|
||
;; Define frame-local faces for all frames from X resources.
|
||
(unless no-init-from-resources
|
||
(make-face-x-resource-internal face)))
|
||
face)
|
||
|
||
|
||
(defun make-empty-face (face)
|
||
"Define a new, empty face with name FACE.
|
||
If the face already exists, it is left unmodified. Value is FACE."
|
||
(interactive (list (read-from-minibuffer
|
||
"Make empty face: " nil nil t 'face-name-history)))
|
||
(make-face face 'no-init-from-resources))
|
||
|
||
|
||
(defun copy-face (old-face new-face &optional frame new-frame)
|
||
"Define a face just like OLD-FACE, with name NEW-FACE.
|
||
|
||
If NEW-FACE already exists as a face, it is modified to be like
|
||
OLD-FACE. If it doesn't already exist, it is created.
|
||
|
||
If the optional argument FRAME is given as a frame, NEW-FACE is
|
||
changed on FRAME only.
|
||
If FRAME is t, the frame-independent default specification for OLD-FACE
|
||
is copied to NEW-FACE.
|
||
If FRAME is nil, copying is done for the frame-independent defaults
|
||
and for each existing frame.
|
||
|
||
If the optional fourth argument NEW-FRAME is given,
|
||
copy the information from face OLD-FACE on frame FRAME
|
||
to NEW-FACE on frame NEW-FRAME. In this case, FRAME may not be nil."
|
||
(let ((inhibit-quit t))
|
||
(if (null frame)
|
||
(progn
|
||
(when new-frame
|
||
(error "Copying face %s from all frames to one frame"
|
||
old-face))
|
||
(make-empty-face new-face)
|
||
(dolist (frame (frame-list))
|
||
(copy-face old-face new-face frame))
|
||
(copy-face old-face new-face t))
|
||
(make-empty-face new-face)
|
||
(internal-copy-lisp-face old-face new-face frame new-frame))
|
||
new-face))
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Predicates, type checks.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defun facep (face)
|
||
"Return non-nil if FACE is a face name; nil otherwise.
|
||
A face name can be a string or a symbol."
|
||
(internal-lisp-face-p face))
|
||
|
||
|
||
(defun check-face (face)
|
||
"Signal an error if FACE doesn't name a face.
|
||
Value is FACE."
|
||
(unless (facep face)
|
||
(error "Not a face: %s" face))
|
||
face)
|
||
|
||
|
||
;; The ID returned is not to be confused with the internally used IDs
|
||
;; of realized faces. The ID assigned to Lisp faces is used to
|
||
;; support faces in display table entries.
|
||
|
||
(defun face-id (face &optional frame)
|
||
"Return the internal ID of face with name FACE.
|
||
If FACE is a face-alias, return the ID of the target face.
|
||
The optional argument FRAME is ignored, since the internal face ID
|
||
of a face name is the same for all frames."
|
||
(check-face face)
|
||
(or (get face 'face)
|
||
(face-id (get face 'face-alias))))
|
||
|
||
(defun face-equal (face1 face2 &optional frame)
|
||
"Non-nil if faces FACE1 and FACE2 are equal.
|
||
Faces are considered equal if all their attributes are equal.
|
||
If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
|
||
If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame."
|
||
(internal-lisp-face-equal-p face1 face2 frame))
|
||
|
||
|
||
(defun face-differs-from-default-p (face &optional frame)
|
||
"Return non-nil if FACE displays differently from the default face.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame."
|
||
(let ((attrs
|
||
(delq :inherit (mapcar 'car face-attribute-name-alist)))
|
||
(differs nil))
|
||
(while (and attrs (not differs))
|
||
(let* ((attr (pop attrs))
|
||
(attr-val (face-attribute face attr frame t)))
|
||
(when (and
|
||
(not (eq attr-val 'unspecified))
|
||
(display-supports-face-attributes-p (list attr attr-val)
|
||
frame))
|
||
(setq differs attr))))
|
||
differs))
|
||
|
||
|
||
(defun face-nontrivial-p (face &optional frame)
|
||
"True if face FACE has some non-nil attribute.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame."
|
||
(not (internal-lisp-face-empty-p face frame)))
|
||
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Setting face attributes from X resources.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defcustom face-x-resources
|
||
(mapcar
|
||
(lambda (arg)
|
||
;; FIXME; can we purecopy some of the conses too?
|
||
(cons (car arg)
|
||
(cons (purecopy (car (cdr arg))) (purecopy (cdr (cdr arg))))))
|
||
'((:family (".attributeFamily" . "Face.AttributeFamily"))
|
||
(:foundry (".attributeFoundry" . "Face.AttributeFoundry"))
|
||
(:width (".attributeWidth" . "Face.AttributeWidth"))
|
||
(:height (".attributeHeight" . "Face.AttributeHeight"))
|
||
(:weight (".attributeWeight" . "Face.AttributeWeight"))
|
||
(:slant (".attributeSlant" . "Face.AttributeSlant"))
|
||
(:foreground (".attributeForeground" . "Face.AttributeForeground"))
|
||
(:background (".attributeBackground" . "Face.AttributeBackground"))
|
||
(:overline (".attributeOverline" . "Face.AttributeOverline"))
|
||
(:strike-through (".attributeStrikeThrough" . "Face.AttributeStrikeThrough"))
|
||
(:box (".attributeBox" . "Face.AttributeBox"))
|
||
(:underline (".attributeUnderline" . "Face.AttributeUnderline"))
|
||
(:inverse-video (".attributeInverse" . "Face.AttributeInverse"))
|
||
(:stipple
|
||
(".attributeStipple" . "Face.AttributeStipple")
|
||
(".attributeBackgroundPixmap" . "Face.AttributeBackgroundPixmap"))
|
||
(:bold (".attributeBold" . "Face.AttributeBold"))
|
||
(:italic (".attributeItalic" . "Face.AttributeItalic"))
|
||
(:font (".attributeFont" . "Face.AttributeFont"))
|
||
(:inherit (".attributeInherit" . "Face.AttributeInherit"))))
|
||
"List of X resources and classes for face attributes.
|
||
Each element has the form (ATTRIBUTE ENTRY1 ENTRY2...) where ATTRIBUTE is
|
||
the name of a face attribute, and each ENTRY is a cons of the form
|
||
\(RESOURCE . CLASS) with RESOURCE being the resource and CLASS being the
|
||
X resource class for the attribute."
|
||
:type '(repeat (cons symbol (repeat (cons string string))))
|
||
:group 'faces)
|
||
|
||
|
||
(declare-function internal-face-x-get-resource "xfaces.c"
|
||
(resource class frame))
|
||
|
||
(declare-function internal-set-lisp-face-attribute-from-resource "xfaces.c"
|
||
(face attr value &optional frame))
|
||
|
||
(defun set-face-attribute-from-resource (face attribute resource class frame)
|
||
"Set FACE's ATTRIBUTE from X resource RESOURCE, class CLASS on FRAME.
|
||
Value is the attribute value specified by the resource, or nil
|
||
if not present. This function displays a message if the resource
|
||
specifies an invalid attribute."
|
||
(let* ((face-name (face-name face))
|
||
(value (internal-face-x-get-resource (concat face-name resource)
|
||
class frame)))
|
||
(when value
|
||
(condition-case ()
|
||
(internal-set-lisp-face-attribute-from-resource
|
||
face attribute (downcase value) frame)
|
||
(error
|
||
(message "Face %s, frame %s: invalid attribute %s %s from X resource"
|
||
face-name frame attribute value))))
|
||
value))
|
||
|
||
|
||
(defun set-face-attributes-from-resources (face frame)
|
||
"Set attributes of FACE from X resources for FRAME."
|
||
(when (memq (framep frame) '(x w32))
|
||
(dolist (definition face-x-resources)
|
||
(let ((attribute (car definition)))
|
||
(dolist (entry (cdr definition))
|
||
(set-face-attribute-from-resource face attribute (car entry)
|
||
(cdr entry) frame))))))
|
||
|
||
|
||
(defun make-face-x-resource-internal (face &optional frame)
|
||
"Fill frame-local FACE on FRAME from X resources.
|
||
FRAME nil or not specified means do it for all frames."
|
||
(if (null frame)
|
||
(dolist (frame (frame-list))
|
||
(set-face-attributes-from-resources face frame))
|
||
(set-face-attributes-from-resources face frame)))
|
||
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Retrieving face attributes.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defun face-name (face)
|
||
"Return the name of face FACE."
|
||
(symbol-name (check-face face)))
|
||
|
||
|
||
(defun face-all-attributes (face &optional frame)
|
||
"Return an alist stating the attributes of FACE.
|
||
Each element of the result has the form (ATTR-NAME . ATTR-VALUE).
|
||
If FRAME is omitted or nil the value describes the default attributes,
|
||
but if you specify FRAME, the value describes the attributes
|
||
of FACE on FRAME."
|
||
(mapcar (lambda (pair)
|
||
(let ((attr (car pair)))
|
||
(cons attr (face-attribute face attr (or frame t)))))
|
||
face-attribute-name-alist))
|
||
|
||
(defun face-attribute (face attribute &optional frame inherit)
|
||
"Return the value of FACE's ATTRIBUTE on FRAME.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
|
||
If INHERIT is nil, only attributes directly defined by FACE are considered,
|
||
so the return value may be `unspecified', or a relative value.
|
||
If INHERIT is non-nil, FACE's definition of ATTRIBUTE is merged with the
|
||
faces specified by its `:inherit' attribute; however the return value
|
||
may still be `unspecified' or relative.
|
||
If INHERIT is a face or a list of faces, then the result is further merged
|
||
with that face (or faces), until it becomes specified and absolute.
|
||
|
||
To ensure that the return value is always specified and absolute, use a
|
||
value of `default' for INHERIT; this will resolve any unspecified or
|
||
relative values by merging with the `default' face (which is always
|
||
completely specified)."
|
||
(let ((value (internal-get-lisp-face-attribute face attribute frame)))
|
||
(when (and inherit (face-attribute-relative-p attribute value))
|
||
;; VALUE is relative, so merge with inherited faces
|
||
(let ((inh-from (face-attribute face :inherit frame)))
|
||
(unless (or (null inh-from) (eq inh-from 'unspecified))
|
||
(condition-case nil
|
||
(setq value
|
||
(face-attribute-merged-with attribute value inh-from frame))
|
||
;; The `inherit' attribute may point to non existent faces.
|
||
(error nil)))))
|
||
(when (and inherit
|
||
(not (eq inherit t))
|
||
(face-attribute-relative-p attribute value))
|
||
;; We should merge with INHERIT as well
|
||
(setq value (face-attribute-merged-with attribute value inherit frame)))
|
||
value))
|
||
|
||
(defun face-attribute-merged-with (attribute value faces &optional frame)
|
||
"Merges ATTRIBUTE, initially VALUE, with faces from FACES until absolute.
|
||
FACES may be either a single face or a list of faces.
|
||
\[This is an internal function.]"
|
||
(cond ((not (face-attribute-relative-p attribute value))
|
||
value)
|
||
((null faces)
|
||
value)
|
||
((consp faces)
|
||
(face-attribute-merged-with
|
||
attribute
|
||
(face-attribute-merged-with attribute value (car faces) frame)
|
||
(cdr faces)
|
||
frame))
|
||
(t
|
||
(merge-face-attribute attribute
|
||
value
|
||
(face-attribute faces attribute frame t)))))
|
||
|
||
|
||
(defmacro face-attribute-specified-or (value &rest body)
|
||
"Return VALUE, unless it's `unspecified', in which case evaluate BODY and return the result."
|
||
(let ((temp (make-symbol "value")))
|
||
`(let ((,temp ,value))
|
||
(if (not (eq ,temp 'unspecified))
|
||
,temp
|
||
,@body))))
|
||
|
||
(defun face-foreground (face &optional frame inherit)
|
||
"Return the foreground color name of FACE, or nil if unspecified.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
|
||
If INHERIT is nil, only a foreground color directly defined by FACE is
|
||
considered, so the return value may be nil.
|
||
If INHERIT is t, and FACE doesn't define a foreground color, then any
|
||
foreground color that FACE inherits through its `:inherit' attribute
|
||
is considered as well; however the return value may still be nil.
|
||
If INHERIT is a face or a list of faces, then it is used to try to
|
||
resolve an unspecified foreground color.
|
||
|
||
To ensure that a valid color is always returned, use a value of
|
||
`default' for INHERIT; this will resolve any unspecified values by
|
||
merging with the `default' face (which is always completely specified)."
|
||
(face-attribute-specified-or (face-attribute face :foreground frame inherit)
|
||
nil))
|
||
|
||
(defun face-background (face &optional frame inherit)
|
||
"Return the background color name of FACE, or nil if unspecified.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
|
||
If INHERIT is nil, only a background color directly defined by FACE is
|
||
considered, so the return value may be nil.
|
||
If INHERIT is t, and FACE doesn't define a background color, then any
|
||
background color that FACE inherits through its `:inherit' attribute
|
||
is considered as well; however the return value may still be nil.
|
||
If INHERIT is a face or a list of faces, then it is used to try to
|
||
resolve an unspecified background color.
|
||
|
||
To ensure that a valid color is always returned, use a value of
|
||
`default' for INHERIT; this will resolve any unspecified values by
|
||
merging with the `default' face (which is always completely specified)."
|
||
(face-attribute-specified-or (face-attribute face :background frame inherit)
|
||
nil))
|
||
|
||
(defun face-stipple (face &optional frame inherit)
|
||
"Return the stipple pixmap name of FACE, or nil if unspecified.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
|
||
If INHERIT is nil, only a stipple directly defined by FACE is
|
||
considered, so the return value may be nil.
|
||
If INHERIT is t, and FACE doesn't define a stipple, then any stipple
|
||
that FACE inherits through its `:inherit' attribute is considered as
|
||
well; however the return value may still be nil.
|
||
If INHERIT is a face or a list of faces, then it is used to try to
|
||
resolve an unspecified stipple.
|
||
|
||
To ensure that a valid stipple or nil is always returned, use a value of
|
||
`default' for INHERIT; this will resolve any unspecified values by merging
|
||
with the `default' face (which is always completely specified)."
|
||
(face-attribute-specified-or (face-attribute face :stipple frame inherit)
|
||
nil))
|
||
|
||
|
||
(defalias 'face-background-pixmap 'face-stipple)
|
||
|
||
|
||
(defun face-underline-p (face &optional frame)
|
||
"Return non-nil if FACE is underlined.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame."
|
||
(eq (face-attribute face :underline frame) t))
|
||
|
||
|
||
(defun face-inverse-video-p (face &optional frame)
|
||
"Return non-nil if FACE is in inverse video on FRAME.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame."
|
||
(eq (face-attribute face :inverse-video frame) t))
|
||
|
||
|
||
(defun face-bold-p (face &optional frame)
|
||
"Return non-nil if the font of FACE is bold on FRAME.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
Use `face-attribute' for finer control."
|
||
(let ((bold (face-attribute face :weight frame)))
|
||
(memq bold '(semi-bold bold extra-bold ultra-bold))))
|
||
|
||
|
||
(defun face-italic-p (face &optional frame)
|
||
"Return non-nil if the font of FACE is italic on FRAME.
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
Use `face-attribute' for finer control."
|
||
(let ((italic (face-attribute face :slant frame)))
|
||
(memq italic '(italic oblique))))
|
||
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Face documentation.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defun face-documentation (face)
|
||
"Get the documentation string for FACE.
|
||
If FACE is a face-alias, get the documentation for the target face."
|
||
(let ((alias (get face 'face-alias))
|
||
doc)
|
||
(if alias
|
||
(progn
|
||
(setq doc (get alias 'face-documentation))
|
||
(format "%s is an alias for the face `%s'.%s" face alias
|
||
(if doc (format "\n%s" doc)
|
||
"")))
|
||
(get face 'face-documentation))))
|
||
|
||
|
||
(defun set-face-documentation (face string)
|
||
"Set the documentation string for FACE to STRING."
|
||
;; Perhaps the text should go in DOC.
|
||
(put face 'face-documentation (purecopy string)))
|
||
|
||
|
||
(defalias 'face-doc-string 'face-documentation)
|
||
(defalias 'set-face-doc-string 'set-face-documentation)
|
||
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;; Setting face attributes.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
|
||
(defun set-face-attribute (face frame &rest args)
|
||
"Set attributes of FACE on FRAME from ARGS.
|
||
|
||
FRAME nil means change attributes on all frames. FRAME t means change
|
||
the default for new frames (this is done automatically each time an
|
||
attribute is changed on all frames).
|
||
|
||
ARGS must come in pairs ATTRIBUTE VALUE. ATTRIBUTE must be a valid
|
||
face attribute name. All attributes can be set to `unspecified';
|
||
this fact is not further mentioned below.
|
||
|
||
The following attributes are recognized:
|
||
|
||
`:family'
|
||
|
||
VALUE must be a string specifying the font family, e.g. ``monospace'',
|
||
or a fontset alias name. If a font family is specified, wild-cards `*'
|
||
and `?' are allowed.
|
||
|
||
`:foundry'
|
||
|
||
VALUE must be a string specifying the font foundry,
|
||
e.g. ``adobe''. If a font foundry is specified, wild-cards `*'
|
||
and `?' are allowed.
|
||
|
||
`:width'
|
||
|
||
VALUE specifies the relative proportionate width of the font to use.
|
||
It must be one of the symbols `ultra-condensed', `extra-condensed',
|
||
`condensed', `semi-condensed', `normal', `semi-expanded', `expanded',
|
||
`extra-expanded', or `ultra-expanded'.
|
||
|
||
`:height'
|
||
|
||
VALUE specifies the height of the font, in either absolute or relative
|
||
terms. An absolute height is an integer, and specifies font height in
|
||
units of 1/10 pt. A relative height is either a floating point number,
|
||
which specifies a scaling factor for the underlying face height;
|
||
or a function that takes a single argument (the underlying face height)
|
||
and returns the new height. Note that for the `default' face,
|
||
you can only specify an absolute height (since there is nothing
|
||
for it to be relative to).
|
||
|
||
`:weight'
|
||
|
||
VALUE specifies the weight of the font to use. It must be one of the
|
||
symbols `ultra-bold', `extra-bold', `bold', `semi-bold', `normal',
|
||
`semi-light', `light', `extra-light', `ultra-light'.
|
||
|
||
`:slant'
|
||
|
||
VALUE specifies the slant of the font to use. It must be one of the
|
||
symbols `italic', `oblique', `normal', `reverse-italic', or
|
||
`reverse-oblique'.
|
||
|
||
`:foreground', `:background'
|
||
|
||
VALUE must be a color name, a string.
|
||
|
||
`:underline'
|
||
|
||
VALUE specifies whether characters in FACE should be underlined. If
|
||
VALUE is t, underline with foreground color of the face. If VALUE is
|
||
a string, underline with that color. If VALUE is nil, explicitly
|
||
don't underline.
|
||
|
||
`:overline'
|
||
|
||
VALUE specifies whether characters in FACE should be overlined. If
|
||
VALUE is t, overline with foreground color of the face. If VALUE is a
|
||
string, overline with that color. If VALUE is nil, explicitly don't
|
||
overline.
|
||
|
||
`:strike-through'
|
||
|
||
VALUE specifies whether characters in FACE should be drawn with a line
|
||
striking through them. If VALUE is t, use the foreground color of the
|
||
face. If VALUE is a string, strike-through with that color. If VALUE
|
||
is nil, explicitly don't strike through.
|
||
|
||
`:box'
|
||
|
||
VALUE specifies whether characters in FACE should have a box drawn
|
||
around them. If VALUE is nil, explicitly don't draw boxes. If
|
||
VALUE is t, draw a box with lines of width 1 in the foreground color
|
||
of the face. If VALUE is a string, the string must be a color name,
|
||
and the box is drawn in that color with a line width of 1. Otherwise,
|
||
VALUE must be a property list of the form `(:line-width WIDTH
|
||
:color COLOR :style STYLE)'. If a keyword/value pair is missing from
|
||
the property list, a default value will be used for the value, as
|
||
specified below. WIDTH specifies the width of the lines to draw; it
|
||
defaults to 1. If WIDTH is negative, the absolute value is the width
|
||
of the lines, and draw top/bottom lines inside the characters area,
|
||
not around it. COLOR is the name of the color to draw in, default is
|
||
the foreground color of the face for simple boxes, and the background
|
||
color of the face for 3D boxes. STYLE specifies whether a 3D box
|
||
should be draw. If STYLE is `released-button', draw a box looking
|
||
like a released 3D button. If STYLE is `pressed-button' draw a box
|
||
that appears like a pressed button. If STYLE is nil, the default if
|
||
the property list doesn't contain a style specification, draw a 2D
|
||
box.
|
||
|
||
`:inverse-video'
|
||
|
||
VALUE specifies whether characters in FACE should be displayed in
|
||
inverse video. VALUE must be one of t or nil.
|
||
|
||
`:stipple'
|
||
|
||
If VALUE is a string, it must be the name of a file of pixmap data.
|
||
The directories listed in the `x-bitmap-file-path' variable are
|
||
searched. Alternatively, VALUE may be a list of the form (WIDTH
|
||
HEIGHT DATA) where WIDTH and HEIGHT are the size in pixels, and DATA
|
||
is a string containing the raw bits of the bitmap. VALUE nil means
|
||
explicitly don't use a stipple pattern.
|
||
|
||
For convenience, attributes `:family', `:foundry', `:width',
|
||
`:height', `:weight', and `:slant' may also be set in one step
|
||
from an X font name:
|
||
|
||
`:font'
|
||
|
||
Set font-related face attributes from VALUE. VALUE must be a valid
|
||
XLFD font name. If it is a font name pattern, the first matching font
|
||
will be used.
|
||
|
||
For compatibility with Emacs 20, keywords `:bold' and `:italic' can
|
||
be used to specify that a bold or italic font should be used. VALUE
|
||
must be t or nil in that case. A value of `unspecified' is not allowed.
|
||
|
||
`:inherit'
|
||
|
||
VALUE is the name of a face from which to inherit attributes, or a list
|
||
of face names. Attributes from inherited faces are merged into the face
|
||
like an underlying face would be, with higher priority than underlying faces."
|
||
(setq args (purecopy args))
|
||
(let ((where (if (null frame) 0 frame))
|
||
(spec args)
|
||
family foundry)
|
||
;; If we set the new-frame defaults, this face is modified outside Custom.
|
||
(if (memq where '(0 t))
|
||
(put (or (get face 'face-alias) face) 'face-modified t))
|
||
;; If family and/or foundry are specified, set it first. Certain
|
||
;; face attributes, e.g. :weight semi-condensed, are not supported
|
||
;; in every font. See bug#1127.
|
||
(while spec
|
||
(cond ((eq (car spec) :family)
|
||
(setq family (cadr spec)))
|
||
((eq (car spec) :foundry)
|
||
(setq foundry (cadr spec))))
|
||
(setq spec (cddr spec)))
|
||
(when (or family foundry)
|
||
(when (and (stringp family)
|
||
(string-match "\\([^-]*\\)-\\([^-]*\\)" family))
|
||
(unless foundry
|
||
(setq foundry (match-string 1 family)))
|
||
(setq family (match-string 2 family)))
|
||
(when (or (stringp family) (eq family 'unspecified))
|
||
(internal-set-lisp-face-attribute face :family (purecopy family)
|
||
where))
|
||
(when (or (stringp foundry) (eq foundry 'unspecified))
|
||
(internal-set-lisp-face-attribute face :foundry (purecopy foundry)
|
||
where)))
|
||
(while args
|
||
(unless (memq (car args) '(:family :foundry))
|
||
(internal-set-lisp-face-attribute face (car args)
|
||
(purecopy (cadr args))
|
||
where))
|
||
(setq args (cddr args)))))
|
||
|
||
(defun make-face-bold (face &optional frame noerror)
|
||
"Make the font of FACE be bold, if possible.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Argument NOERROR is ignored and retained for compatibility.
|
||
Use `set-face-attribute' for finer control of the font weight."
|
||
(interactive (list (read-face-name "Make which face bold")))
|
||
(set-face-attribute face frame :weight 'bold))
|
||
|
||
|
||
(defun make-face-unbold (face &optional frame noerror)
|
||
"Make the font of FACE be non-bold, if possible.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Argument NOERROR is ignored and retained for compatibility."
|
||
(interactive (list (read-face-name "Make which face non-bold")))
|
||
(set-face-attribute face frame :weight 'normal))
|
||
|
||
|
||
(defun make-face-italic (face &optional frame noerror)
|
||
"Make the font of FACE be italic, if possible.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Argument NOERROR is ignored and retained for compatibility.
|
||
Use `set-face-attribute' for finer control of the font slant."
|
||
(interactive (list (read-face-name "Make which face italic")))
|
||
(set-face-attribute face frame :slant 'italic))
|
||
|
||
|
||
(defun make-face-unitalic (face &optional frame noerror)
|
||
"Make the font of FACE be non-italic, if possible.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Argument NOERROR is ignored and retained for compatibility."
|
||
(interactive (list (read-face-name "Make which face non-italic")))
|
||
(set-face-attribute face frame :slant 'normal))
|
||
|
||
|
||
(defun make-face-bold-italic (face &optional frame noerror)
|
||
"Make the font of FACE be bold and italic, if possible.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Argument NOERROR is ignored and retained for compatibility.
|
||
Use `set-face-attribute' for finer control of font weight and slant."
|
||
(interactive (list (read-face-name "Make which face bold-italic")))
|
||
(set-face-attribute face frame :weight 'bold :slant 'italic))
|
||
|
||
|
||
(defun set-face-font (face font &optional frame)
|
||
"Change font-related attributes of FACE to those of FONT (a string).
|
||
FRAME nil or not specified means change face on all frames.
|
||
This sets the attributes `:family', `:foundry', `:width',
|
||
`:height', `:weight', and `:slant'. When called interactively,
|
||
prompt for the face and font."
|
||
(interactive (read-face-and-attribute :font))
|
||
(set-face-attribute face frame :font font))
|
||
|
||
|
||
;; Implementation note: Emulating gray background colors with a
|
||
;; stipple pattern is now part of the face realization process, and is
|
||
;; done in C depending on the frame on which the face is realized.
|
||
|
||
(defun set-face-background (face color &optional frame)
|
||
"Change the background color of face FACE to COLOR (a string).
|
||
FRAME nil or not specified means change face on all frames.
|
||
COLOR can be a system-defined color name (see `list-colors-display')
|
||
or a hex spec of the form #RRGGBB.
|
||
When called interactively, prompts for the face and color."
|
||
(interactive (read-face-and-attribute :background))
|
||
(set-face-attribute face frame :background (or color 'unspecified)))
|
||
|
||
|
||
(defun set-face-foreground (face color &optional frame)
|
||
"Change the foreground color of face FACE to COLOR (a string).
|
||
FRAME nil or not specified means change face on all frames.
|
||
COLOR can be a system-defined color name (see `list-colors-display')
|
||
or a hex spec of the form #RRGGBB.
|
||
When called interactively, prompts for the face and color."
|
||
(interactive (read-face-and-attribute :foreground))
|
||
(set-face-attribute face frame :foreground (or color 'unspecified)))
|
||
|
||
|
||
(defun set-face-stipple (face stipple &optional frame)
|
||
"Change the stipple pixmap of face FACE to STIPPLE.
|
||
FRAME nil or not specified means change face on all frames.
|
||
STIPPLE should be a string, the name of a file of pixmap data.
|
||
The directories listed in the `x-bitmap-file-path' variable are searched.
|
||
|
||
Alternatively, STIPPLE may be a list of the form (WIDTH HEIGHT DATA)
|
||
where WIDTH and HEIGHT are the size in pixels,
|
||
and DATA is a string, containing the raw bits of the bitmap."
|
||
(interactive (read-face-and-attribute :stipple))
|
||
(set-face-attribute face frame :stipple (or stipple 'unspecified)))
|
||
|
||
|
||
(defun set-face-underline-p (face underline &optional frame)
|
||
"Specify whether face FACE is underlined.
|
||
UNDERLINE nil means FACE explicitly doesn't underline.
|
||
UNDERLINE non-nil means FACE explicitly does underlining
|
||
with the same of the foreground color.
|
||
If UNDERLINE is a string, underline with the color named UNDERLINE.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Use `set-face-attribute' to ``unspecify'' underlining."
|
||
(interactive
|
||
(let ((list (read-face-and-attribute :underline)))
|
||
(list (car list) (eq (car (cdr list)) t))))
|
||
(set-face-attribute face frame :underline underline))
|
||
|
||
(define-obsolete-function-alias 'set-face-underline
|
||
'set-face-underline-p "22.1")
|
||
|
||
|
||
(defun set-face-inverse-video-p (face inverse-video-p &optional frame)
|
||
"Specify whether face FACE is in inverse video.
|
||
INVERSE-VIDEO-P non-nil means FACE displays explicitly in inverse video.
|
||
INVERSE-VIDEO-P nil means FACE explicitly is not in inverse video.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Use `set-face-attribute' to ``unspecify'' the inverse video attribute."
|
||
(interactive
|
||
(let ((list (read-face-and-attribute :inverse-video)))
|
||
(list (car list) (eq (car (cdr list)) t))))
|
||
(set-face-attribute face frame :inverse-video inverse-video-p))
|
||
|
||
|
||
(defun set-face-bold-p (face bold-p &optional frame)
|
||
"Specify whether face FACE is bold.
|
||
BOLD-P non-nil means FACE should explicitly display bold.
|
||
BOLD-P nil means FACE should explicitly display non-bold.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Use `set-face-attribute' or `modify-face' for finer control."
|
||
(if (null bold-p)
|
||
(make-face-unbold face frame)
|
||
(make-face-bold face frame)))
|
||
|
||
|
||
(defun set-face-italic-p (face italic-p &optional frame)
|
||
"Specify whether face FACE is italic.
|
||
ITALIC-P non-nil means FACE should explicitly display italic.
|
||
ITALIC-P nil means FACE should explicitly display non-italic.
|
||
FRAME nil or not specified means change face on all frames.
|
||
Use `set-face-attribute' or `modify-face' for finer control."
|
||
(if (null italic-p)
|
||
(make-face-unitalic face frame)
|
||
(make-face-italic face frame)))
|
||
|
||
|
||
(defalias 'set-face-background-pixmap 'set-face-stipple)
|
||
|
||
|
||
(defun invert-face (face &optional frame)
|
||
"Swap the foreground and background colors of FACE.
|
||
If FRAME is omitted or nil, it means change face on all frames.
|
||
If FACE specifies neither foreground nor background color,
|
||
set its foreground and background to the background and foreground
|
||
of the default face. Value is FACE."
|
||
(interactive (list (read-face-name "Invert face")))
|
||
(let ((fg (face-attribute face :foreground frame))
|
||
(bg (face-attribute face :background frame)))
|
||
(if (not (and (eq fg 'unspecified) (eq bg 'unspecified)))
|
||
(set-face-attribute face frame :foreground bg :background fg)
|
||
(set-face-attribute face frame
|
||
:foreground
|
||
(face-attribute 'default :background frame)
|
||
:background
|
||
(face-attribute 'default :foreground frame))))
|
||
face)
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Interactively modifying faces.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defun read-face-name (prompt &optional default multiple)
|
||
"Read a face, defaulting to the face or faces on the char after point.
|
||
If it has the property `read-face-name', that overrides the `face' property.
|
||
PROMPT should be a string that describes what the caller will do with the face;
|
||
it should not end in a space.
|
||
The optional argument DEFAULT provides the value to display in the
|
||
minibuffer prompt that is returned if the user just types RET
|
||
unless DEFAULT is a string (in which case nil is returned).
|
||
If MULTIPLE is non-nil, return a list of faces (possibly only one).
|
||
Otherwise, return a single face."
|
||
(let ((faceprop (or (get-char-property (point) 'read-face-name)
|
||
(get-char-property (point) 'face)))
|
||
(aliasfaces nil)
|
||
(nonaliasfaces nil)
|
||
faces)
|
||
;; Try to get a face name from the buffer.
|
||
(if (memq (intern-soft (thing-at-point 'symbol)) (face-list))
|
||
(setq faces (list (intern-soft (thing-at-point 'symbol)))))
|
||
;; Add the named faces that the `face' property uses.
|
||
(if (and (listp faceprop)
|
||
;; Don't treat an attribute spec as a list of faces.
|
||
(not (keywordp (car faceprop)))
|
||
(not (memq (car faceprop) '(foreground-color background-color))))
|
||
(dolist (f faceprop)
|
||
(if (symbolp f)
|
||
(push f faces)))
|
||
(if (symbolp faceprop)
|
||
(push faceprop faces)))
|
||
(delete-dups faces)
|
||
|
||
;; Build up the completion tables.
|
||
(mapatoms (lambda (s)
|
||
(if (custom-facep s)
|
||
(if (get s 'face-alias)
|
||
(push (symbol-name s) aliasfaces)
|
||
(push (symbol-name s) nonaliasfaces)))))
|
||
|
||
;; If we only want one, and the default is more than one,
|
||
;; discard the unwanted ones now.
|
||
(unless multiple
|
||
(if faces
|
||
(setq faces (list (car faces)))))
|
||
(require 'crm)
|
||
(let* ((input
|
||
;; Read the input.
|
||
(completing-read-multiple
|
||
(if (or faces default)
|
||
(format "%s (default `%s'): " prompt
|
||
(if faces (mapconcat 'symbol-name faces ",")
|
||
default))
|
||
(format "%s: " prompt))
|
||
(completion-table-in-turn nonaliasfaces aliasfaces)
|
||
nil t nil 'face-name-history
|
||
(if faces (mapconcat 'symbol-name faces ","))))
|
||
;; Canonicalize the output.
|
||
(output
|
||
(cond ((or (equal input "") (equal input '("")))
|
||
(or faces (unless (stringp default) default)))
|
||
((stringp input)
|
||
(mapcar 'intern (split-string input ", *" t)))
|
||
((listp input)
|
||
(mapcar 'intern input))
|
||
(input))))
|
||
;; Return either a list of faces or just one face.
|
||
(if multiple
|
||
output
|
||
(car output)))))
|
||
|
||
;; Not defined without X, but behind window-system test.
|
||
(defvar x-bitmap-file-path)
|
||
|
||
(defun face-valid-attribute-values (attribute &optional frame)
|
||
"Return valid values for face attribute ATTRIBUTE.
|
||
The optional argument FRAME is used to determine available fonts
|
||
and colors. If it is nil or not specified, the selected frame is used.
|
||
Value is an alist of (NAME . VALUE) if ATTRIBUTE expects a value out
|
||
of a set of discrete values. Value is `integerp' if ATTRIBUTE expects
|
||
an integer value."
|
||
(let ((valid
|
||
(case attribute
|
||
(:family
|
||
(if (window-system frame)
|
||
(mapcar (lambda (x) (cons x x))
|
||
(font-family-list))
|
||
;; Only one font on TTYs.
|
||
(list (cons "default" "default"))))
|
||
(:foundry
|
||
(list nil))
|
||
(:width
|
||
(mapcar #'(lambda (x) (cons (symbol-name (aref x 1)) (aref x 1)))
|
||
font-width-table))
|
||
(:weight
|
||
(mapcar #'(lambda (x) (cons (symbol-name (aref x 1)) (aref x 1)))
|
||
font-weight-table))
|
||
(:slant
|
||
(mapcar #'(lambda (x) (cons (symbol-name (aref x 1)) (aref x 1)))
|
||
font-slant-table))
|
||
(:inverse-video
|
||
(mapcar #'(lambda (x) (cons (symbol-name x) x))
|
||
(internal-lisp-face-attribute-values attribute)))
|
||
((:underline :overline :strike-through :box)
|
||
(if (window-system frame)
|
||
(nconc (mapcar #'(lambda (x) (cons (symbol-name x) x))
|
||
(internal-lisp-face-attribute-values attribute))
|
||
(mapcar #'(lambda (c) (cons c c))
|
||
(defined-colors frame)))
|
||
(mapcar #'(lambda (x) (cons (symbol-name x) x))
|
||
(internal-lisp-face-attribute-values attribute))))
|
||
((:foreground :background)
|
||
(mapcar #'(lambda (c) (cons c c))
|
||
(defined-colors frame)))
|
||
((:height)
|
||
'integerp)
|
||
(:stipple
|
||
(and (memq (window-system frame) '(x ns)) ; No stipple on w32
|
||
(mapcar #'list
|
||
(apply #'nconc
|
||
(mapcar (lambda (dir)
|
||
(and (file-readable-p dir)
|
||
(file-directory-p dir)
|
||
(directory-files dir)))
|
||
x-bitmap-file-path)))))
|
||
(:inherit
|
||
(cons '("none" . nil)
|
||
(mapcar #'(lambda (c) (cons (symbol-name c) c))
|
||
(face-list))))
|
||
(t
|
||
(error "Internal error")))))
|
||
(if (and (listp valid) (not (memq attribute '(:inherit))))
|
||
(nconc (list (cons "unspecified" 'unspecified)) valid)
|
||
valid)))
|
||
|
||
|
||
(defconst face-attribute-name-alist
|
||
'((:family . "font family")
|
||
(:foundry . "font foundry")
|
||
(:width . "character set width")
|
||
(:height . "height in 1/10 pt")
|
||
(:weight . "weight")
|
||
(:slant . "slant")
|
||
(:underline . "underline")
|
||
(:overline . "overline")
|
||
(:strike-through . "strike-through")
|
||
(:box . "box")
|
||
(:inverse-video . "inverse-video display")
|
||
(:foreground . "foreground color")
|
||
(:background . "background color")
|
||
(:stipple . "background stipple")
|
||
(:inherit . "inheritance"))
|
||
"An alist of descriptive names for face attributes.
|
||
Each element has the form (ATTRIBUTE-NAME . DESCRIPTION) where
|
||
ATTRIBUTE-NAME is a face attribute name (a keyword symbol), and
|
||
DESCRIPTION is a descriptive name for ATTRIBUTE-NAME.")
|
||
|
||
|
||
(defun face-descriptive-attribute-name (attribute)
|
||
"Return a descriptive name for ATTRIBUTE."
|
||
(cdr (assq attribute face-attribute-name-alist)))
|
||
|
||
|
||
(defun face-read-string (face default name &optional completion-alist)
|
||
"Interactively read a face attribute string value.
|
||
FACE is the face whose attribute is read. If non-nil, DEFAULT is the
|
||
default string to return if no new value is entered. NAME is a
|
||
descriptive name of the attribute for prompting. COMPLETION-ALIST is an
|
||
alist of valid values, if non-nil.
|
||
|
||
Entering nothing accepts the default string DEFAULT.
|
||
Value is the new attribute value."
|
||
;; Capitalize NAME (we don't use `capitalize' because that capitalizes
|
||
;; each word in a string separately).
|
||
(setq name (concat (upcase (substring name 0 1)) (substring name 1)))
|
||
(let* ((completion-ignore-case t)
|
||
(value (completing-read
|
||
(if default
|
||
(format "%s for face `%s' (default %s): "
|
||
name face default)
|
||
(format "%s for face `%s': " name face))
|
||
completion-alist nil nil nil nil default)))
|
||
(if (equal value "") default value)))
|
||
|
||
|
||
(defun face-read-integer (face default name)
|
||
"Interactively read an integer face attribute value.
|
||
FACE is the face whose attribute is read. DEFAULT is the default
|
||
value to return if no new value is entered. NAME is a descriptive
|
||
name of the attribute for prompting. Value is the new attribute value."
|
||
(let ((new-value
|
||
(face-read-string face
|
||
(format "%s" default)
|
||
name
|
||
(list (cons "unspecified" 'unspecified)))))
|
||
(cond ((equal new-value "unspecified")
|
||
'unspecified)
|
||
((member new-value '("unspecified-fg" "unspecified-bg"))
|
||
new-value)
|
||
(t
|
||
(string-to-number new-value)))))
|
||
|
||
|
||
(defun read-face-attribute (face attribute &optional frame)
|
||
"Interactively read a new value for FACE's ATTRIBUTE.
|
||
Optional argument FRAME nil or unspecified means read an attribute value
|
||
of a global face. Value is the new attribute value."
|
||
(let* ((old-value (face-attribute face attribute frame))
|
||
(attribute-name (face-descriptive-attribute-name attribute))
|
||
(valid (face-valid-attribute-values attribute frame))
|
||
new-value)
|
||
;; Represent complex attribute values as strings by printing them
|
||
;; out. Stipple can be a vector; (WIDTH HEIGHT DATA). Box can be
|
||
;; a list `(:width WIDTH :color COLOR)' or `(:width WIDTH :shadow
|
||
;; SHADOW)'.
|
||
(when (and (or (eq attribute :stipple)
|
||
(eq attribute :box))
|
||
(or (consp old-value)
|
||
(vectorp old-value)))
|
||
(setq old-value (prin1-to-string old-value)))
|
||
(cond ((listp valid)
|
||
(let ((default
|
||
(or (car (rassoc old-value valid))
|
||
(format "%s" old-value))))
|
||
(setq new-value
|
||
(face-read-string face default attribute-name valid))
|
||
(if (equal new-value default)
|
||
;; Nothing changed, so don't bother with all the stuff
|
||
;; below. In particular, this avoids a non-tty color
|
||
;; from being canonicalized for a tty when the user
|
||
;; just uses the default.
|
||
(setq new-value old-value)
|
||
;; Terminal frames can support colors that don't appear
|
||
;; explicitly in VALID, using color approximation code
|
||
;; in tty-colors.el.
|
||
(when (and (memq attribute '(:foreground :background))
|
||
(not (memq (window-system frame) '(x w32 ns)))
|
||
(not (member new-value
|
||
'("unspecified"
|
||
"unspecified-fg" "unspecified-bg"))))
|
||
(setq new-value (car (tty-color-desc new-value frame))))
|
||
(when (assoc new-value valid)
|
||
(setq new-value (cdr (assoc new-value valid)))))))
|
||
((eq valid 'integerp)
|
||
(setq new-value (face-read-integer face old-value attribute-name)))
|
||
(t (error "Internal error")))
|
||
;; Convert stipple and box value text we read back to a list or
|
||
;; vector if it looks like one. This makes the assumption that a
|
||
;; pixmap file name won't start with an open-paren.
|
||
(when (and (or (eq attribute :stipple)
|
||
(eq attribute :box))
|
||
(stringp new-value)
|
||
(string-match "^[[(]" new-value))
|
||
(setq new-value (read new-value)))
|
||
new-value))
|
||
|
||
(declare-function fontset-list "fontset.c" ())
|
||
(declare-function x-list-fonts "xfaces.c"
|
||
(pattern &optional face frame maximum width))
|
||
|
||
(defun read-face-font (face &optional frame)
|
||
"Read the name of a font for FACE on FRAME.
|
||
If optional argument FRAME is nil or omitted, use the selected frame."
|
||
(let ((completion-ignore-case t))
|
||
(completing-read (format "Set font attributes of face `%s' from font: " face)
|
||
(append (fontset-list) (x-list-fonts "*" nil frame)))))
|
||
|
||
|
||
(defun read-all-face-attributes (face &optional frame)
|
||
"Interactively read all attributes for FACE.
|
||
If optional argument FRAME is nil or omitted, use the selected frame.
|
||
Value is a property list of attribute names and new values."
|
||
(let (result)
|
||
(dolist (attribute face-attribute-name-alist result)
|
||
(setq result (cons (car attribute)
|
||
(cons (read-face-attribute face (car attribute) frame)
|
||
result))))))
|
||
|
||
(defun modify-face (&optional face foreground background stipple
|
||
bold-p italic-p underline inverse-p frame)
|
||
"Modify attributes of faces interactively.
|
||
If optional argument FRAME is nil or omitted, modify the face used
|
||
for newly created frame, i.e. the global face.
|
||
For non-interactive use, `set-face-attribute' is preferred.
|
||
When called from Lisp, if FACE is nil, all arguments but FRAME are ignored
|
||
and the face and its settings are obtained by querying the user."
|
||
(interactive)
|
||
(if face
|
||
(set-face-attribute face frame
|
||
:foreground (or foreground 'unspecified)
|
||
:background (or background 'unspecified)
|
||
:stipple stipple
|
||
:bold bold-p
|
||
:italic italic-p
|
||
:underline underline
|
||
:inverse-video inverse-p)
|
||
(setq face (read-face-name "Modify face"))
|
||
(apply #'set-face-attribute face frame
|
||
(read-all-face-attributes face frame))))
|
||
|
||
(defun read-face-and-attribute (attribute &optional frame)
|
||
"Read face name and face attribute value.
|
||
ATTRIBUTE is the attribute whose new value is read.
|
||
FRAME nil or unspecified means read attribute value of global face.
|
||
Value is a list (FACE NEW-VALUE) where FACE is the face read
|
||
\(a symbol), and NEW-VALUE is value read."
|
||
(cond ((eq attribute :font)
|
||
(let* ((prompt "Set font-related attributes of face")
|
||
(face (read-face-name prompt))
|
||
(font (read-face-font face frame)))
|
||
(list face font)))
|
||
(t
|
||
(let* ((attribute-name (face-descriptive-attribute-name attribute))
|
||
(prompt (format "Set %s of face" attribute-name))
|
||
(face (read-face-name prompt))
|
||
(new-value (read-face-attribute face attribute frame)))
|
||
(list face new-value)))))
|
||
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Listing faces.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defconst list-faces-sample-text
|
||
"abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ"
|
||
"*Text string to display as the sample text for `list-faces-display'.")
|
||
|
||
|
||
;; The name list-faces would be more consistent, but let's avoid a
|
||
;; conflict with Lucid, which uses that name differently.
|
||
|
||
(defvar help-xref-stack)
|
||
(defun list-faces-display (&optional regexp)
|
||
"List all faces, using the same sample text in each.
|
||
The sample text is a string that comes from the variable
|
||
`list-faces-sample-text'.
|
||
|
||
If REGEXP is non-nil, list only those faces with names matching
|
||
this regular expression. When called interactively with a prefix
|
||
arg, prompt for a regular expression."
|
||
(interactive (list (and current-prefix-arg
|
||
(read-regexp "List faces matching regexp"))))
|
||
(let ((all-faces (zerop (length regexp)))
|
||
(frame (selected-frame))
|
||
(max-length 0)
|
||
faces line-format
|
||
disp-frame window face-name)
|
||
;; We filter and take the max length in one pass
|
||
(setq faces
|
||
(delq nil
|
||
(mapcar (lambda (f)
|
||
(let ((s (symbol-name f)))
|
||
(when (or all-faces (string-match regexp s))
|
||
(setq max-length (max (length s) max-length))
|
||
f)))
|
||
(sort (face-list) #'string-lessp))))
|
||
(unless faces
|
||
(error "No faces matching \"%s\"" regexp))
|
||
(setq max-length (1+ max-length)
|
||
line-format (format "%%-%ds" max-length))
|
||
(with-help-window "*Faces*"
|
||
(with-current-buffer standard-output
|
||
(setq truncate-lines t)
|
||
(insert
|
||
(substitute-command-keys
|
||
(concat
|
||
"Use "
|
||
(if (display-mouse-p) "\\[help-follow-mouse] or ")
|
||
"\\[help-follow] on a face name to customize it\n"
|
||
"or on its sample text for a description of the face.\n\n")))
|
||
(setq help-xref-stack nil)
|
||
(dolist (face faces)
|
||
(setq face-name (symbol-name face))
|
||
(insert (format line-format face-name))
|
||
;; Hyperlink to a customization buffer for the face. Using
|
||
;; the help xref mechanism may not be the best way.
|
||
(save-excursion
|
||
(save-match-data
|
||
(search-backward face-name)
|
||
(setq help-xref-stack-item `(list-faces-display ,regexp))
|
||
(help-xref-button 0 'help-customize-face face)))
|
||
(let ((beg (point))
|
||
(line-beg (line-beginning-position)))
|
||
(insert list-faces-sample-text)
|
||
;; Hyperlink to a help buffer for the face.
|
||
(save-excursion
|
||
(save-match-data
|
||
(search-backward list-faces-sample-text)
|
||
(help-xref-button 0 'help-face face)))
|
||
(insert "\n")
|
||
(put-text-property beg (1- (point)) 'face face)
|
||
;; Make all face commands default to the proper face
|
||
;; anywhere in the line.
|
||
(put-text-property line-beg (1- (point)) 'read-face-name face)
|
||
;; If the sample text has multiple lines, line up all of them.
|
||
(goto-char beg)
|
||
(forward-line 1)
|
||
(while (not (eobp))
|
||
(insert-char ?\s max-length)
|
||
(forward-line 1))))
|
||
(goto-char (point-min))))
|
||
;; If the *Faces* buffer appears in a different frame,
|
||
;; copy all the face definitions from FRAME,
|
||
;; so that the display will reflect the frame that was selected.
|
||
(setq window (get-buffer-window (get-buffer "*Faces*") t))
|
||
(setq disp-frame (if window (window-frame window)
|
||
(car (frame-list))))
|
||
(or (eq frame disp-frame)
|
||
(let ((faces (face-list)))
|
||
(while faces
|
||
(copy-face (car faces) (car faces) frame disp-frame)
|
||
(setq faces (cdr faces)))))))
|
||
|
||
|
||
(defun describe-face (face &optional frame)
|
||
"Display the properties of face FACE on FRAME.
|
||
Interactively, FACE defaults to the faces of the character after point
|
||
and FRAME defaults to the selected frame.
|
||
|
||
If the optional argument FRAME is given, report on face FACE in that frame.
|
||
If FRAME is t, report on the defaults for face FACE (for new frames).
|
||
If FRAME is omitted or nil, use the selected frame."
|
||
(interactive (list (read-face-name "Describe face" 'default t)))
|
||
(let* ((attrs '((:family . "Family")
|
||
(:foundry . "Foundry")
|
||
(:width . "Width")
|
||
(:height . "Height")
|
||
(:weight . "Weight")
|
||
(:slant . "Slant")
|
||
(:foreground . "Foreground")
|
||
(:background . "Background")
|
||
(:underline . "Underline")
|
||
(:overline . "Overline")
|
||
(:strike-through . "Strike-through")
|
||
(:box . "Box")
|
||
(:inverse-video . "Inverse")
|
||
(:stipple . "Stipple")
|
||
(:font . "Font")
|
||
(:fontset . "Fontset")
|
||
(:inherit . "Inherit")))
|
||
(max-width (apply #'max (mapcar #'(lambda (x) (length (cdr x)))
|
||
attrs))))
|
||
(help-setup-xref (list #'describe-face face)
|
||
(called-interactively-p 'interactive))
|
||
(unless face
|
||
(setq face 'default))
|
||
(if (not (listp face))
|
||
(setq face (list face)))
|
||
(with-help-window (help-buffer)
|
||
(with-current-buffer standard-output
|
||
(dolist (f face)
|
||
(if (stringp f) (setq f (intern f)))
|
||
;; We may get called for anonymous faces (i.e., faces
|
||
;; expressed using prop-value plists). Those can't be
|
||
;; usefully customized, so ignore them.
|
||
(when (symbolp f)
|
||
(insert "Face: " (symbol-name f))
|
||
(if (not (facep f))
|
||
(insert " undefined face.\n")
|
||
(let ((customize-label "customize this face")
|
||
file-name)
|
||
(insert (concat " (" (propertize "sample" 'font-lock-face f) ")"))
|
||
(princ (concat " (" customize-label ")\n"))
|
||
;; FIXME not sure how much of this belongs here, and
|
||
;; how much in `face-documentation'. The latter is
|
||
;; not used much, but needs to return nil for
|
||
;; undocumented faces.
|
||
(let ((alias (get f 'face-alias))
|
||
(face f)
|
||
obsolete)
|
||
(when alias
|
||
(setq face alias)
|
||
(insert
|
||
(format "\n %s is an alias for the face `%s'.\n%s"
|
||
f alias
|
||
(if (setq obsolete (get f 'obsolete-face))
|
||
(format " This face is obsolete%s; use `%s' instead.\n"
|
||
(if (stringp obsolete)
|
||
(format " since %s" obsolete)
|
||
"")
|
||
alias)
|
||
""))))
|
||
(insert "\nDocumentation:\n"
|
||
(or (face-documentation face)
|
||
"Not documented as a face.")
|
||
"\n\n"))
|
||
(with-current-buffer standard-output
|
||
(save-excursion
|
||
(re-search-backward
|
||
(concat "\\(" customize-label "\\)") nil t)
|
||
(help-xref-button 1 'help-customize-face f)))
|
||
(setq file-name (find-lisp-object-file-name f 'defface))
|
||
(when file-name
|
||
(princ "Defined in `")
|
||
(princ (file-name-nondirectory file-name))
|
||
(princ "'")
|
||
;; Make a hyperlink to the library.
|
||
(save-excursion
|
||
(re-search-backward "`\\([^`']+\\)'" nil t)
|
||
(help-xref-button 1 'help-face-def f file-name))
|
||
(princ ".")
|
||
(terpri)
|
||
(terpri))
|
||
(dolist (a attrs)
|
||
(let ((attr (face-attribute f (car a) frame)))
|
||
(insert (make-string (- max-width (length (cdr a))) ?\s)
|
||
(cdr a) ": " (format "%s" attr))
|
||
(if (and (eq (car a) :inherit)
|
||
(not (eq attr 'unspecified)))
|
||
;; Make a hyperlink to the parent face.
|
||
(save-excursion
|
||
(re-search-backward ": \\([^:]+\\)" nil t)
|
||
(help-xref-button 1 'help-face attr)))
|
||
(insert "\n")))))
|
||
(terpri)))))))
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Face specifications (defface).
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
;; Parameter FRAME Is kept for call compatibility to with previous
|
||
;; face implementation.
|
||
|
||
(defun face-attr-construct (face &optional frame)
|
||
"Return a `defface'-style attribute list for FACE on FRAME.
|
||
Value is a property list of pairs ATTRIBUTE VALUE for all specified
|
||
face attributes of FACE where ATTRIBUTE is the attribute name and
|
||
VALUE is the specified value of that attribute."
|
||
(let (result)
|
||
(dolist (entry face-attribute-name-alist result)
|
||
(let* ((attribute (car entry))
|
||
(value (face-attribute face attribute)))
|
||
(unless (eq value 'unspecified)
|
||
(setq result (nconc (list attribute value) result)))))))
|
||
|
||
|
||
(defun face-spec-set-match-display (display frame)
|
||
"Non-nil if DISPLAY matches FRAME.
|
||
DISPLAY is part of a spec such as can be used in `defface'.
|
||
If FRAME is nil, the current FRAME is used."
|
||
(let* ((conjuncts display)
|
||
conjunct req options
|
||
;; t means we have succeeded against all the conjuncts in
|
||
;; DISPLAY that have been tested so far.
|
||
(match t))
|
||
(if (eq conjuncts t)
|
||
(setq conjuncts nil))
|
||
(while (and conjuncts match)
|
||
(setq conjunct (car conjuncts)
|
||
conjuncts (cdr conjuncts)
|
||
req (car conjunct)
|
||
options (cdr conjunct)
|
||
match (cond ((eq req 'type)
|
||
(or (memq (window-system frame) options)
|
||
;; FIXME: This should be revisited to use
|
||
;; display-graphic-p, provided that the
|
||
;; color selection depends on the number
|
||
;; of supported colors, and all defface's
|
||
;; are changed to look at number of colors
|
||
;; instead of (type graphic) etc.
|
||
(and (null (window-system frame))
|
||
(memq 'tty options))
|
||
(and (memq 'motif options)
|
||
(featurep 'motif))
|
||
(and (memq 'gtk options)
|
||
(featurep 'gtk))
|
||
(and (memq 'lucid options)
|
||
(featurep 'x-toolkit)
|
||
(not (featurep 'motif))
|
||
(not (featurep 'gtk)))
|
||
(and (memq 'x-toolkit options)
|
||
(featurep 'x-toolkit))))
|
||
((eq req 'min-colors)
|
||
(>= (display-color-cells frame) (car options)))
|
||
((eq req 'class)
|
||
(memq (frame-parameter frame 'display-type) options))
|
||
((eq req 'background)
|
||
(memq (frame-parameter frame 'background-mode)
|
||
options))
|
||
((eq req 'supports)
|
||
(display-supports-face-attributes-p options frame))
|
||
(t (error "Unknown req `%S' with options `%S'"
|
||
req options)))))
|
||
match))
|
||
|
||
|
||
(defun face-spec-choose (spec &optional frame)
|
||
"Choose the proper attributes for FRAME, out of SPEC.
|
||
If SPEC is nil, return nil."
|
||
(unless frame
|
||
(setq frame (selected-frame)))
|
||
(let ((tail spec)
|
||
result defaults)
|
||
(while tail
|
||
(let* ((entry (pop tail))
|
||
(display (car entry))
|
||
(attrs (cdr entry))
|
||
thisval)
|
||
;; Get the attributes as actually specified by this alternative.
|
||
(setq thisval
|
||
(if (null (cdr attrs)) ;; was (listp (car attrs))
|
||
;; Old-style entry, the attribute list is the
|
||
;; first element.
|
||
(car attrs)
|
||
attrs))
|
||
|
||
;; If the condition is `default', that sets the default
|
||
;; for following conditions.
|
||
(if (eq display 'default)
|
||
(setq defaults thisval)
|
||
;; Otherwise, if it matches, use it.
|
||
(when (face-spec-set-match-display display frame)
|
||
(setq result thisval)
|
||
(setq tail nil)))))
|
||
(if defaults (append result defaults) result)))
|
||
|
||
|
||
(defun face-spec-reset-face (face &optional frame)
|
||
"Reset all attributes of FACE on FRAME to unspecified."
|
||
(let (reset-args)
|
||
(dolist (attr-and-name face-attribute-name-alist)
|
||
(push 'unspecified reset-args)
|
||
(push (car attr-and-name) reset-args))
|
||
(apply 'set-face-attribute face frame reset-args)))
|
||
|
||
(defun face-spec-set (face spec &optional for-defface)
|
||
"Set FACE's face spec, which controls its appearance, to SPEC.
|
||
If FOR-DEFFACE is t, set the base spec, the one that `defface'
|
||
and Custom set. (In that case, the caller must put it in the
|
||
appropriate property, because that depends on the caller.)
|
||
If FOR-DEFFACE is nil, set the overriding spec (and store it
|
||
in the `face-override-spec' property of FACE).
|
||
|
||
The appearance of FACE is controlled by the base spec,
|
||
by any custom theme specs on top of that, and by the
|
||
overriding spec on top of all the rest.
|
||
|
||
FOR-DEFFACE can also be a frame, in which case we set the
|
||
frame-specific attributes of FACE for that frame based on SPEC.
|
||
That usage is deprecated.
|
||
|
||
See `defface' for information about the format and meaning of SPEC."
|
||
(if (framep for-defface)
|
||
;; Handle the deprecated case where third arg is a frame.
|
||
(face-spec-set-2 face for-defface spec)
|
||
(if for-defface
|
||
;; When we reset the face based on its custom spec, then it is
|
||
;; unmodified as far as Custom is concerned.
|
||
(put (or (get face 'face-alias) face) 'face-modified nil)
|
||
;; When we change a face based on a spec from outside custom,
|
||
;; record it for future frames.
|
||
(put (or (get face 'face-alias) face) 'face-override-spec spec))
|
||
;; Reset each frame according to the rules implied by all its specs.
|
||
(dolist (frame (frame-list))
|
||
(face-spec-recalc face frame))))
|
||
|
||
(defun face-spec-recalc (face frame)
|
||
"Reset the face attributes of FACE on FRAME according to its specs.
|
||
This applies the defface/custom spec first, then the custom theme specs,
|
||
then the override spec."
|
||
(face-spec-reset-face face frame)
|
||
(let ((face-sym (or (get face 'face-alias) face)))
|
||
(or (get face 'customized-face)
|
||
(get face 'saved-face)
|
||
(face-spec-set-2 face frame (face-default-spec face)))
|
||
(let ((theme-faces (reverse (get face-sym 'theme-face))))
|
||
(dolist (spec theme-faces)
|
||
(face-spec-set-2 face frame (cadr spec))))
|
||
(face-spec-set-2 face frame (get face-sym 'face-override-spec))))
|
||
|
||
(defun face-spec-set-2 (face frame spec)
|
||
"Set the face attributes of FACE on FRAME according to SPEC."
|
||
(let* ((spec (face-spec-choose spec frame))
|
||
attrs)
|
||
(while spec
|
||
(when (assq (car spec) face-x-resources)
|
||
(push (car spec) attrs)
|
||
(push (cadr spec) attrs))
|
||
(setq spec (cddr spec)))
|
||
(apply 'set-face-attribute face frame (nreverse attrs))))
|
||
|
||
(defun face-attr-match-p (face attrs &optional frame)
|
||
"Return t if attributes of FACE match values in plist ATTRS.
|
||
Optional parameter FRAME is the frame whose definition of FACE
|
||
is used. If nil or omitted, use the selected frame."
|
||
(unless frame
|
||
(setq frame (selected-frame)))
|
||
(let* ((list face-attribute-name-alist)
|
||
(match t)
|
||
(bold (and (plist-member attrs :bold)
|
||
(not (plist-member attrs :weight))))
|
||
(italic (and (plist-member attrs :italic)
|
||
(not (plist-member attrs :slant))))
|
||
(plist (if (or bold italic)
|
||
(copy-sequence attrs)
|
||
attrs)))
|
||
;; Handle the Emacs 20 :bold and :italic properties.
|
||
(if bold
|
||
(plist-put plist :weight (if bold 'bold 'normal)))
|
||
(if italic
|
||
(plist-put plist :slant (if italic 'italic 'normal)))
|
||
(while (and match list)
|
||
(let* ((attr (caar list))
|
||
(specified-value
|
||
(if (plist-member plist attr)
|
||
(plist-get plist attr)
|
||
'unspecified))
|
||
(value-now (face-attribute face attr frame)))
|
||
(setq match (equal specified-value value-now))
|
||
(setq list (cdr list))))
|
||
match))
|
||
|
||
(defsubst face-spec-match-p (face spec &optional frame)
|
||
"Return t if FACE, on FRAME, matches what SPEC says it should look like."
|
||
(face-attr-match-p face (face-spec-choose spec frame) frame))
|
||
|
||
(defsubst face-default-spec (face)
|
||
"Return the default face-spec for FACE, ignoring any user customization.
|
||
If there is no default for FACE, return nil."
|
||
(get face 'face-defface-spec))
|
||
|
||
(defsubst face-user-default-spec (face)
|
||
"Return the user's customized face-spec for FACE, or the default if none.
|
||
If there is neither a user setting nor a default for FACE, return nil."
|
||
(or (get face 'customized-face)
|
||
(get face 'saved-face)
|
||
(face-default-spec face)))
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Frame-type independent color support.
|
||
;;; We keep the old x-* names as aliases for back-compatibility.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defun defined-colors (&optional frame)
|
||
"Return a list of colors supported for a particular frame.
|
||
The argument FRAME specifies which frame to try.
|
||
The value may be different for frames on different display types.
|
||
If FRAME doesn't support colors, the value is nil.
|
||
If FRAME is nil, that stands for the selected frame."
|
||
(if (memq (framep (or frame (selected-frame))) '(x w32 ns))
|
||
(xw-defined-colors frame)
|
||
(mapcar 'car (tty-color-alist frame))))
|
||
(defalias 'x-defined-colors 'defined-colors)
|
||
|
||
(declare-function xw-color-defined-p "xfns.c" (color &optional frame))
|
||
|
||
(defun color-defined-p (color &optional frame)
|
||
"Return non-nil if color COLOR is supported on frame FRAME.
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
If COLOR is the symbol `unspecified' or one of the strings
|
||
\"unspecified-fg\" or \"unspecified-bg\", the value is nil."
|
||
(if (member color '(unspecified "unspecified-bg" "unspecified-fg"))
|
||
nil
|
||
(if (member (framep (or frame (selected-frame))) '(x w32 ns))
|
||
(xw-color-defined-p color frame)
|
||
(numberp (tty-color-translate color frame)))))
|
||
(defalias 'x-color-defined-p 'color-defined-p)
|
||
|
||
(declare-function xw-color-values "xfns.c" (color &optional frame))
|
||
|
||
(defun color-values (color &optional frame)
|
||
"Return a description of the color named COLOR on frame FRAME.
|
||
COLOR should be a string naming a color (e.g. \"white\"), or a
|
||
string specifying a color's RGB components (e.g. \"#ff12ec\").
|
||
|
||
Return a list of three integers, (RED GREEN BLUE), each between 0
|
||
and either 65280 or 65535 (the maximum depends on the system).
|
||
Use `color-name-to-rgb' if you want RGB floating-point values
|
||
normalized to 1.0.
|
||
|
||
If FRAME is omitted or nil, use the selected frame.
|
||
If FRAME cannot display COLOR, the value is nil.
|
||
|
||
COLOR can also be the symbol `unspecified' or one of the strings
|
||
\"unspecified-fg\" or \"unspecified-bg\", in which case the
|
||
return value is nil."
|
||
(cond
|
||
((member color '(unspecified "unspecified-fg" "unspecified-bg"))
|
||
nil)
|
||
((memq (framep (or frame (selected-frame))) '(x w32 ns))
|
||
(xw-color-values color frame))
|
||
(t
|
||
(tty-color-values color frame))))
|
||
|
||
(defalias 'x-color-values 'color-values)
|
||
|
||
(declare-function xw-display-color-p "xfns.c" (&optional terminal))
|
||
|
||
(defun display-color-p (&optional display)
|
||
"Return t if DISPLAY supports color.
|
||
The optional argument DISPLAY specifies which display to ask about.
|
||
DISPLAY should be either a frame or a display name (a string).
|
||
If omitted or nil, that stands for the selected frame's display."
|
||
(if (memq (framep-on-display display) '(x w32 ns))
|
||
(xw-display-color-p display)
|
||
(tty-display-color-p display)))
|
||
(defalias 'x-display-color-p 'display-color-p)
|
||
|
||
(declare-function x-display-grayscale-p "xfns.c" (&optional terminal))
|
||
|
||
(defun display-grayscale-p (&optional display)
|
||
"Return non-nil if frames on DISPLAY can display shades of gray."
|
||
(let ((frame-type (framep-on-display display)))
|
||
(cond
|
||
((memq frame-type '(x w32 ns))
|
||
(x-display-grayscale-p display))
|
||
(t
|
||
(> (tty-color-gray-shades display) 2)))))
|
||
|
||
(defun read-color (&optional prompt convert-to-RGB allow-empty-name msg)
|
||
"Read a color name or RGB triplet of the form \"#RRRRGGGGBBBB\".
|
||
Completion is available for color names, but not for RGB triplets.
|
||
|
||
RGB triplets have the form #XXXXXXXXXXXX, where each X is a hex
|
||
digit. The number of Xs must be a multiple of 3, with the same
|
||
number of Xs for each of red, green, and blue. The order is red,
|
||
green, blue.
|
||
|
||
In addition to standard color names and RGB hex values, the
|
||
following are available as color candidates. In each case, the
|
||
corresponding color is used.
|
||
|
||
* `foreground at point' - foreground under the cursor
|
||
* `background at point' - background under the cursor
|
||
|
||
Optional arg PROMPT is the prompt; if nil, use a default prompt.
|
||
|
||
Interactively, or with optional arg CONVERT-TO-RGB-P non-nil,
|
||
convert an input color name to an RGB hex string. Return the RGB
|
||
hex string.
|
||
|
||
If optional arg ALLOW-EMPTY-NAME is non-nil, the user is allowed
|
||
to enter an empty color name (the empty string).
|
||
|
||
Interactively, or with optional arg MSG non-nil, print the
|
||
resulting color name in the echo area."
|
||
(interactive "i\np\ni\np") ; Always convert to RGB interactively.
|
||
(let* ((completion-ignore-case t)
|
||
(colors (or facemenu-color-alist
|
||
(append '("foreground at point" "background at point")
|
||
(if allow-empty-name '(""))
|
||
(defined-colors))))
|
||
(color (completing-read
|
||
(or prompt "Color (name or #RGB triplet): ")
|
||
;; Completing function for reading colors, accepting
|
||
;; both color names and RGB triplets.
|
||
(lambda (string pred flag)
|
||
(cond
|
||
((null flag) ; Try completion.
|
||
(or (try-completion string colors pred)
|
||
(if (color-defined-p string)
|
||
string)))
|
||
((eq flag t) ; List all completions.
|
||
(or (all-completions string colors pred)
|
||
(if (color-defined-p string)
|
||
(list string))))
|
||
((eq flag 'lambda) ; Test completion.
|
||
(or (memq string colors)
|
||
(color-defined-p string)))))
|
||
nil t))
|
||
hex-string)
|
||
|
||
;; Process named colors.
|
||
(when (member color colors)
|
||
(cond ((string-equal color "foreground at point")
|
||
(setq color (foreground-color-at-point)))
|
||
((string-equal color "background at point")
|
||
(setq color (background-color-at-point))))
|
||
(when (and convert-to-RGB
|
||
(not (string-equal color "")))
|
||
(let ((components (x-color-values color)))
|
||
(unless (string-match "^#\\([a-fA-F0-9][a-fA-F0-9][a-fA-F0-9]\\)+$" color)
|
||
(setq color (format "#%04X%04X%04X"
|
||
(logand 65535 (nth 0 components))
|
||
(logand 65535 (nth 1 components))
|
||
(logand 65535 (nth 2 components))))))))
|
||
(when msg (message "Color: `%s'" color))
|
||
color))
|
||
|
||
|
||
(defun face-at-point ()
|
||
"Return the face of the character after point.
|
||
If it has more than one face, return the first one.
|
||
Return nil if it has no specified face."
|
||
(let* ((faceprop (or (get-char-property (point) 'read-face-name)
|
||
(get-char-property (point) 'face)
|
||
'default))
|
||
(face (cond ((symbolp faceprop) faceprop)
|
||
;; List of faces (don't treat an attribute spec).
|
||
;; Just use the first face.
|
||
((and (consp faceprop) (not (keywordp (car faceprop)))
|
||
(not (memq (car faceprop)
|
||
'(foreground-color background-color))))
|
||
(car faceprop))
|
||
(t nil)))) ; Invalid face value.
|
||
(if (facep face) face nil)))
|
||
|
||
(defun foreground-color-at-point ()
|
||
"Return the foreground color of the character after point."
|
||
;; `face-at-point' alone is not sufficient. It only gets named faces.
|
||
;; Need also pick up any face properties that are not associated with named faces.
|
||
(let ((face (or (face-at-point)
|
||
(get-char-property (point) 'read-face-name)
|
||
(get-char-property (point) 'face))))
|
||
(cond ((and face (symbolp face))
|
||
(let ((value (face-foreground face nil 'default)))
|
||
(if (member value '("unspecified-fg" "unspecified-bg"))
|
||
nil
|
||
value)))
|
||
((consp face)
|
||
(cond ((memq 'foreground-color face) (cdr (memq 'foreground-color face)))
|
||
((memq ':foreground face) (cadr (memq ':foreground face)))))
|
||
(t nil)))) ; Invalid face value.
|
||
|
||
(defun background-color-at-point ()
|
||
"Return the background color of the character after point."
|
||
;; `face-at-point' alone is not sufficient. It only gets named faces.
|
||
;; Need also pick up any face properties that are not associated with named faces.
|
||
(let ((face (or (face-at-point)
|
||
(get-char-property (point) 'read-face-name)
|
||
(get-char-property (point) 'face))))
|
||
(cond ((and face (symbolp face))
|
||
(let ((value (face-background face nil 'default)))
|
||
(if (member value '("unspecified-fg" "unspecified-bg"))
|
||
nil
|
||
value)))
|
||
((consp face)
|
||
(cond ((memq 'background-color face) (cdr (memq 'background-color face)))
|
||
((memq ':background face) (cadr (memq ':background face)))))
|
||
(t nil)))) ; Invalid face value.
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Background mode.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defcustom frame-background-mode nil
|
||
"The brightness of the background.
|
||
Set this to the symbol `dark' if your background color is dark,
|
||
`light' if your background is light, or nil (automatic by default)
|
||
if you want Emacs to examine the brightness for you. Don't set this
|
||
variable with `setq'; this won't have the expected effect."
|
||
:group 'faces
|
||
:set #'(lambda (var value)
|
||
(set-default var value)
|
||
(mapc 'frame-set-background-mode (frame-list)))
|
||
:initialize 'custom-initialize-changed
|
||
:type '(choice (const dark)
|
||
(const light)
|
||
(const :tag "automatic" nil)))
|
||
|
||
|
||
(declare-function x-get-resource "frame.c"
|
||
(attribute class &optional component subclass))
|
||
|
||
(defvar inhibit-frame-set-background-mode nil)
|
||
|
||
(defun frame-set-background-mode (frame &optional keep-face-specs)
|
||
"Set up display-dependent faces on FRAME.
|
||
Display-dependent faces are those which have different definitions
|
||
according to the `background-mode' and `display-type' frame parameters.
|
||
|
||
If optional arg KEEP-FACE-SPECS is non-nil, don't recalculate
|
||
face specs for the new background mode."
|
||
(unless inhibit-frame-set-background-mode
|
||
(let* ((bg-resource
|
||
(and (window-system frame)
|
||
(x-get-resource "backgroundMode" "BackgroundMode")))
|
||
(bg-color (frame-parameter frame 'background-color))
|
||
(terminal-bg-mode (terminal-parameter frame 'background-mode))
|
||
(tty-type (tty-type frame))
|
||
(default-bg-mode
|
||
(if (or (window-system frame)
|
||
(and tty-type
|
||
(string-match "^\\(xterm\\|\\rxvt\\|dtterm\\|eterm\\)"
|
||
tty-type)))
|
||
'light
|
||
'dark))
|
||
(non-default-bg-mode (if (eq default-bg-mode 'light) 'dark 'light))
|
||
(bg-mode
|
||
(cond (frame-background-mode)
|
||
(bg-resource (intern (downcase bg-resource)))
|
||
(terminal-bg-mode)
|
||
((equal bg-color "unspecified-fg") ; inverted colors
|
||
non-default-bg-mode)
|
||
((not (color-values bg-color frame))
|
||
default-bg-mode)
|
||
((>= (apply '+ (color-values bg-color frame))
|
||
;; Just looking at the screen, colors whose
|
||
;; values add up to .6 of the white total
|
||
;; still look dark to me.
|
||
(* (apply '+ (color-values "white" frame)) .6))
|
||
'light)
|
||
(t 'dark)))
|
||
(display-type
|
||
(cond ((null (window-system frame))
|
||
(if (tty-display-color-p frame) 'color 'mono))
|
||
((display-color-p frame)
|
||
'color)
|
||
((x-display-grayscale-p frame)
|
||
'grayscale)
|
||
(t 'mono)))
|
||
(old-bg-mode
|
||
(frame-parameter frame 'background-mode))
|
||
(old-display-type
|
||
(frame-parameter frame 'display-type)))
|
||
|
||
(unless (and (eq bg-mode old-bg-mode) (eq display-type old-display-type))
|
||
(let ((locally-modified-faces nil)
|
||
;; Prevent face-spec-recalc from calling this function
|
||
;; again, resulting in a loop (bug#911).
|
||
(inhibit-frame-set-background-mode t)
|
||
(params (list (cons 'background-mode bg-mode)
|
||
(cons 'display-type display-type))))
|
||
(if keep-face-specs
|
||
(modify-frame-parameters frame params)
|
||
;; If we are recomputing face specs, first collect a list
|
||
;; of faces that don't match their face-specs. These are
|
||
;; the faces modified on FRAME, and we avoid changing them
|
||
;; below. Use a negative list to avoid consing (we assume
|
||
;; most faces are unmodified).
|
||
(dolist (face (face-list))
|
||
(and (not (get face 'face-override-spec))
|
||
(not (face-spec-match-p face
|
||
(face-user-default-spec face)
|
||
(selected-frame)))
|
||
(push face locally-modified-faces)))
|
||
;; Now change to the new frame parameters
|
||
(modify-frame-parameters frame params)
|
||
;; For all unmodified named faces, choose face specs
|
||
;; matching the new frame parameters.
|
||
(dolist (face (face-list))
|
||
(unless (memq face locally-modified-faces)
|
||
(face-spec-recalc face frame)))))))))
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Frame creation.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(declare-function x-parse-geometry "frame.c" (string))
|
||
|
||
(defun x-handle-named-frame-geometry (parameters)
|
||
"Add geometry parameters for a named frame to parameter list PARAMETERS.
|
||
Value is the new parameter list."
|
||
;; Note that `x-resource-name' has a global meaning.
|
||
(let ((x-resource-name (cdr (assq 'name parameters))))
|
||
(when x-resource-name
|
||
;; Before checking X resources, we must have an X connection.
|
||
(or (window-system)
|
||
(x-display-list)
|
||
(x-open-connection (or (cdr (assq 'display parameters))
|
||
x-display-name)))
|
||
(let (res-geometry parsed)
|
||
(and (setq res-geometry (x-get-resource "geometry" "Geometry"))
|
||
(setq parsed (x-parse-geometry res-geometry))
|
||
(setq parameters
|
||
(append parameters parsed
|
||
;; If the resource specifies a position,
|
||
;; take note of that.
|
||
(if (or (assq 'top parsed) (assq 'left parsed))
|
||
'((user-position . t) (user-size . t)))))))))
|
||
parameters)
|
||
|
||
|
||
(defun x-handle-reverse-video (frame parameters)
|
||
"Handle the reverse-video frame parameter and X resource.
|
||
`x-create-frame' does not handle this one."
|
||
(when (cdr (or (assq 'reverse parameters)
|
||
(let ((resource (x-get-resource "reverseVideo"
|
||
"ReverseVideo")))
|
||
(if resource
|
||
(cons nil (member (downcase resource)
|
||
'("on" "true")))))))
|
||
(let* ((params (frame-parameters frame))
|
||
(bg (cdr (assq 'foreground-color params)))
|
||
(fg (cdr (assq 'background-color params))))
|
||
(modify-frame-parameters frame
|
||
(list (cons 'foreground-color fg)
|
||
(cons 'background-color bg)))
|
||
(if (equal bg (cdr (assq 'border-color params)))
|
||
(modify-frame-parameters frame
|
||
(list (cons 'border-color fg))))
|
||
(if (equal bg (cdr (assq 'mouse-color params)))
|
||
(modify-frame-parameters frame
|
||
(list (cons 'mouse-color fg))))
|
||
(if (equal bg (cdr (assq 'cursor-color params)))
|
||
(modify-frame-parameters frame
|
||
(list (cons 'cursor-color fg)))))))
|
||
|
||
(declare-function x-create-frame "xfns.c" (parms))
|
||
(declare-function x-setup-function-keys "term/common-win" (frame))
|
||
|
||
(defun x-create-frame-with-faces (&optional parameters)
|
||
"Create and return a frame with frame parameters PARAMETERS.
|
||
If PARAMETERS specify a frame name, handle X geometry resources
|
||
for that name. If PARAMETERS includes a `reverse' parameter, or
|
||
the X resource ``reverseVideo'' is present, handle that."
|
||
(setq parameters (x-handle-named-frame-geometry parameters))
|
||
(let* ((params (copy-tree parameters))
|
||
(visibility-spec (assq 'visibility parameters))
|
||
(delayed-params '(foreground-color background-color font
|
||
border-color cursor-color mouse-color
|
||
visibility scroll-bar-foreground
|
||
scroll-bar-background))
|
||
frame success)
|
||
(dolist (param delayed-params)
|
||
(setq params (assq-delete-all param params)))
|
||
(setq frame (x-create-frame `((visibility . nil) . ,params)))
|
||
(unwind-protect
|
||
(progn
|
||
(x-setup-function-keys frame)
|
||
(x-handle-reverse-video frame parameters)
|
||
(frame-set-background-mode frame t)
|
||
(face-set-after-frame-default frame parameters)
|
||
(if (null visibility-spec)
|
||
(make-frame-visible frame)
|
||
(modify-frame-parameters frame (list visibility-spec)))
|
||
(setq success t))
|
||
(unless success
|
||
(delete-frame frame)))
|
||
frame))
|
||
|
||
(defun face-set-after-frame-default (frame &optional parameters)
|
||
"Initialize the frame-local faces of FRAME.
|
||
Calculate the face definitions using the face specs, custom theme
|
||
settings, X resources, and `face-new-frame-defaults'.
|
||
Finally, apply any relevant face attributes found amongst the
|
||
frame parameters in PARAMETERS."
|
||
(let ((window-system-p (memq (window-system frame) '(x w32))))
|
||
(dolist (face (nreverse (face-list))) ;Why reverse? --Stef
|
||
(condition-case ()
|
||
(progn
|
||
;; Initialize faces from face spec and custom theme.
|
||
(face-spec-recalc face frame)
|
||
;; X resouces for the default face are applied during
|
||
;; `x-create-frame'.
|
||
(and (not (eq face 'default)) window-system-p
|
||
(make-face-x-resource-internal face frame))
|
||
;; Apply attributes specified by face-new-frame-defaults
|
||
(internal-merge-in-global-face face frame))
|
||
;; Don't let invalid specs prevent frame creation.
|
||
(error nil))))
|
||
|
||
;; Apply attributes specified by frame parameters.
|
||
(let ((face-params '((foreground-color default :foreground)
|
||
(background-color default :background)
|
||
(font default :font)
|
||
(border-color border :background)
|
||
(cursor-color cursor :background)
|
||
(scroll-bar-foreground scroll-bar :foreground)
|
||
(scroll-bar-background scroll-bar :background)
|
||
(mouse-color mouse :background))))
|
||
(dolist (param face-params)
|
||
(let* ((param-name (nth 0 param))
|
||
(value (cdr (assq param-name parameters))))
|
||
(if value
|
||
(set-face-attribute (nth 1 param) frame
|
||
(nth 2 param) value))))))
|
||
|
||
(defun tty-handle-reverse-video (frame parameters)
|
||
"Handle the reverse-video frame parameter for terminal frames."
|
||
(when (cdr (assq 'reverse parameters))
|
||
(let* ((params (frame-parameters frame))
|
||
(bg (cdr (assq 'foreground-color params)))
|
||
(fg (cdr (assq 'background-color params))))
|
||
(modify-frame-parameters frame
|
||
(list (cons 'foreground-color fg)
|
||
(cons 'background-color bg)))
|
||
(if (equal bg (cdr (assq 'mouse-color params)))
|
||
(modify-frame-parameters frame
|
||
(list (cons 'mouse-color fg))))
|
||
(if (equal bg (cdr (assq 'cursor-color params)))
|
||
(modify-frame-parameters frame
|
||
(list (cons 'cursor-color fg)))))))
|
||
|
||
|
||
(defun tty-create-frame-with-faces (&optional parameters)
|
||
"Create and return a frame from optional frame parameters PARAMETERS.
|
||
If PARAMETERS contains a `reverse' parameter, handle that."
|
||
(let ((frame (make-terminal-frame parameters))
|
||
success)
|
||
(unwind-protect
|
||
(with-selected-frame frame
|
||
(tty-handle-reverse-video frame (frame-parameters frame))
|
||
|
||
(unless (terminal-parameter frame 'terminal-initted)
|
||
(set-terminal-parameter frame 'terminal-initted t)
|
||
(set-locale-environment nil frame)
|
||
(tty-run-terminal-initialization frame))
|
||
(frame-set-background-mode frame t)
|
||
(face-set-after-frame-default frame parameters)
|
||
(setq success t))
|
||
(unless success
|
||
(delete-frame frame)))
|
||
frame))
|
||
|
||
(defun tty-find-type (pred type)
|
||
"Return the longest prefix of TYPE to which PRED returns non-nil.
|
||
TYPE should be a tty type name such as \"xterm-16color\".
|
||
|
||
The function tries only those prefixes that are followed by a
|
||
dash or underscore in the original type name, like \"xterm\" in
|
||
the above example."
|
||
(let (hyphend)
|
||
(while (and type
|
||
(not (funcall pred type)))
|
||
;; Strip off last hyphen and what follows, then try again
|
||
(setq type
|
||
(if (setq hyphend (string-match "[-_][^-_]+$" type))
|
||
(substring type 0 hyphend)
|
||
nil))))
|
||
type)
|
||
|
||
(defun tty-run-terminal-initialization (frame &optional type)
|
||
"Run the special initialization code for the terminal type of FRAME.
|
||
The optional TYPE parameter may be used to override the autodetected
|
||
terminal type to a different value."
|
||
(setq type (or type (tty-type frame)))
|
||
;; Load library for our terminal type.
|
||
;; User init file can set term-file-prefix to nil to prevent this.
|
||
(with-selected-frame frame
|
||
(unless (null term-file-prefix)
|
||
(let* (term-init-func)
|
||
;; First, load the terminal initialization file, if it is
|
||
;; available and it hasn't been loaded already.
|
||
(tty-find-type #'(lambda (type)
|
||
(let ((file (locate-library (concat term-file-prefix type))))
|
||
(and file
|
||
(or (assoc file load-history)
|
||
(load file t t)))))
|
||
type)
|
||
;; Next, try to find a matching initialization function, and call it.
|
||
(tty-find-type #'(lambda (type)
|
||
(fboundp (setq term-init-func
|
||
(intern (concat "terminal-init-" type)))))
|
||
type)
|
||
(when (fboundp term-init-func)
|
||
(funcall term-init-func))
|
||
(set-terminal-parameter frame 'terminal-initted term-init-func)))))
|
||
|
||
;; Called from C function init_display to initialize faces of the
|
||
;; dumped terminal frame on startup.
|
||
|
||
(defun tty-set-up-initial-frame-faces ()
|
||
(let ((frame (selected-frame)))
|
||
(frame-set-background-mode frame t)
|
||
(face-set-after-frame-default frame)))
|
||
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Standard faces.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
(defgroup basic-faces nil
|
||
"The standard faces of Emacs."
|
||
:group 'faces)
|
||
|
||
(defface default
|
||
'((t nil)) ; If this were nil, face-defface-spec would not be set.
|
||
"Basic default face."
|
||
:group 'basic-faces)
|
||
|
||
(defface bold
|
||
'((t :weight bold))
|
||
"Basic bold face."
|
||
:group 'basic-faces)
|
||
|
||
(defface italic
|
||
'((((supports :slant italic))
|
||
:slant italic)
|
||
(((supports :underline t))
|
||
:underline t)
|
||
(t
|
||
;; default to italic, even it doesn't appear to be supported,
|
||
;; because in some cases the display engine will do it's own
|
||
;; workaround (to `dim' on ttys)
|
||
:slant italic))
|
||
"Basic italic face."
|
||
:group 'basic-faces)
|
||
|
||
(defface bold-italic
|
||
'((t :weight bold :slant italic))
|
||
"Basic bold-italic face."
|
||
:group 'basic-faces)
|
||
|
||
(defface underline
|
||
'((((supports :underline t))
|
||
:underline t)
|
||
(((supports :weight bold))
|
||
:weight bold)
|
||
(t :underline t))
|
||
"Basic underlined face."
|
||
:group 'basic-faces)
|
||
|
||
(defface fixed-pitch
|
||
'((t :family "Monospace"))
|
||
"The basic fixed-pitch face."
|
||
:group 'basic-faces)
|
||
|
||
(defface variable-pitch
|
||
'((t :family "Sans Serif"))
|
||
"The basic variable-pitch face."
|
||
:group 'basic-faces)
|
||
|
||
(defface shadow
|
||
'((((class color grayscale) (min-colors 88) (background light))
|
||
:foreground "grey50")
|
||
(((class color grayscale) (min-colors 88) (background dark))
|
||
:foreground "grey70")
|
||
(((class color) (min-colors 8) (background light))
|
||
:foreground "green")
|
||
(((class color) (min-colors 8) (background dark))
|
||
:foreground "yellow"))
|
||
"Basic face for shadowed text."
|
||
:group 'basic-faces
|
||
:version "22.1")
|
||
|
||
(defface link
|
||
'((((class color) (min-colors 88) (background light))
|
||
:foreground "blue1" :underline t)
|
||
(((class color) (background light))
|
||
:foreground "blue" :underline t)
|
||
(((class color) (min-colors 88) (background dark))
|
||
:foreground "cyan1" :underline t)
|
||
(((class color) (background dark))
|
||
:foreground "cyan" :underline t)
|
||
(t :inherit underline))
|
||
"Basic face for unvisited links."
|
||
:group 'basic-faces
|
||
:version "22.1")
|
||
|
||
(defface link-visited
|
||
'((default :inherit link)
|
||
(((class color) (background light)) :foreground "magenta4")
|
||
(((class color) (background dark)) :foreground "violet"))
|
||
"Basic face for visited links."
|
||
:group 'basic-faces
|
||
:version "22.1")
|
||
|
||
(defface highlight
|
||
'((((class color) (min-colors 88) (background light))
|
||
:background "darkseagreen2")
|
||
(((class color) (min-colors 88) (background dark))
|
||
:background "darkolivegreen")
|
||
(((class color) (min-colors 16) (background light))
|
||
:background "darkseagreen2")
|
||
(((class color) (min-colors 16) (background dark))
|
||
:background "darkolivegreen")
|
||
(((class color) (min-colors 8))
|
||
:background "green" :foreground "black")
|
||
(t :inverse-video t))
|
||
"Basic face for highlighting."
|
||
:group 'basic-faces)
|
||
|
||
;; Region face: under NS, default to the system-defined selection
|
||
;; color (optimized for the fixed white background of other apps),
|
||
;; if background is light.
|
||
(defface region
|
||
'((((class color) (min-colors 88) (background dark))
|
||
:background "blue3")
|
||
(((class color) (min-colors 88) (background light) (type gtk))
|
||
:foreground "gtk_selection_fg_color"
|
||
:background "gtk_selection_bg_color")
|
||
(((class color) (min-colors 88) (background light) (type ns))
|
||
:background "ns_selection_color")
|
||
(((class color) (min-colors 88) (background light))
|
||
:background "lightgoldenrod2")
|
||
(((class color) (min-colors 16) (background dark))
|
||
:background "blue3")
|
||
(((class color) (min-colors 16) (background light))
|
||
:background "lightgoldenrod2")
|
||
(((class color) (min-colors 8))
|
||
:background "blue" :foreground "white")
|
||
(((type tty) (class mono))
|
||
:inverse-video t)
|
||
(t :background "gray"))
|
||
"Basic face for highlighting the region."
|
||
:version "21.1"
|
||
:group 'basic-faces)
|
||
|
||
(defface secondary-selection
|
||
'((((class color) (min-colors 88) (background light))
|
||
:background "yellow1")
|
||
(((class color) (min-colors 88) (background dark))
|
||
:background "SkyBlue4")
|
||
(((class color) (min-colors 16) (background light))
|
||
:background "yellow")
|
||
(((class color) (min-colors 16) (background dark))
|
||
:background "SkyBlue4")
|
||
(((class color) (min-colors 8))
|
||
:background "cyan" :foreground "black")
|
||
(t :inverse-video t))
|
||
"Basic face for displaying the secondary selection."
|
||
:group 'basic-faces)
|
||
|
||
(defface trailing-whitespace
|
||
'((((class color) (background light))
|
||
:background "red1")
|
||
(((class color) (background dark))
|
||
:background "red1")
|
||
(t :inverse-video t))
|
||
"Basic face for highlighting trailing whitespace."
|
||
:version "21.1"
|
||
:group 'whitespace-faces ; like `show-trailing-whitespace'
|
||
:group 'basic-faces)
|
||
|
||
(defface escape-glyph
|
||
'((((background dark)) :foreground "cyan")
|
||
;; See the comment in minibuffer-prompt for
|
||
;; the reason not to use blue on MS-DOS.
|
||
(((type pc)) :foreground "magenta")
|
||
;; red4 is too dark, but some say blue is too loud.
|
||
;; brown seems to work ok. -- rms.
|
||
(t :foreground "brown"))
|
||
"Face for characters displayed as sequences using `^' or `\\'."
|
||
:group 'basic-faces
|
||
:version "22.1")
|
||
|
||
(defface nobreak-space
|
||
'((((class color) (min-colors 88)) :inherit escape-glyph :underline t)
|
||
(((class color) (min-colors 8)) :background "magenta")
|
||
(t :inverse-video t))
|
||
"Face for displaying nobreak space."
|
||
:group 'basic-faces
|
||
:version "22.1")
|
||
|
||
(defgroup mode-line-faces nil
|
||
"Faces used in the mode line."
|
||
:group 'mode-line
|
||
:group 'faces
|
||
:version "22.1")
|
||
|
||
(defface mode-line
|
||
'((((class color) (min-colors 88))
|
||
:box (:line-width -1 :style released-button)
|
||
:background "grey75" :foreground "black")
|
||
(t
|
||
:inverse-video t))
|
||
"Basic mode line face for selected window."
|
||
:version "21.1"
|
||
:group 'mode-line-faces
|
||
:group 'basic-faces)
|
||
;; No need to define aliases of this form for new faces.
|
||
(define-obsolete-face-alias 'modeline 'mode-line "21.1")
|
||
|
||
(defface mode-line-inactive
|
||
'((default
|
||
:inherit mode-line)
|
||
(((class color) (min-colors 88) (background light))
|
||
:weight light
|
||
:box (:line-width -1 :color "grey75" :style nil)
|
||
:foreground "grey20" :background "grey90")
|
||
(((class color) (min-colors 88) (background dark) )
|
||
:weight light
|
||
:box (:line-width -1 :color "grey40" :style nil)
|
||
:foreground "grey80" :background "grey30"))
|
||
"Basic mode line face for non-selected windows."
|
||
:version "22.1"
|
||
:group 'mode-line-faces
|
||
:group 'basic-faces)
|
||
(define-obsolete-face-alias 'modeline-inactive 'mode-line-inactive "22.1")
|
||
|
||
(defface mode-line-highlight
|
||
'((((class color) (min-colors 88))
|
||
:box (:line-width 2 :color "grey40" :style released-button))
|
||
(t
|
||
:inherit highlight))
|
||
"Basic mode line face for highlighting."
|
||
:version "22.1"
|
||
:group 'mode-line-faces
|
||
:group 'basic-faces)
|
||
(define-obsolete-face-alias 'modeline-highlight 'mode-line-highlight "22.1")
|
||
|
||
(defface mode-line-emphasis
|
||
'((t (:weight bold)))
|
||
"Face used to emphasize certain mode line features.
|
||
Use the face `mode-line-highlight' for features that can be selected."
|
||
:version "23.1"
|
||
:group 'mode-line-faces
|
||
:group 'basic-faces)
|
||
|
||
(defface mode-line-buffer-id
|
||
'((t (:weight bold)))
|
||
"Face used for buffer identification parts of the mode line."
|
||
:version "22.1"
|
||
:group 'mode-line-faces
|
||
:group 'basic-faces)
|
||
(define-obsolete-face-alias 'modeline-buffer-id 'mode-line-buffer-id "22.1")
|
||
|
||
(defface header-line
|
||
'((default
|
||
:inherit mode-line)
|
||
(((type tty))
|
||
;; This used to be `:inverse-video t', but that doesn't look very
|
||
;; good when combined with inverse-video mode-lines and multiple
|
||
;; windows. Underlining looks better, and is more consistent with
|
||
;; the window-system face variants, which deemphasize the
|
||
;; header-line in relation to the mode-line face. If a terminal
|
||
;; can't underline, then the header-line will end up without any
|
||
;; highlighting; this may be too confusing in general, although it
|
||
;; happens to look good with the only current use of header-lines,
|
||
;; the info browser. XXX
|
||
:inverse-video nil ;Override the value inherited from mode-line.
|
||
:underline t)
|
||
(((class color grayscale) (background light))
|
||
:background "grey90" :foreground "grey20"
|
||
:box nil)
|
||
(((class color grayscale) (background dark))
|
||
:background "grey20" :foreground "grey90"
|
||
:box nil)
|
||
(((class mono) (background light))
|
||
:background "white" :foreground "black"
|
||
:inverse-video nil
|
||
:box nil
|
||
:underline t)
|
||
(((class mono) (background dark))
|
||
:background "black" :foreground "white"
|
||
:inverse-video nil
|
||
:box nil
|
||
:underline t))
|
||
"Basic header-line face."
|
||
:version "21.1"
|
||
:group 'basic-faces)
|
||
|
||
(defface vertical-border
|
||
'((((type tty)) :inherit mode-line-inactive))
|
||
"Face used for vertical window dividers on ttys."
|
||
:version "22.1"
|
||
:group 'basic-faces)
|
||
|
||
(defface minibuffer-prompt
|
||
'((((background dark)) :foreground "cyan")
|
||
;; Don't use blue because many users of the MS-DOS port customize
|
||
;; their foreground color to be blue.
|
||
(((type pc)) :foreground "magenta")
|
||
(t :foreground "medium blue"))
|
||
"Face for minibuffer prompts.
|
||
By default, Emacs automatically adds this face to the value of
|
||
`minibuffer-prompt-properties', which is a list of text properties
|
||
used to display the prompt text."
|
||
:version "22.1"
|
||
:group 'basic-faces)
|
||
|
||
(setq minibuffer-prompt-properties
|
||
(append minibuffer-prompt-properties (list 'face 'minibuffer-prompt)))
|
||
|
||
(defface fringe
|
||
'((((class color) (background light))
|
||
:background "grey95")
|
||
(((class color) (background dark))
|
||
:background "grey10")
|
||
(t
|
||
:background "gray"))
|
||
"Basic face for the fringes to the left and right of windows under X."
|
||
:version "21.1"
|
||
:group 'frames
|
||
:group 'basic-faces)
|
||
|
||
(defface scroll-bar '((t nil))
|
||
"Basic face for the scroll bar colors under X."
|
||
:version "21.1"
|
||
:group 'frames
|
||
:group 'basic-faces)
|
||
|
||
(defface border '((t nil))
|
||
"Basic face for the frame border under X."
|
||
:version "21.1"
|
||
:group 'frames
|
||
:group 'basic-faces)
|
||
|
||
(defface cursor
|
||
'((((background light)) :background "black")
|
||
(((background dark)) :background "white"))
|
||
"Basic face for the cursor color under X.
|
||
Note: Other faces cannot inherit from the cursor face."
|
||
:version "21.1"
|
||
:group 'cursor
|
||
:group 'basic-faces)
|
||
|
||
(put 'cursor 'face-no-inherit t)
|
||
|
||
(defface mouse '((t nil))
|
||
"Basic face for the mouse color under X."
|
||
:version "21.1"
|
||
:group 'mouse
|
||
:group 'basic-faces)
|
||
|
||
(defface tool-bar
|
||
'((default
|
||
:box (:line-width 1 :style released-button)
|
||
:foreground "black")
|
||
(((type x w32 ns) (class color))
|
||
:background "grey75")
|
||
(((type x) (class mono))
|
||
:background "grey"))
|
||
"Basic tool-bar face."
|
||
:version "21.1"
|
||
:group 'basic-faces)
|
||
|
||
(defface menu
|
||
'((((type tty))
|
||
:inverse-video t)
|
||
(((type x-toolkit))
|
||
)
|
||
(t
|
||
:inverse-video t))
|
||
"Basic face for the font and colors of the menu bar and popup menus."
|
||
:version "21.1"
|
||
:group 'menu
|
||
:group 'basic-faces)
|
||
|
||
(defface help-argument-name '((((supports :slant italic)) :inherit italic))
|
||
"Face to highlight argument names in *Help* buffers."
|
||
:group 'help)
|
||
|
||
(defface glyphless-char
|
||
'((((type tty)) :inherit underline)
|
||
(((type pc)) :inherit escape-glyph)
|
||
(t :height 0.6))
|
||
"Face for displaying non-graphic characters (e.g. U+202A (LRE)).
|
||
It is used for characters of no fonts too."
|
||
:version "24.1"
|
||
:group 'basic-faces)
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; Manipulating font names.
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
;; This is here for compatibilty with Emacs 20.2. For example,
|
||
;; international/fontset.el uses x-resolve-font-name. The following
|
||
;; functions are not used in the face implementation itself.
|
||
|
||
(defvar x-font-regexp nil)
|
||
(defvar x-font-regexp-head nil)
|
||
(defvar x-font-regexp-weight nil)
|
||
(defvar x-font-regexp-slant nil)
|
||
|
||
(defconst x-font-regexp-weight-subnum 1)
|
||
(defconst x-font-regexp-slant-subnum 2)
|
||
(defconst x-font-regexp-swidth-subnum 3)
|
||
(defconst x-font-regexp-adstyle-subnum 4)
|
||
|
||
;;; Regexps matching font names in "Host Portable Character Representation."
|
||
;;;
|
||
(let ((- "[-?]")
|
||
(foundry "[^-]+")
|
||
(family "[^-]+")
|
||
(weight "\\(bold\\|demibold\\|medium\\)") ; 1
|
||
; (weight\? "\\(\\*\\|bold\\|demibold\\|medium\\|\\)") ; 1
|
||
(weight\? "\\([^-]*\\)") ; 1
|
||
(slant "\\([ior]\\)") ; 2
|
||
; (slant\? "\\([ior?*]?\\)") ; 2
|
||
(slant\? "\\([^-]?\\)") ; 2
|
||
; (swidth "\\(\\*\\|normal\\|semicondensed\\|\\)") ; 3
|
||
(swidth "\\([^-]*\\)") ; 3
|
||
; (adstyle "\\(\\*\\|sans\\|\\)") ; 4
|
||
(adstyle "\\([^-]*\\)") ; 4
|
||
(pixelsize "[0-9]+")
|
||
(pointsize "[0-9][0-9]+")
|
||
(resx "[0-9][0-9]+")
|
||
(resy "[0-9][0-9]+")
|
||
(spacing "[cmp?*]")
|
||
(avgwidth "[0-9]+")
|
||
(registry "[^-]+")
|
||
(encoding "[^-]+")
|
||
)
|
||
(setq x-font-regexp
|
||
(purecopy (concat "\\`\\*?[-?*]"
|
||
foundry - family - weight\? - slant\? - swidth - adstyle -
|
||
pixelsize - pointsize - resx - resy - spacing - avgwidth -
|
||
registry - encoding "\\*?\\'"
|
||
)))
|
||
(setq x-font-regexp-head
|
||
(purecopy (concat "\\`[-?*]" foundry - family - weight\? - slant\?
|
||
"\\([-*?]\\|\\'\\)")))
|
||
(setq x-font-regexp-slant (purecopy (concat - slant -)))
|
||
(setq x-font-regexp-weight (purecopy (concat - weight -)))
|
||
nil)
|
||
|
||
|
||
(defun x-resolve-font-name (pattern &optional face frame)
|
||
"Return a font name matching PATTERN.
|
||
All wildcards in PATTERN are instantiated.
|
||
If PATTERN is nil, return the name of the frame's base font, which never
|
||
contains wildcards.
|
||
Given optional arguments FACE and FRAME, return a font which is
|
||
also the same size as FACE on FRAME, or fail."
|
||
(or (symbolp face)
|
||
(setq face (face-name face)))
|
||
(and (eq frame t)
|
||
(setq frame nil))
|
||
(if pattern
|
||
;; Note that x-list-fonts has code to handle a face with nil as its font.
|
||
(let ((fonts (x-list-fonts pattern face frame 1)))
|
||
(or fonts
|
||
(if face
|
||
(if (string-match "\\*" pattern)
|
||
(if (null (face-font face))
|
||
(error "No matching fonts are the same height as the frame default font")
|
||
(error "No matching fonts are the same height as face `%s'" face))
|
||
(if (null (face-font face))
|
||
(error "Height of font `%s' doesn't match the frame default font"
|
||
pattern)
|
||
(error "Height of font `%s' doesn't match face `%s'"
|
||
pattern face)))
|
||
(error "No fonts match `%s'" pattern)))
|
||
(car fonts))
|
||
(cdr (assq 'font (frame-parameters (selected-frame))))))
|
||
|
||
(provide 'faces)
|
||
|
||
;;; faces.el ends here
|