(Fxw_color_values): Return 3-element list. Doc fix.
[emacs.git] / lisp / gnus / compface.el
blob37515336151d57e410d30b7c0e7680869809f521
1 ;;; compface.el --- functions for converting X-Face headers
3 ;; Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
5 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
6 ;; Keywords: news
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software: you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation, either version 3 of the License, or
13 ;; (at your option) any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
23 ;;; Commentary:
25 ;;; Code:
27 ;;;###
28 (defun uncompface (face)
29 "Convert FACE to pbm.
30 Requires the external programs `uncompface', and `icontopbm'. On a
31 GNU/Linux system these might be in packages with names like `compface'
32 or `faces-xface' and `netpbm' or `libgr-progs', for instance."
33 (with-temp-buffer
34 (unless (featurep 'xemacs) (set-buffer-multibyte nil))
35 (insert face)
36 (let ((coding-system-for-read 'raw-text)
37 ;; At least "icontopbm" doesn't work with Windows because
38 ;; the line-break code is converted into CRLF by default.
39 (coding-system-for-write 'binary))
40 (and (eq 0 (apply 'call-process-region (point-min) (point-max)
41 "uncompface"
42 'delete '(t nil) nil))
43 (progn
44 (goto-char (point-min))
45 (insert "/* Width=48, Height=48 */\n")
46 ;; I just can't get "icontopbm" to work correctly on its
47 ;; own in XEmacs. And Emacs doesn't understand un-raw pbm
48 ;; files.
49 (if (not (featurep 'xemacs))
50 (eq 0 (call-process-region (point-min) (point-max)
51 "icontopbm"
52 'delete '(t nil)))
53 (shell-command-on-region (point-min) (point-max)
54 "icontopbm | pnmnoraw"
55 (current-buffer) t)
56 t))
57 (buffer-string)))))
59 (provide 'compface)
61 ;; arch-tag: f9c78e84-98c0-4142-9682-8ba4cf4c3441
62 ;;; compface.el ends here