Mercurial > hg > xemacs-beta
diff lisp/cus-face.el @ 209:41ff10fd062f r20-4b3
Import from CVS: tag r20-4b3
author | cvs |
---|---|
date | Mon, 13 Aug 2007 10:04:58 +0200 |
parents | |
children | 78f53ef88e17 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/lisp/cus-face.el Mon Aug 13 10:04:58 2007 +0200 @@ -0,0 +1,255 @@ +;;; cus-face.el -- Support for Custom faces. +;; +;; Copyright (C) 1996, 1997 Free Software Foundation, Inc. +;; +;; Author: Per Abrahamsen <abraham@dina.kvl.dk> +;; Maintainer: Hrvoje Niksic <hniksic@srce.hr> +;; Keywords: help, faces +;; Version: 1.9960-x +;; X-URL: http://www.dina.kvl.dk/~abraham/custom/ + +;;; Commentary: +;; +;; See `custom.el'. + +;; This file should probably be dissolved, and code moved to faces.el, +;; like Stallman did. + +;;; Code: + +(require 'custom) + +;; To elude the warnings for font functions. +(eval-when-compile + (require 'font)) + +;;; Declaring a face. + +;;;###autoload +(defun custom-declare-face (face spec doc &rest args) + "Like `defface', but FACE is evaluated as a normal argument." + ;; (when (fboundp 'load-gc) + ;; (error "Attempt to declare a face during dump")) + (unless (get face 'face-defface-spec) + (put face 'face-defface-spec spec) + (unless (find-face face) + ;; If the user has already created the face, respect that. + (let ((value (or (get face 'saved-face) spec)) + (frames (relevant-custom-frames)) + frame) + ;; Create global face. + (make-empty-face face) + (face-display-set face value) + ;; Create frame local faces + (while frames + (setq frame (car frames) + frames (cdr frames)) + (face-display-set face value frame)) + (init-face-from-resources face))) + (when (and doc (null (face-doc-string face))) + (set-face-doc-string face doc)) + (custom-handle-all-keywords face args 'custom-face) + (run-hooks 'custom-define-hook)) + face) + +;;; Font Attributes. + +(defconst custom-face-attributes + '((:bold (boolean :tag "Bold" + :help-echo "Control whether a bold font should be used.") + custom-set-face-bold custom-face-bold) + (:italic (boolean :tag "Italic" + :help-echo "\ +Control whether an italic font should be used.") + custom-set-face-italic custom-face-italic) + (:underline (boolean :tag "Underline" + :help-echo "\ +Control whether the text should be underlined.") + set-face-underline-p face-underline-p) + (:foreground (color :tag "Foreground" + :value "" + :help-echo "Set foreground color.") + set-face-foreground face-foreground-name) + (:background (color :tag "Background" + :value "" + :help-echo "Set background color.") + set-face-background face-background-name) + ;; #### Should make it work on X + (:inverse-video (boolean :tag "Inverse" + :help-echo "\ +Control whether the text should be inverted. Works only on TTY-s") + set-face-reverse-p face-reverse-p) + (:stipple (editable-field :format "Stipple: %v" + :help-echo "Name of background bitmap file.") + set-face-background-pixmap custom-face-stipple) + (:family (editable-field :format "Font Family: %v" + :help-echo "\ +Name of font family to use (e.g. times).") + custom-set-face-font-family custom-face-font-family) + (:size (editable-field :format "Size: %v" + :help-echo "\ +Text size (e.g. 9pt or 2mm).") + custom-set-face-font-size custom-face-font-size) + (:strikethru (toggle :format "%[Strikethru%]: %v\n" + :help-echo "\ +Control whether the text should be strikethru.") + set-face-strikethru-p face-strikethru-p)) + "Alist of face attributes. + +The elements are of the form (KEY TYPE SET GET) where KEY is a symbol +identifying the attribute, TYPE is a widget type for editing the +attibute, SET is a function for setting the attribute value, and GET is a function for getiing the attribute value. + +The SET function should take three arguments, the face to modify, the +value of the attribute, and optionally the frame where the face should +be changed. + +The GET function should take two arguments, the face to examine, and +optonally the frame where the face should be examined.") + +(defun face-custom-attributes-set (face frame &rest atts) + "For FACE on FRAME set the attributes [KEYWORD VALUE].... +Each keyword should be listed in `custom-face-attributes'. + +If FRAME is nil, set the default face." + (while atts + (let* ((name (nth 0 atts)) + (value (nth 1 atts)) + (fun (nth 2 (assq name custom-face-attributes)))) + (setq atts (cdr (cdr atts))) + (condition-case nil + (funcall fun face value frame) + (error nil))))) + +(defun face-custom-attributes-get (face frame) + "For FACE on FRAME get the attributes [KEYWORD VALUE].... +Each keyword should be listed in `custom-face-attributes'. + +If FRAME is nil, use the default face." + (condition-case nil + ;; Attempt to get `font.el' from w3. + (require 'font) + (error nil)) + (let ((atts custom-face-attributes) + att result get) + (while atts + (setq att (car atts) + atts (cdr atts) + get (nth 3 att)) + (condition-case nil + ;; This may fail if w3 doesn't exists. + (when get + (let ((answer (funcall get face frame))) + (unless (equal answer (funcall get 'default frame)) + (when (widget-apply (nth 1 att) :match answer) + (setq result (cons (nth 0 att) (cons answer result))))))) + (error nil))) + result)) + +(defun custom-set-face-bold (face value &optional frame) + "Set the bold property of FACE to VALUE." + (if value + (make-face-bold face frame) + (make-face-unbold face frame))) + +;; Really, we should get rid of these font.el dependencies... They +;; are still presenting a problem with dumping the faces (font.el is +;; too bloated for us to dump). I am thinking about hacking up +;; font-like functionality myself for the sake of this file. It will +;; probably be to-the-point and more efficient. + +(defun custom-face-bold (face &rest args) + "Return non-nil if the font of FACE is bold." + (let* ((font (apply 'face-font-name face args)) + ;; Gag + (fontobj (font-create-object font))) + (font-bold-p fontobj))) + +(defun custom-set-face-italic (face value &optional frame) + "Set the italic property of FACE to VALUE." + (if value + (make-face-italic face frame) + (make-face-unitalic face frame))) + +(defun custom-face-italic (face &rest args) + "Return non-nil if the font of FACE is italic." + (let* ((font (apply 'face-font-name face args)) + ;; Gag + (fontobj (font-create-object font))) + (font-italic-p fontobj))) + +(defun custom-face-stipple (face &rest args) + "Return the name of the stipple file used for FACE." + (let ((image (apply 'specifier-instance + (face-background-pixmap face) args))) + (and image + (image-instance-file-name image)))) + +(defun custom-set-face-font-size (face size &rest args) + "Set the font of FACE to SIZE" + (let* ((font (apply 'face-font-name face args)) + ;; Gag + (fontobj (font-create-object font))) + (set-font-size fontobj size) + (apply 'font-set-face-font face fontobj args))) + +(defun custom-face-font-size (face &rest args) + "Return the size of the font of FACE as a string." + (let* ((font (apply 'face-font-name face args)) + ;; Gag + (fontobj (font-create-object font))) + (format "%s" (font-size fontobj)))) + +(defun custom-set-face-font-family (face family &rest args) + "Set the font of FACE to FAMILY." + (let* ((font (apply 'face-font-name face args)) + ;; Gag + (fontobj (font-create-object font))) + (set-font-family fontobj family) + (apply 'font-set-face-font face fontobj args))) + +(defun custom-face-font-family (face &rest args) + "Return the name of the font family of FACE." + (let* ((font (apply 'face-font-name face args)) + ;; Gag + (fontobj (font-create-object font))) + (font-family fontobj))) + +;;; Initializing. + +;;;###autoload +(defun custom-set-faces (&rest args) + "Initialize faces according to user preferences. +The arguments should be a list where each entry has the form: + + (FACE SPEC [NOW]) + +SPEC will be stored as the saved value for FACE. If NOW is present +and non-nil, FACE will also be created according to SPEC. + +See `defface' for the format of SPEC." + (while args + (let ((entry (car args))) + (if (listp entry) + (let ((face (nth 0 entry)) + (spec (nth 1 entry)) + (now (nth 2 entry))) + (put face 'saved-face spec) + (when now + (put face 'force-face t)) + (when (or now (find-face face)) + (unless (find-face face) + (make-empty-face face)) + (face-spec-set face spec)) + (setq args (cdr args))) + ;; Old format, a plist of FACE SPEC pairs. + (let ((face (nth 0 args)) + (spec (nth 1 args))) + (put face 'saved-face spec)) + (setq args (cdr (cdr args))))))) + +;;; The End. + +(provide 'cus-face) + +;; cus-face.el ends here