(U-000230C4): New character.
[chise/xemacs-chise.git.1] / lisp / disp-table.el
1 ;;; disp-table.el --- functions for dealing with char tables.
2
3 ;; Copyright (C) 1987, 1994, 1997 Free Software Foundation, Inc.
4 ;; Copyright (C) 1995 Sun Microsystems.
5
6 ;; Author: Howard Gayle
7 ;; Maintainer: XEmacs Development Team
8 ;; Keywords: i18n, internal
9
10 ;; This file is part of XEmacs.
11
12 ;; XEmacs is free software; you can redistribute it and/or modify it
13 ;; under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation; either version 2, or (at your option)
15 ;; any later version.
16
17 ;; XEmacs is distributed in the hope that it will be useful, but
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
20 ;; General Public License for more details.
21
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with XEmacs; see the file COPYING.  If not, write to the 
24 ;; Free Software Foundation, 59 Temple Place - Suite 330,
25 ;; Boston, MA 02111-1307, USA.
26
27 ;;; Synched up with: Not synched with FSF.
28
29 ;;; Commentary:
30
31 ;; #### Need lots of work.  make-display-table depends on a value
32 ;; that is a define in the C code.  Maybe we should just move the
33 ;; function into C.
34
35 ;; #### display-tables-as-vectors is really evil and a big pain in
36 ;; the ass.
37
38 ;; Rewritten for XEmacs July 1995, Ben Wing.
39
40 \f
41 ;;; Code:
42
43 (defun describe-display-table (dt)
44   "Describe the display table DT in a help buffer."
45   (with-displaying-help-buffer
46    (lambda ()
47      (princ "\nCharacter display glyph sequences:\n")
48      (save-excursion
49        (let ((vector (make-vector 256 nil))
50              (i 0))
51          (while (< i 256)
52            (aset vector i (aref dt i))
53            (incf i))
54          ;; FSF calls `describe-vector' here, but it is so incredibly
55          ;; lame a function for that name that I cannot bring myself
56          ;; to porting it.  Here is what `describe-vector' does:
57          (terpri)
58          (let ((old (aref vector 0))
59                (oldpos 0)
60                (i 1)
61                str)
62            (while (<= i 256)
63              (when (or (= i 256)
64                        (not (equal old (aref vector i))))
65                (if (eq oldpos (1- i))
66                    (princ (format "%s\t\t%s\n"
67                                   (single-key-description (int-char oldpos))
68                                   old))
69                  (setq str (format "%s - %s"
70                                    (single-key-description (int-char oldpos))
71                                    (single-key-description (int-char (1- i)))))
72                  (princ str)
73                  (princ (make-string (max (- 2 (/ (length str)
74                                                   tab-width)) 1) ?\t))
75                  (princ old)
76                  (terpri))
77                (or (= i 256)
78                    (setq old (aref vector i)
79                          oldpos i)))
80              (incf i))))))))
81
82 ;;;###autoload
83 (defun describe-current-display-table (&optional domain)
84   "Describe the display table in use in the selected window and buffer."
85   (interactive)
86   (or domain (setq domain (selected-window)))
87   (let ((disptab (specifier-instance current-display-table domain)))
88     (if disptab
89         (describe-display-table disptab)
90       (message "No display table"))))
91
92 ;;;###autoload
93 (defun make-display-table ()
94   "Return a new, empty display table."
95   (make-vector 256 nil))
96
97 ;; #### we need a generic frob-specifier function.
98 ;; #### this also needs to be redone like frob-face-property.
99
100 ;; Let me say one more time how much dynamic scoping sucks.
101
102 (defun frob-display-table (fdt-function fdt-locale)
103   (or fdt-locale (setq fdt-locale 'global))
104   (or (specifier-spec-list current-display-table fdt-locale)
105       (add-spec-to-specifier current-display-table (make-display-table)
106                              fdt-locale))
107   (add-spec-list-to-specifier
108    current-display-table
109    (list (cons fdt-locale
110                (mapcar
111                 (lambda (fdt-x)
112                   (funcall fdt-function (cdr fdt-x))
113                   fdt-x)
114                 (cdar (specifier-spec-list current-display-table
115                                            fdt-locale)))))))
116
117 (defun standard-display-8bit-1 (dt l h)
118   (while (<= l h)
119     (aset dt l (char-to-string l))
120     (setq l (1+ l))))
121
122 ;;;###autoload
123 (defun standard-display-8bit (l h &optional locale)
124   "Display characters in the range L to H literally."
125   (frob-display-table
126    (lambda (x)
127      (standard-display-8bit-1 x l h))
128    locale))
129
130 (defun standard-display-default-1 (dt l h)
131   (while (<= l h)
132     (aset dt l nil)
133     (setq l (1+ l))))
134
135 ;;;###autoload
136 (defun standard-display-default (l h &optional locale)
137   "Display characters in the range L to H using the default notation."
138   (frob-display-table
139    (lambda (x)
140      (standard-display-default-1 x l h))
141    locale))
142
143 ;;;###autoload
144 (defun standard-display-ascii (c s &optional locale)
145   "Display character C using printable string S."
146   (frob-display-table
147    (lambda (x)
148      (aset x c s))
149    locale))
150
151
152 ;;; #### should frob in a 'tty locale.
153
154 ;;;###autoload
155 (defun standard-display-g1 (c sc &optional locale)
156   "Display character C as character SC in the g1 character set.
157 This function assumes that your terminal uses the SO/SI characters;
158 it is meaningless for an X frame."
159   (frob-display-table
160    (lambda (x)
161      (aset x c (concat "\016" (char-to-string sc) "\017")))
162    locale))
163
164
165 ;;; #### should frob in a 'tty locale.
166
167 ;;;###autoload
168 (defun standard-display-graphic (c gc &optional locale)
169   "Display character C as character GC in graphics character set.
170 This function assumes VT100-compatible escapes; it is meaningless for an
171 X frame."
172   (frob-display-table
173    (lambda (x)
174      (aset x c (concat "\e(0" (char-to-string gc) "\e(B")))
175    locale))
176
177 ;;; #### should frob in a 'tty locale.
178 ;;; #### the FSF equivalent of this makes this character be displayed
179 ;;; in the 'underline face.  There's no current way to do this with
180 ;;; XEmacs display tables.
181
182 ;;;###autoload
183 (defun standard-display-underline (c uc &optional locale)
184   "Display character C as character UC plus underlining."
185   (frob-display-table
186    (lambda (x)
187      (aset x c (concat "\e[4m" (char-to-string uc) "\e[m")))
188    locale))
189
190 ;;;###autoload
191 (defun standard-display-european (arg &optional locale)
192   "Toggle display of European characters encoded with ISO 8859.
193 When enabled, characters in the range of 160 to 255 display not
194 as octal escapes, but as accented characters.
195 With prefix argument, enable European character display iff arg is positive."
196   (interactive "P")
197   (frob-display-table
198    (lambda (x)
199      (if (or (<= (prefix-numeric-value arg) 0)
200              (and (null arg)
201                   (equal (aref x 160) (char-to-string 160))))
202          (standard-display-default-1 x 160 255)
203        (standard-display-8bit-1 x 160 255)))
204    locale))
205
206 (provide 'disp-table)
207
208 ;;; disp-table.el ends here