Followup to 2011-10-19T09:48:35Z!eliz@gnu.org.
[bpt/emacs.git] / lisp / composite.el
CommitLineData
60370d40 1;;; composite.el --- support character composition
c674f351 2
409cc4a3 3;; Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
5df4f04c 4;; 2008, 2009, 2010, 2011
ce03bf76
KH
5;; National Institute of Advanced Industrial Science and Technology (AIST)
6;; Registration Number H14PRO021
c674f351 7
c3fba29d
GM
8;; Author: Kenichi HANDA <handa@etl.go.jp>
9;; (according to ack.texi)
c674f351 10;; Keywords: mule, multilingual, character composition
bd78fa1d 11;; Package: emacs
c674f351
KH
12
13;; This file is part of GNU Emacs.
14
eb3fa2cf 15;; GNU Emacs is free software: you can redistribute it and/or modify
c674f351 16;; it under the terms of the GNU General Public License as published by
eb3fa2cf
GM
17;; the Free Software Foundation, either version 3 of the License, or
18;; (at your option) any later version.
c674f351
KH
19
20;; GNU Emacs is distributed in the hope that it will be useful,
21;; but WITHOUT ANY WARRANTY; without even the implied warranty of
22;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23;; GNU General Public License for more details.
24
25;; You should have received a copy of the GNU General Public License
eb3fa2cf 26;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
c674f351 27
60370d40
PJ
28;;; Commentary:
29
c674f351
KH
30;;; Code:
31
07d7c3bd
JB
32(eval-when-compile (require 'cl))
33
c674f351
KH
34(defconst reference-point-alist
35 '((tl . 0) (tc . 1) (tr . 2)
36 (Bl . 3) (Bc . 4) (Br . 5)
37 (bl . 6) (bc . 7) (br . 8)
38 (cl . 9) (cc . 10) (cr . 11)
39 (top-left . 0) (top-center . 1) (top-right . 2)
40 (base-left . 3) (base-center . 4) (base-right . 5)
41 (bottom-left . 6) (bottom-center . 7) (bottom-right . 8)
42 (center-left . 9) (center-center . 10) (center-right . 11)
43 ;; For backward compatibility...
44 (ml . 3) (mc . 10) (mr . 5)
45 (mid-left . 3) (mid-center . 10) (mid-right . 5))
46 "Alist of symbols vs integer codes of glyph reference points.
47A glyph reference point symbol is to be used to specify a composition
1d1af02d 48rule in COMPONENTS argument to such functions as `compose-region'.
c674f351 49
4f27f7d2 50The meaning of glyph reference point codes is as follows:
c674f351
KH
51
52 0----1----2 <---- ascent 0:tl or top-left
53 | | 1:tc or top-center
54 | | 2:tr or top-right
55 | | 3:Bl or base-left 9:cl or center-left
56 9 10 11 <---- center 4:Bc or base-center 10:cc or center-center
57 | | 5:Br or base-right 11:cr or center-right
58 --3----4----5-- <-- baseline 6:bl or bottom-left
59 | | 7:bc or bottom-center
60 6----7----8 <---- descent 8:br or bottom-right
61
62Glyph reference point symbols are to be used to specify composition
63rule of the form \(GLOBAL-REF-POINT . NEW-REF-POINT), where
64GLOBAL-REF-POINT is a reference point in the overall glyphs already
65composed, and NEW-REF-POINT is a reference point in the new glyph to
66be added.
67
68For instance, if GLOBAL-REF-POINT is `br' (bottom-right) and
8f625692 69NEW-REF-POINT is `tc' (top-center), the overall glyph is updated as
c674f351
KH
70follows (the point `*' corresponds to both reference points):
71
72 +-------+--+ <--- new ascent
73 | | |
74 | global| |
75 | glyph | |
76 -- | | |-- <--- baseline \(doesn't change)
77 +----+--*--+
78 | | new |
79 | |glyph|
80 +----+-----+ <--- new descent
9c87e5c4
KH
81
82A composition rule may have the form \(GLOBAL-REF-POINT
07d7c3bd 83NEW-REF-POINT XOFF YOFF), where XOFF and YOFF specify how much
9c87e5c4
KH
84to shift NEW-REF-POINT from GLOBAL-REF-POINT. In this case, XOFF
85and YOFF are integers in the range -100..100 representing the
86shifting percentage against the font size.")
c674f351 87
c674f351 88
59a2dac0 89;;;###autoload
c674f351 90(defun encode-composition-rule (rule)
59a2dac0
KH
91 "Encode composition rule RULE into an integer value.
92RULE is a cons of global and new reference point symbols
2624e2ac 93\(see `reference-point-alist')."
59a2dac0
KH
94
95 ;; This must be compatible with C macro COMPOSITION_ENCODE_RULE
96 ;; defined in composite.h.
97
c674f351
KH
98 (if (and (integerp rule) (< rule 144))
99 ;; Already encoded.
100 rule
9c87e5c4
KH
101 (if (consp rule)
102 (let ((gref (car rule))
103 (nref (cdr rule))
104 xoff yoff)
105 (if (consp nref) ; (GREF NREF XOFF YOFF)
106 (progn
107 (setq xoff (nth 1 nref)
108 yoff (nth 2 nref)
109 nref (car nref))
110 (or (and (>= xoff -100) (<= xoff 100)
111 (>= yoff -100) (<= yoff 100))
ad1b4641 112 (error "Invalid composition rule: %s" rule))
9c87e5c4
KH
113 (setq xoff (+ xoff 128) yoff (+ yoff 128)))
114 ;; (GREF . NREF)
115 (setq xoff 0 yoff 0))
116 (or (integerp gref)
117 (setq gref (cdr (assq gref reference-point-alist))))
118 (or (integerp nref)
119 (setq nref (cdr (assq nref reference-point-alist))))
120 (or (and (>= gref 0) (< gref 12) (>= nref 0) (< nref 12))
121 (error "Invalid composition rule: %S" rule))
122 (logior (lsh xoff 16) (lsh yoff 8) (+ (* gref 12) nref)))
123 (error "Invalid composition rule: %S" rule))))
c674f351
KH
124
125;; Decode encoded composition rule RULE-CODE. The value is a cons of
126;; global and new reference point symbols.
127;; This must be compatible with C macro COMPOSITION_DECODE_RULE
128;; defined in composite.h.
129
130(defun decode-composition-rule (rule-code)
9c87e5c4 131 (or (and (natnump rule-code) (< rule-code #x1000000))
c674f351 132 (error "Invalid encoded composition rule: %S" rule-code))
9c87e5c4
KH
133 (let ((xoff (lsh rule-code -16))
134 (yoff (logand (lsh rule-code -8) #xFF))
135 gref nref)
136 (setq rule-code (logand rule-code #xFF)
137 gref (car (rassq (/ rule-code 12) reference-point-alist))
138 nref (car (rassq (% rule-code 12) reference-point-alist)))
c674f351
KH
139 (or (and gref (symbolp gref) nref (symbolp nref))
140 (error "Invalid composition rule code: %S" rule-code))
9c87e5c4
KH
141 (if (and (= xoff 0) (= yoff 0))
142 (cons gref nref)
143 (setq xoff (- xoff 128) yoff (- yoff 128))
144 (list gref xoff yoff nref))))
c674f351
KH
145
146;; Encode composition rules in composition components COMPONENTS. The
147;; value is a copy of COMPONENTS, where composition rules (cons of
148;; global and new glyph reference point symbols) are replaced with
149;; encoded composition rules. Optional 2nd argument NOCOPY non-nil
150;; means don't make a copy but modify COMPONENTS directly.
151
152(defun encode-composition-components (components &optional nocopy)
153 (or nocopy
154 (setq components (copy-sequence components)))
155 (if (vectorp components)
156 (let ((len (length components))
157 (i 1))
158 (while (< i len)
159 (aset components i
160 (encode-composition-rule (aref components i)))
161 (setq i (+ i 2))))
162 (let ((tail (cdr components)))
163 (while tail
164 (setcar tail
165 (encode-composition-rule (car tail)))
166 (setq tail (nthcdr 2 tail)))))
167 components)
168
169;; Decode composition rule codes in composition components COMPONENTS.
170;; The value is a copy of COMPONENTS, where composition rule codes are
171;; replaced with composition rules (cons of global and new glyph
172;; reference point symbols). Optional 2nd argument NOCOPY non-nil
173;; means don't make a copy but modify COMPONENTS directly.
174;; It is assumed that COMPONENTS is a vector and is for rule-base
175;; composition, thus (2N+1)th elements are rule codes.
176
177(defun decode-composition-components (components &optional nocopy)
178 (or nocopy
179 (setq components (copy-sequence components)))
180 (let ((len (length components))
181 (i 1))
182 (while (< i len)
183 (aset components i
184 (decode-composition-rule (aref components i)))
185 (setq i (+ i 2))))
186 components)
187
c674f351
KH
188(defun compose-region (start end &optional components modification-func)
189 "Compose characters in the current region.
190
b6cac59c
KH
191Characters are composed relatively, i.e. composed by overstriking
192or stacking depending on ascent, descent and other metrics of
193glyphs.
194
195For instance, if the region has three characters \"XYZ\", X is
196regarded as BASE glyph, and Y is displayed:
197 (1) above BASE if Y's descent value is not positive
198 (2) below BASE if Y's ascent value is not positive
199 (3) on BASE (i.e. at the BASE position) otherwise
200and Z is displayed with the same rule while regarding the whole
201XY glyphs as BASE.
c9f60860 202
c674f351
KH
203When called from a program, expects these four arguments.
204
205First two arguments START and END are positions (integers or markers)
206specifying the region.
207
1d1af02d
DL
208Optional 3rd argument COMPONENTS, if non-nil, is a character, a string
209or a vector or list of integers and rules.
c674f351
KH
210
211If it is a character, it is an alternate character to display instead
212of the text in the region.
213
c0cd1255
KH
214If it is a string, the elements are alternate characters. In
215this case, TAB element has a special meaning. If the first
51e4f4a8 216character is TAB, the glyphs are displayed with left padding space
c0cd1255 217so that no pixel overlaps with the previous column. If the last
4f27f7d2 218character is TAB, the glyphs are displayed with right padding
c0cd1255 219space so that no pixel overlaps with the following column.
c674f351
KH
220
221If it is a vector or list, it is a sequence of alternate characters and
222composition rules, where (2N)th elements are characters and (2N+1)th
223elements are composition rules to specify how to compose (2N+2)th
224elements with previously composed N glyphs.
225
226A composition rule is a cons of global and new glyph reference point
227symbols. See the documentation of `reference-point-alist' for more
4f27f7d2 228details.
c674f351
KH
229
230Optional 4th argument MODIFICATION-FUNC is a function to call to
231adjust the composition when it gets invalid because of a change of
232text in the composition."
233 (interactive "r")
234 (let ((modified-p (buffer-modified-p))
09d52401 235 (inhibit-read-only t))
c674f351
KH
236 (if (or (vectorp components) (listp components))
237 (setq components (encode-composition-components components)))
238 (compose-region-internal start end components modification-func)
6b61353c 239 (restore-buffer-modified-p modified-p)))
c674f351 240
c674f351
KH
241(defun decompose-region (start end)
242 "Decompose text in the current region.
243
244When called from a program, expects two arguments,
245positions (integers or markers) specifying the region."
246 (interactive "r")
247 (let ((modified-p (buffer-modified-p))
09d52401 248 (inhibit-read-only t))
c674f351 249 (remove-text-properties start end '(composition nil))
09d52401 250 (restore-buffer-modified-p modified-p)))
c674f351 251
c674f351
KH
252(defun compose-string (string &optional start end components modification-func)
253 "Compose characters in string STRING.
254
c1750694 255The return value is STRING with the `composition' property put on all
c674f351
KH
256the characters in it.
257
258Optional 2nd and 3rd arguments START and END specify the range of
c1750694 259STRING to be composed. They default to the beginning and the end of
c674f351
KH
260STRING respectively.
261
262Optional 4th argument COMPONENTS, if non-nil, is a character or a
263sequence (vector, list, or string) of integers. See the function
264`compose-region' for more detail.
265
266Optional 5th argument MODIFICATION-FUNC is a function to call to
267adjust the composition when it gets invalid because of a change of
268text in the composition."
269 (if (or (vectorp components) (listp components))
270 (setq components (encode-composition-components components)))
271 (or start (setq start 0))
272 (or end (setq end (length string)))
273 (compose-string-internal string start end components modification-func)
274 string)
275
c674f351
KH
276(defun decompose-string (string)
277 "Return STRING where `composition' property is removed."
278 (remove-text-properties 0 (length string) '(composition nil) string)
279 string)
280
c674f351
KH
281(defun compose-chars (&rest args)
282 "Return a string from arguments in which all characters are composed.
283For relative composition, arguments are characters.
284For rule-based composition, Mth \(where M is odd) arguments are
285characters, and Nth \(where N is even) arguments are composition rules.
286A composition rule is a cons of glyph reference points of the form
287\(GLOBAL-REF-POINT . NEW-REF-POINT). See the documentation of
288`reference-point-alist' for more detail."
289 (let (str components)
290 (if (consp (car (cdr args)))
291 ;; Rule-base composition.
06b60517 292 (let ((tail (encode-composition-components args 'nocopy)))
c674f351
KH
293 (while tail
294 (setq str (cons (car tail) str))
295 (setq tail (nthcdr 2 tail)))
296 (setq str (concat (nreverse str))
297 components args))
298 ;; Relative composition.
299 (setq str (concat args)))
300 (compose-string-internal str 0 (length str) components)))
301
c674f351 302(defun find-composition (pos &optional limit string detail-p)
9a6eb156 303 "Return information about a composition at or near buffer position POS.
c674f351
KH
304
305If the character at POS has `composition' property, the value is a list
9a6eb156 306\(FROM TO VALID-P).
c674f351
KH
307
308FROM and TO specify the range of text that has the same `composition'
8b1c87bf 309property, VALID-P is t if this composition is valid, and nil if not.
c674f351
KH
310
311If there's no composition at POS, and the optional 2nd argument LIMIT
9a6eb156 312is non-nil, search for a composition toward the position given by LIMIT.
c674f351
KH
313
314If no composition is found, return nil.
315
316Optional 3rd argument STRING, if non-nil, is a string to look for a
317composition in; nil means the current buffer.
318
319If a valid composition is found and the optional 4th argument DETAIL-P
9a6eb156
EZ
320is non-nil, the return value is a list of the form
321
322 (FROM TO COMPONENTS RELATIVE-P MOD-FUNC WIDTH)
c674f351
KH
323
324COMPONENTS is a vector of integers, the meaning depends on RELATIVE-P.
325
326RELATIVE-P is t if the composition method is relative, else nil.
327
328If RELATIVE-P is t, COMPONENTS is a vector of characters to be
329composed. If RELATIVE-P is nil, COMPONENTS is a vector of characters
330and composition rules as described in `compose-region'.
331
332MOD-FUNC is a modification function of the composition.
333
8b1c87bf
KH
334WIDTH is a number of columns the composition occupies on the screen.
335
d21133bc 336When Automatic Composition mode is on, this function also finds a
8b1c87bf
KH
337chunk of text that is automatically composed. If such a chunk is
338found closer to POS than the position that has `composition'
9a6eb156
EZ
339property, the value is a list of FROM, TO, and a glyph-string
340that specifies how the chunk is to be composed. See the function
341`composition-get-gstring' for the format of the glyph-string."
c674f351 342 (let ((result (find-composition-internal pos limit string detail-p)))
8b1c87bf 343 (if (and detail-p (> (length result) 3) (nth 2 result) (not (nth 3 result)))
c674f351
KH
344 ;; This is a valid rule-base composition.
345 (decode-composition-components (nth 2 result) 'nocopy))
346 result))
347
348\f
7141ee65 349(defun compose-chars-after (pos &optional limit object)
c674f351
KH
350 "Compose characters in current buffer after position POS.
351
67125135
KH
352It looks up the char-table `composition-function-table' (which
353see) by a character at POS, and compose characters after POS
354according to the contents of `composition-function-table'.
355
356Optional 2nd arg LIMIT, if non-nil, limits characters to compose.
c674f351 357
7141ee65 358Optional 3rd arg OBJECT, if non-nil, is a string that contains the
1d1af02d 359text to compose. In that case, POS and LIMIT index into the string.
7141ee65 360
c674f351
KH
361This function is the default value of `compose-chars-after-function'."
362 (let ((tail (aref composition-function-table (char-after pos)))
67125135
KH
363 (font-obj (and (display-multi-font-p)
364 (and (not (stringp object))
365 (font-at pos (selected-window)))))
c674f351 366 pattern func result)
67125135
KH
367 (or limit
368 (setq limit (if (stringp object) (length object) (point-max))))
d04effb3 369 (when (and font-obj tail)
339cebdc
KH
370 (save-match-data
371 (save-excursion
67125135
KH
372 (while tail
373 (if (functionp (car tail))
374 (setq pattern nil func (car tail))
375 (setq pattern (car (car tail))
376 func (cdr (car tail))))
339cebdc 377 (goto-char pos)
67125135
KH
378 (if pattern
379 (if (and (if (stringp object)
380 (eq (string-match pattern object) 0)
381 (looking-at pattern))
382 (<= (match-end 0) limit))
383 (setq result
384 (funcall func pos (match-end 0) font-obj object)))
385 (setq result (funcall func pos limit font-obj object)))
386 (if result (setq tail nil))))))
387 result))
c674f351 388
c674f351
KH
389(defun compose-last-chars (args)
390 "Compose last characters.
3b923ad8
KH
391The argument is a parameterized event of the form
392 \(compose-last-chars N COMPONENTS),
393where N is the number of characters before point to compose,
394COMPONENTS, if non-nil, is the same as the argument to `compose-region'
395\(which see). If it is nil, `compose-chars-after' is called,
2624e2ac 396and that function finds a proper rule to compose the target characters.
c674f351
KH
397This function is intended to be used from input methods.
398The global keymap binds special event `compose-last-chars' to this
3b923ad8 399function. Input method may generate an event (compose-last-chars N COMPONENTS)
2624e2ac 400after a sequence of character events."
c674f351
KH
401 (interactive "e")
402 (let ((chars (nth 1 args)))
403 (if (and (numberp chars)
404 (>= (- (point) (point-min)) chars))
3b923ad8
KH
405 (if (nth 2 args)
406 (compose-region (- (point) chars) (point) (nth 2 args))
407 (compose-chars-after (- (point) chars) (point))))))
c674f351 408
68fbe650 409(global-set-key [compose-last-chars] 'compose-last-chars)
c674f351
KH
410
411\f
68fbe650
KH
412;;; Automatic character composition.
413
473ccad0
KH
414;; These macros must match with C macros LGSTRING_XXX and LGLYPH_XXX in font.h
415(defsubst lgstring-header (gstring) (aref gstring 0))
416(defsubst lgstring-set-header (gstring header) (aset gstring 0 header))
417(defsubst lgstring-font (gstring) (aref (lgstring-header gstring) 0))
418(defsubst lgstring-char (gstring i) (aref (lgstring-header gstring) (1+ i)))
419(defsubst lgstring-char-len (gstring) (1- (length (lgstring-header gstring))))
420(defsubst lgstring-shaped-p (gstring) (aref gstring 1))
421(defsubst lgstring-set-id (gstring id) (aset gstring 1 id))
422(defsubst lgstring-glyph (gstring i) (aref gstring (+ i 2)))
423(defsubst lgstring-glyph-len (gstring) (- (length gstring) 2))
424(defsubst lgstring-set-glyph (gstring i glyph) (aset gstring (+ i 2) glyph))
425
426(defsubst lglyph-from (glyph) (aref glyph 0))
427(defsubst lglyph-to (glyph) (aref glyph 1))
428(defsubst lglyph-char (glyph) (aref glyph 2))
429(defsubst lglyph-code (glyph) (aref glyph 3))
430(defsubst lglyph-width (glyph) (aref glyph 4))
431(defsubst lglyph-lbearing (glyph) (aref glyph 5))
432(defsubst lglyph-rbearing (glyph) (aref glyph 6))
433(defsubst lglyph-ascent (glyph) (aref glyph 7))
434(defsubst lglyph-descent (glyph) (aref glyph 8))
435(defsubst lglyph-adjustment (glyph) (aref glyph 9))
436
437(defsubst lglyph-set-from-to (glyph from to)
438 (progn (aset glyph 0 from) (aset glyph 1 to)))
439(defsubst lglyph-set-char (glyph char) (aset glyph 2 char))
b23dc424 440(defsubst lglyph-set-code (glyph code) (aset glyph 3 code))
473ccad0
KH
441(defsubst lglyph-set-width (glyph width) (aset glyph 4 width))
442(defsubst lglyph-set-adjustment (glyph &optional xoff yoff wadjust)
443 (aset glyph 9 (vector (or xoff 0) (or yoff 0) (or wadjust 0))))
444
445(defsubst lglyph-copy (glyph) (copy-sequence glyph))
446
447(defun lgstring-insert-glyph (gstring idx glyph)
448 (let ((nglyphs (lgstring-glyph-len gstring))
06b60517
JB
449 (i idx))
450 (while (and (< i nglyphs) (lgstring-glyph gstring i))
473ccad0
KH
451 (setq i (1+ i)))
452 (if (= i nglyphs)
453 (setq gstring (vconcat gstring (vector glyph)))
454 (if (< (1+ i) nglyphs)
455 (lgstring-set-glyph gstring (1+ i) nil)))
456 (while (> i idx)
457 (lgstring-set-glyph gstring i (lgstring-glyph gstring (1- i)))
458 (setq i (1- i)))
459 (lgstring-set-glyph gstring i glyph)
460 gstring))
461
462(defun compose-glyph-string (gstring from to)
463 (let ((glyph (lgstring-glyph gstring from))
06b60517 464 from-pos to-pos)
473ccad0
KH
465 (setq from-pos (lglyph-from glyph)
466 to-pos (lglyph-to (lgstring-glyph gstring (1- to))))
467 (lglyph-set-from-to glyph from-pos to-pos)
468 (setq from (1+ from))
469 (while (and (< from to)
470 (setq glyph (lgstring-glyph gstring from)))
471 (lglyph-set-from-to glyph from-pos to-pos)
472 (let ((xoff (if (<= (lglyph-rbearing glyph) 0) 0
473 (- (lglyph-width glyph)))))
474 (lglyph-set-adjustment glyph xoff 0 0))
475 (setq from (1+ from)))
476 gstring))
477
478(defun compose-glyph-string-relative (gstring from to &optional gap)
479 (let ((font-object (lgstring-font gstring))
480 (glyph (lgstring-glyph gstring from))
481 from-pos to-pos
06b60517 482 ascent descent)
473ccad0
KH
483 (if gap
484 (setq gap (floor (* (font-get font-object :size) gap)))
485 (setq gap 0))
486 (setq from-pos (lglyph-from glyph)
487 to-pos (lglyph-to (lgstring-glyph gstring (1- to)))
488 ascent (lglyph-ascent glyph)
489 descent (lglyph-descent glyph))
490 (lglyph-set-from-to glyph from-pos to-pos)
491 (setq from (1+ from))
492 (while (< from to)
493 (setq glyph (lgstring-glyph gstring from))
494 (lglyph-set-from-to glyph from-pos to-pos)
495 (let ((this-ascent (lglyph-ascent glyph))
496 (this-descent (lglyph-descent glyph))
06b60517 497 xoff yoff)
473ccad0
KH
498 (setq xoff (if (<= (lglyph-rbearing glyph) 0) 0
499 (- (lglyph-width glyph))))
500 (if (> this-ascent 0)
501 (if (< this-descent 0)
502 (setq yoff (- 0 ascent gap this-descent)
503 ascent (+ ascent gap this-ascent this-descent))
504 (setq yoff 0))
505 (setq yoff (+ descent gap this-ascent)
506 descent (+ descent gap this-ascent this-descent)))
507 (if (or (/= xoff 0) (/= yoff 0))
508 (lglyph-set-adjustment glyph xoff yoff 0)))
509 (setq from (1+ from)))
510 gstring))
511
512(defun compose-gstring-for-graphic (gstring)
513 "Compose glyph-string GSTRING for graphic display.
2833d915 514Combining characters are composed with the preceding base
473ccad0 515character. If the preceding character is not a base character,
2833d915 516each combining character is composed as a spacing character by
473ccad0
KH
517a padding space before and/or after the character.
518
07d7c3bd 519All non-spacing characters have this function in
473ccad0 520`composition-function-table' unless overwritten."
06b60517
JB
521 (let ((nchars (lgstring-char-len gstring))
522 (nglyphs (lgstring-glyph-len gstring))
523 (glyph (lgstring-glyph gstring 0)))
473ccad0
KH
524 (cond
525 ;; A non-spacing character not following a proper base character.
526 ((= nchars 1)
527 (let ((lbearing (lglyph-lbearing glyph))
528 (rbearing (lglyph-rbearing glyph))
529 (width (lglyph-width glyph))
06b60517 530 xoff)
473ccad0
KH
531 (if (< lbearing 0)
532 (setq xoff (- lbearing))
533 (setq xoff 0 lbearing 0))
534 (if (< rbearing width)
535 (setq rbearing width))
536 (lglyph-set-adjustment glyph xoff 0 (- rbearing lbearing))
537 gstring))
538
539 ;; This sequence doesn't start with a proper base character.
540 ((memq (get-char-code-property (lgstring-char gstring 0)
541 'general-category)
542 '(Mn Mc Me Zs Zl Zp Cc Cf Cs))
543 nil)
544
545 ;; A base character and the following non-spacing characters.
546 (t
547 (let ((gstr (font-shape-gstring gstring)))
548 (if (and gstr
549 (> (lglyph-to (lgstring-glyph gstr 0)) 0))
550 gstr
551 ;; The shaper of the font couldn't shape the gstring.
552 ;; Shape them according to canonical-combining-class.
553 (lgstring-set-id gstring nil)
554 (let* ((width (lglyph-width glyph))
555 (ascent (lglyph-ascent glyph))
556 (descent (lglyph-descent glyph))
557 (rbearing (lglyph-rbearing glyph))
558 (lbearing (lglyph-lbearing glyph))
559 (center (/ (+ lbearing rbearing) 2))
06b60517 560 (gap (round (* (font-get (lgstring-font gstring) :size) 0.1))))
473ccad0
KH
561 (dotimes (i nchars)
562 (setq glyph (lgstring-glyph gstring i))
563 (when (> i 0)
564 (let* ((class (get-char-code-property
565 (lglyph-char glyph) 'canonical-combining-class))
566 (lb (lglyph-lbearing glyph))
567 (rb (lglyph-rbearing glyph))
568 (as (lglyph-ascent glyph))
569 (de (lglyph-descent glyph))
570 (ce (/ (+ lb rb) 2))
571 xoff yoff)
c0a839ae
KH
572 (when (and class (>= class 200) (<= class 240))
573 (setq xoff 0 yoff 0)
574 (cond
575 ((= class 200)
576 (setq xoff (- lbearing ce)
577 yoff (if (> as 0) 0 (+ descent as))))
578 ((= class 202)
579 (if (> as 0) (setq as 0))
580 (setq xoff (- center ce)
581 yoff (if (> as 0) 0 (+ descent as))))
582 ((= class 204)
583 (if (> as 0) (setq as 0))
584 (setq xoff (- rbearing ce)
585 yoff (if (> as 0) 0 (+ descent as))))
586 ((= class 208)
587 (setq xoff (- lbearing rb)))
588 ((= class 210)
589 (setq xoff (- rbearing lb)))
590 ((= class 212)
591 (setq xoff (- lbearing ce)
592 yoff (if (>= de 0) 0 (- (- ascent) de))))
593 ((= class 214)
594 (setq xoff (- center ce)
595 yoff (if (>= de 0) 0 (- (- ascent) de))))
596 ((= class 216)
597 (setq xoff (- rbearing ce)
598 yoff (if (>= de 0) 0 (- (- ascent) de))))
599 ((= class 218)
600 (setq xoff (- lbearing ce)
601 yoff (if (> as 0) 0 (+ descent as gap))))
602 ((= class 220)
603 (setq xoff (- center ce)
604 yoff (if (> as 0) 0 (+ descent as gap))))
605 ((= class 222)
606 (setq xoff (- rbearing ce)
607 yoff (if (> as 0) 0 (+ descent as gap))))
608 ((= class 224)
609 (setq xoff (- lbearing rb)))
610 ((= class 226)
611 (setq xoff (- rbearing lb)))
612 ((= class 228)
613 (setq xoff (- lbearing ce)
614 yoff (if (>= de 0) 0 (- (- ascent) de gap))))
615 ((= class 230)
616 (setq xoff (- center ce)
617 yoff (if (>= de 0) 0 (- (- ascent) de gap))))
618 ((= class 232)
619 (setq xoff (- rbearing ce)
620 yoff (if (>= de 0) 0 (- (+ ascent de) gap)))))
621 (lglyph-set-adjustment glyph (- xoff width) yoff)
622 (setq lb (+ lb xoff)
623 rb (+ lb xoff)
624 as (- as yoff)
625 de (+ de yoff)))
626 (if (< ascent as)
627 (setq ascent as))
628 (if (< descent de)
629 (setq descent de))))))
473ccad0
KH
630 (let ((i 0))
631 (while (and (< i nglyphs) (setq glyph (lgstring-glyph gstring i)))
632 (lglyph-set-from-to glyph 0 (1- nchars))
633 (setq i (1+ i))))
634 gstring))))))
635
6d341a2a 636(let ((elt `([,(purecopy "\\c.\\c^+") 1 compose-gstring-for-graphic]
473ccad0
KH
637 [nil 0 compose-gstring-for-graphic])))
638 (map-char-table
639 #'(lambda (key val)
2833d915 640 (if (memq val '(Mn Mc Me))
473ccad0 641 (set-char-table-range composition-function-table key elt)))
2833d915 642 unicode-category-table))
473ccad0
KH
643
644(defun compose-gstring-for-terminal (gstring)
645 "Compose glyph string GSTRING for terminal display.
646Non-spacing characters are composed with the preceding base
647character. If the preceding character is not a base character,
648each non-spacing character is composed as a spacing character by
07d7c3bd 649prepending a space before it."
06b60517
JB
650 (let ((nglyphs (lgstring-glyph-len gstring))
651 (i 0)
652 (coding (lgstring-font gstring))
653 glyph)
473ccad0
KH
654 (while (and (< i nglyphs)
655 (setq glyph (lgstring-glyph gstring i)))
8da43785 656 (if (not (char-charset (lglyph-char glyph) coding))
473ccad0 657 (progn
8da43785
KH
658 ;; As the terminal doesn't support this glyph, return a
659 ;; gstring in which each glyph is its own graphme-cluster
660 ;; of width 1..
661 (setq i 0)
662 (while (and (< i nglyphs)
663 (setq glyph (lgstring-glyph gstring i)))
664 (if (< (lglyph-width glyph) 1)
665 (lglyph-set-width glyph 1))
666 (lglyph-set-from-to glyph i i)
667 (setq i (1+ i))))
668 (if (= (lglyph-width glyph) 0)
b8321d86
KH
669 (if (eq (get-char-code-property (lglyph-char glyph)
670 'general-category)
671 'Cf)
672 (progn
673 ;; Compose by replacing with a space.
674 (lglyph-set-char glyph 32)
675 (lglyph-set-width glyph 1)
676 (setq i (1+ i)))
8da43785
KH
677 ;; Compose by prepending a space.
678 (setq gstring (lgstring-insert-glyph gstring i
679 (lglyph-copy glyph))
680 nglyphs (lgstring-glyph-len gstring))
681 (setq glyph (lgstring-glyph gstring i))
682 (lglyph-set-char glyph 32)
683 (lglyph-set-width glyph 1)
684 (setq i (+ 2)))
685 (let ((from (lglyph-from glyph))
686 (to (lglyph-to glyph))
687 (j (1+ i)))
688 (while (and (< j nglyphs)
689 (setq glyph (lgstring-glyph gstring j))
690 (char-charset (lglyph-char glyph) coding)
691 (= (lglyph-width glyph) 0))
692 (setq to (lglyph-to glyph)
693 j (1+ j)))
694 (while (< i j)
695 (setq glyph (lgstring-glyph gstring i))
696 (lglyph-set-from-to glyph from to)
697 (setq i (1+ i)))))))
473ccad0
KH
698 gstring))
699
700
701(defun auto-compose-chars (func from to font-object string)
702 "Compose the characters at FROM by FUNC.
703FUNC is called with one argument GSTRING which is built for characters
704in the region FROM (inclusive) and TO (exclusive).
705
706If the character are composed on a graphic display, FONT-OBJECT
1ce3d35b 707is a font to use. Otherwise, FONT-OBJECT is nil, and the function
473ccad0
KH
708`compose-gstring-for-terminal' is used instead of FUNC.
709
00ddf712
KH
710If STRING is non-nil, it is a string, and FROM and TO are indices
711into the string. In that case, compose characters in the string.
68fbe650 712
473ccad0
KH
713The value is a gstring containing information for shaping the characters.
714
68fbe650 715This function is the default value of `auto-composition-function' (which see)."
473ccad0
KH
716 (let ((gstring (composition-get-gstring from to font-object string)))
717 (if (lgstring-shaped-p gstring)
718 gstring
8da43785 719 (or (fontp font-object 'font-object)
473ccad0
KH
720 (setq func 'compose-gstring-for-terminal))
721 (funcall func gstring))))
68fbe650 722
d9a7c140
KH
723(put 'auto-composition-mode 'permanent-local t)
724
37707939 725(make-variable-buffer-local 'auto-composition-function)
d9a7c140 726(setq-default auto-composition-function 'auto-compose-chars)
37707939 727
16d58d04 728;;;###autoload
56eb0904 729(define-minor-mode auto-composition-mode
ad1b4641
GM
730 "Toggle Auto Composition mode.
731With ARG, turn Auto Composition mode off if and only if ARG is a non-positive
732number; if ARG is nil, toggle Auto Composition mode; anything else turns Auto
733Composition on.
37707939
KH
734
735When Auto Composition is enabled, text characters are automatically composed
736by functions registered in `composition-function-table' (which see).
737
ad1b4641 738You can use `global-auto-composition-mode' to turn on
9d794026
GM
739Auto Composition mode in all buffers (this is the default)."
740 ;; It's defined in C, this stops the d-m-m macro defining it again.
741 :variable auto-composition-mode)
742;; It's not defined with DEFVAR_PER_BUFFER though.
743(make-variable-buffer-local 'auto-composition-mode)
37707939 744
16d58d04 745;;;###autoload
f44379e7 746(define-minor-mode global-auto-composition-mode
d9a7c140
KH
747 "Toggle Auto-Composition mode in every possible buffer.
748With prefix arg, turn Global-Auto-Composition mode on if and only if arg
749is positive.
750See `auto-composition-mode' for more information on Auto-Composition mode."
f44379e7
SM
751 :variable (default-value 'auto-composition-mode))
752
a485d4f7 753(defalias 'toggle-auto-composition 'auto-composition-mode)
bd4a85b9 754
c674f351 755\f
6b61353c 756
c674f351 757;;; composite.el ends here