Workaround dumping problem on PaX-enabled Linux kernels
[emacs.git] / src / composite.c
blob50aca156ba410b614173195c907c837a8af8095d
1 /* Composite sequence support.
2 Copyright (C) 2001-2012 Free Software Foundation, Inc.
3 Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
4 National Institute of Advanced Industrial Science and Technology (AIST)
5 Registration Number H14PRO021
6 Copyright (C) 2003, 2006
7 National Institute of Advanced Industrial Science and Technology (AIST)
8 Registration Number H13PRO009
10 This file is part of GNU Emacs.
12 GNU Emacs is free software: you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation, either version 3 of the License, or
15 (at your option) any later version.
17 GNU Emacs is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
25 #include <config.h>
26 #include <setjmp.h>
27 #include "lisp.h"
28 #include "buffer.h"
29 #include "character.h"
30 #include "coding.h"
31 #include "intervals.h"
32 #include "window.h"
33 #include "frame.h"
34 #include "dispextern.h"
35 #include "font.h"
36 #include "termhooks.h"
39 /* Emacs uses special text property `composition' to support character
40 composition. A sequence of characters that have the same (i.e. eq)
41 `composition' property value is treated as a single composite
42 sequence (we call it just `composition' here after). Characters in
43 a composition are all composed somehow on the screen.
45 The property value has this form when the composition is made:
46 ((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
47 then turns to this form:
48 (COMPOSITION-ID . (LENGTH COMPONENTS-VEC . MODIFICATION-FUNC))
49 when the composition is registered in composition_hash_table and
50 composition_table. These rather peculiar structures were designed
51 to make it easy to distinguish them quickly (we can do that by
52 checking only the first element) and to extract LENGTH (from the
53 former form) and COMPOSITION-ID (from the latter form).
55 We register a composition when it is displayed, or when the width
56 is required (for instance, to calculate columns).
58 LENGTH -- Length of the composition. This information is used to
59 check the validity of the composition.
61 COMPONENTS -- Character, string, vector, list, or nil.
63 If it is nil, characters in the text are composed relatively
64 according to their metrics in font glyphs.
66 If it is a character or a string, the character or characters
67 in the string are composed relatively.
69 If it is a vector or list of integers, the element is a
70 character or an encoded composition rule. The characters are
71 composed according to the rules. (2N)th elements are
72 characters to be composed and (2N+1)th elements are
73 composition rules to tell how to compose (2N+2)th element with
74 the previously composed 2N glyphs.
76 COMPONENTS-VEC -- Vector of integers. In a relative composition,
77 the elements are the characters to be composed. In a rule-base
78 composition, the elements are characters or encoded
79 composition rules.
81 MODIFICATION-FUNC -- If non nil, it is a function to call when the
82 composition gets invalid after a modification in a buffer. If
83 it is nil, a function in `composition-function-table' of the
84 first character in the sequence is called.
86 COMPOSITION-ID --Identification number of the composition. It is
87 used as an index to composition_table for the composition.
89 When Emacs has to display a composition or has to know its
90 displaying width, the function get_composition_id is called. It
91 returns COMPOSITION-ID so that the caller can access the
92 information about the composition through composition_table. If a
93 COMPOSITION-ID has not yet been assigned to the composition,
94 get_composition_id checks the validity of `composition' property,
95 and, if valid, assigns a new ID, registers the information in
96 composition_hash_table and composition_table, and changes the form
97 of the property value. If the property is invalid,
98 get_composition_id returns -1 without changing the property value.
100 We use two tables to keep the information about composition;
101 composition_hash_table and composition_table.
103 The former is a hash table whose keys are COMPONENTS-VECs and
104 values are the corresponding COMPOSITION-IDs. This hash table is
105 weak, but as each key (COMPONENTS-VEC) is also kept as a value of the
106 `composition' property, it won't be collected as garbage until all
107 bits of text that have the same COMPONENTS-VEC are deleted.
109 The latter is a table of pointers to `struct composition' indexed
110 by COMPOSITION-ID. This structure keeps the other information (see
111 composite.h).
113 In general, a text property holds information about individual
114 characters. But, a `composition' property holds information about
115 a sequence of characters (in this sense, it is like the `intangible'
116 property). That means that we should not share the property value
117 in adjacent compositions -- we can't distinguish them if they have the
118 same property. So, after any changes, we call
119 `update_compositions' and change a property of one of adjacent
120 compositions to a copy of it. This function also runs a proper
121 composition modification function to make a composition that gets
122 invalid by the change valid again.
124 As the value of the `composition' property holds information about a
125 specific range of text, the value gets invalid if we change the
126 text in the range. We treat the `composition' property as always
127 rear-nonsticky (currently by setting default-text-properties to
128 (rear-nonsticky (composition))) and we never make properties of
129 adjacent compositions identical. Thus, any such changes make the
130 range just shorter. So, we can check the validity of the `composition'
131 property by comparing LENGTH information with the actual length of
132 the composition.
137 Lisp_Object Qcomposition;
139 /* Table of pointers to the structure `composition' indexed by
140 COMPOSITION-ID. This structure is for storing information about
141 each composition except for COMPONENTS-VEC. */
142 struct composition **composition_table;
144 /* The current size of `composition_table'. */
145 static ptrdiff_t composition_table_size;
147 /* Number of compositions currently made. */
148 ptrdiff_t n_compositions;
150 /* Hash table for compositions. The key is COMPONENTS-VEC of
151 `composition' property. The value is the corresponding
152 COMPOSITION-ID. */
153 Lisp_Object composition_hash_table;
155 static Lisp_Object Qauto_composed;
156 static Lisp_Object Qauto_composition_function;
157 /* Maximum number of characters to look back for
158 auto-compositions. */
159 #define MAX_AUTO_COMPOSITION_LOOKBACK 3
161 static Lisp_Object Fcomposition_get_gstring (Lisp_Object, Lisp_Object,
162 Lisp_Object, Lisp_Object);
164 /* Temporary variable used in macros COMPOSITION_XXX. */
165 Lisp_Object composition_temp;
168 /* Return COMPOSITION-ID of a composition at buffer position
169 CHARPOS/BYTEPOS and length NCHARS. The `composition' property of
170 the sequence is PROP. STRING, if non-nil, is a string that
171 contains the composition instead of the current buffer.
173 If the composition is invalid, return -1. */
175 ptrdiff_t
176 get_composition_id (ptrdiff_t charpos, ptrdiff_t bytepos, ptrdiff_t nchars,
177 Lisp_Object prop, Lisp_Object string)
179 Lisp_Object id, length, components, key, *key_contents;
180 ptrdiff_t glyph_len;
181 struct Lisp_Hash_Table *hash_table = XHASH_TABLE (composition_hash_table);
182 ptrdiff_t hash_index;
183 EMACS_UINT hash_code;
184 enum composition_method method;
185 struct composition *cmp;
186 ptrdiff_t i;
187 int ch;
189 /* Maximum length of a string of glyphs. XftGlyphExtents limits
190 this to INT_MAX, and Emacs limits it further. Divide INT_MAX - 1
191 by 2 because x_produce_glyphs computes glyph_len * 2 + 1. Divide
192 the size by MAX_MULTIBYTE_LENGTH because encode_terminal_code
193 multiplies glyph_len by MAX_MULTIBYTE_LENGTH. */
194 enum {
195 GLYPH_LEN_MAX = min ((INT_MAX - 1) / 2,
196 min (PTRDIFF_MAX, SIZE_MAX) / MAX_MULTIBYTE_LENGTH)
199 /* PROP should be
200 Form-A: ((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
202 Form-B: (COMPOSITION-ID . (LENGTH COMPONENTS-VEC . MODIFICATION-FUNC))
204 if (nchars == 0 || !CONSP (prop))
205 goto invalid_composition;
207 id = XCAR (prop);
208 if (INTEGERP (id))
210 /* PROP should be Form-B. */
211 if (XINT (id) < 0 || XINT (id) >= n_compositions)
212 goto invalid_composition;
213 return XINT (id);
216 /* PROP should be Form-A.
217 Thus, ID should be (LENGTH . COMPONENTS). */
218 if (!CONSP (id))
219 goto invalid_composition;
220 length = XCAR (id);
221 if (!INTEGERP (length) || XINT (length) != nchars)
222 goto invalid_composition;
224 components = XCDR (id);
226 /* Check if the same composition has already been registered or not
227 by consulting composition_hash_table. The key for this table is
228 COMPONENTS (converted to a vector COMPONENTS-VEC) or, if it is
229 nil, vector of characters in the composition range. */
230 if (INTEGERP (components))
231 key = Fmake_vector (make_number (1), components);
232 else if (STRINGP (components) || CONSP (components))
233 key = Fvconcat (1, &components);
234 else if (VECTORP (components))
235 key = components;
236 else if (NILP (components))
238 key = Fmake_vector (make_number (nchars), Qnil);
239 if (STRINGP (string))
240 for (i = 0; i < nchars; i++)
242 FETCH_STRING_CHAR_ADVANCE (ch, string, charpos, bytepos);
243 XVECTOR (key)->contents[i] = make_number (ch);
245 else
246 for (i = 0; i < nchars; i++)
248 FETCH_CHAR_ADVANCE (ch, charpos, bytepos);
249 XVECTOR (key)->contents[i] = make_number (ch);
252 else
253 goto invalid_composition;
255 hash_index = hash_lookup (hash_table, key, &hash_code);
256 if (hash_index >= 0)
258 /* We have already registered the same composition. Change PROP
259 from Form-A above to Form-B while replacing COMPONENTS with
260 COMPONENTS-VEC stored in the hash table. We can directly
261 modify the cons cell of PROP because it is not shared. */
262 key = HASH_KEY (hash_table, hash_index);
263 id = HASH_VALUE (hash_table, hash_index);
264 XSETCAR (prop, id);
265 XSETCDR (prop, Fcons (make_number (nchars), Fcons (key, XCDR (prop))));
266 return XINT (id);
269 /* This composition is a new one. We must register it. */
271 /* Check if we have sufficient memory to store this information. */
272 if (composition_table_size <= n_compositions)
273 composition_table = xpalloc (composition_table, &composition_table_size,
274 1, -1, sizeof *composition_table);
276 key_contents = XVECTOR (key)->contents;
278 /* Check if the contents of COMPONENTS are valid if COMPONENTS is a
279 vector or a list. It should be a sequence of:
280 char1 rule1 char2 rule2 char3 ... ruleN charN+1 */
282 if (VECTORP (components)
283 && ASIZE (components) >= 2
284 && VECTORP (AREF (components, 0)))
286 /* COMPONENTS is a glyph-string. */
287 ptrdiff_t len = ASIZE (key);
289 for (i = 1; i < len; i++)
290 if (! VECTORP (AREF (key, i)))
291 goto invalid_composition;
293 else if (VECTORP (components) || CONSP (components))
295 ptrdiff_t len = ASIZE (key);
297 /* The number of elements should be odd. */
298 if ((len % 2) == 0)
299 goto invalid_composition;
300 /* All elements should be integers (character or encoded
301 composition rule). */
302 for (i = 0; i < len; i++)
304 if (!INTEGERP (key_contents[i]))
305 goto invalid_composition;
309 /* Change PROP from Form-A above to Form-B. We can directly modify
310 the cons cell of PROP because it is not shared. */
311 XSETFASTINT (id, n_compositions);
312 XSETCAR (prop, id);
313 XSETCDR (prop, Fcons (make_number (nchars), Fcons (key, XCDR (prop))));
315 /* Register the composition in composition_hash_table. */
316 hash_index = hash_put (hash_table, key, id, hash_code);
318 method = (NILP (components)
319 ? COMPOSITION_RELATIVE
320 : ((INTEGERP (components) || STRINGP (components))
321 ? COMPOSITION_WITH_ALTCHARS
322 : COMPOSITION_WITH_RULE_ALTCHARS));
324 glyph_len = (method == COMPOSITION_WITH_RULE_ALTCHARS
325 ? (ASIZE (key) + 1) / 2
326 : ASIZE (key));
328 if (GLYPH_LEN_MAX < glyph_len)
329 memory_full (SIZE_MAX);
331 /* Register the composition in composition_table. */
332 cmp = (struct composition *) xmalloc (sizeof (struct composition));
334 cmp->method = method;
335 cmp->hash_index = hash_index;
336 cmp->glyph_len = glyph_len;
337 cmp->offsets = xnmalloc (glyph_len, 2 * sizeof *cmp->offsets);
338 cmp->font = NULL;
340 if (cmp->method != COMPOSITION_WITH_RULE_ALTCHARS)
342 /* Relative composition. */
343 cmp->width = 0;
344 for (i = 0; i < glyph_len; i++)
346 int this_width;
347 ch = XINT (key_contents[i]);
348 /* TAB in a composition means display glyphs with padding
349 space on the left or right. */
350 this_width = (ch == '\t' ? 1 : CHAR_WIDTH (ch));
351 if (cmp->width < this_width)
352 cmp->width = this_width;
355 else
357 /* Rule-base composition. */
358 double leftmost = 0.0, rightmost;
360 ch = XINT (key_contents[0]);
361 rightmost = ch != '\t' ? CHAR_WIDTH (ch) : 1;
363 for (i = 1; i < glyph_len; i += 2)
365 int rule, gref, nref;
366 int this_width;
367 double this_left;
369 rule = XINT (key_contents[i]);
370 ch = XINT (key_contents[i + 1]);
371 this_width = ch != '\t' ? CHAR_WIDTH (ch) : 1;
373 /* A composition rule is specified by an integer value
374 that encodes global and new reference points (GREF and
375 NREF). GREF and NREF are specified by numbers as
376 below:
377 0---1---2 -- ascent
381 9--10--11 -- center
383 ---3---4---5--- baseline
385 6---7---8 -- descent
387 COMPOSITION_DECODE_REFS (rule, gref, nref);
388 this_left = (leftmost
389 + (gref % 3) * (rightmost - leftmost) / 2.0
390 - (nref % 3) * this_width / 2.0);
392 if (this_left < leftmost)
393 leftmost = this_left;
394 if (this_left + this_width > rightmost)
395 rightmost = this_left + this_width;
398 cmp->width = rightmost - leftmost;
399 if (cmp->width < (rightmost - leftmost))
400 /* To get a ceiling integer value. */
401 cmp->width++;
404 composition_table[n_compositions] = cmp;
406 return n_compositions++;
408 invalid_composition:
409 /* Would it be better to remove this `composition' property? */
410 return -1;
414 /* Find a static composition at or nearest to position POS of OBJECT
415 (buffer or string).
417 OBJECT defaults to the current buffer. If there's a composition at
418 POS, set *START and *END to the start and end of the sequence,
419 *PROP to the `composition' property, and return 1.
421 If there's no composition at POS and LIMIT is negative, return 0.
423 Otherwise, search for a composition forward (LIMIT > POS) or
424 backward (LIMIT < POS). In this case, LIMIT bounds the search.
426 If a composition is found, set *START, *END, and *PROP as above,
427 and return 1, else return 0.
429 This doesn't check the validity of composition. */
432 find_composition (ptrdiff_t pos, ptrdiff_t limit,
433 ptrdiff_t *start, ptrdiff_t *end,
434 Lisp_Object *prop, Lisp_Object object)
436 Lisp_Object val;
438 if (get_property_and_range (pos, Qcomposition, prop, start, end, object))
439 return 1;
441 if (limit < 0 || limit == pos)
442 return 0;
444 if (limit > pos) /* search forward */
446 val = Fnext_single_property_change (make_number (pos), Qcomposition,
447 object, make_number (limit));
448 pos = XINT (val);
449 if (pos == limit)
450 return 0;
452 else /* search backward */
454 if (get_property_and_range (pos - 1, Qcomposition, prop, start, end,
455 object))
456 return 1;
457 val = Fprevious_single_property_change (make_number (pos), Qcomposition,
458 object, make_number (limit));
459 pos = XINT (val);
460 if (pos == limit)
461 return 0;
462 pos--;
464 get_property_and_range (pos, Qcomposition, prop, start, end, object);
465 return 1;
468 /* Run a proper function to adjust the composition sitting between
469 FROM and TO with property PROP. */
471 static void
472 run_composition_function (ptrdiff_t from, ptrdiff_t to, Lisp_Object prop)
474 Lisp_Object func;
475 ptrdiff_t start, end;
477 func = COMPOSITION_MODIFICATION_FUNC (prop);
478 /* If an invalid composition precedes or follows, try to make them
479 valid too. */
480 if (from > BEGV
481 && find_composition (from - 1, -1, &start, &end, &prop, Qnil)
482 && !COMPOSITION_VALID_P (start, end, prop))
483 from = start;
484 if (to < ZV
485 && find_composition (to, -1, &start, &end, &prop, Qnil)
486 && !COMPOSITION_VALID_P (start, end, prop))
487 to = end;
488 if (!NILP (Ffboundp (func)))
489 call2 (func, make_number (from), make_number (to));
492 /* Make invalid compositions adjacent to or inside FROM and TO valid.
493 CHECK_MASK is bitwise `or' of mask bits defined by macros
494 CHECK_XXX (see the comment in composite.h).
496 It also resets the text-property `auto-composed' to a proper region
497 so that automatic character composition works correctly later while
498 displaying the region.
500 This function is called when a buffer text is changed. If the
501 change is deletion, FROM == TO. Otherwise, FROM < TO. */
503 void
504 update_compositions (ptrdiff_t from, ptrdiff_t to, int check_mask)
506 Lisp_Object prop;
507 ptrdiff_t start, end;
508 /* The beginning and end of the region to set the property
509 `auto-composed' to nil. */
510 ptrdiff_t min_pos = from, max_pos = to;
512 if (inhibit_modification_hooks)
513 return;
515 /* If FROM and TO are not in a valid range, do nothing. */
516 if (! (BEGV <= from && from <= to && to <= ZV))
517 return;
519 if (check_mask & CHECK_HEAD)
521 /* FROM should be at composition boundary. But, insertion or
522 deletion will make two compositions adjacent and
523 indistinguishable when they have same (eq) property. To
524 avoid it, in such a case, we change the property of the
525 latter to the copy of it. */
526 if (from > BEGV
527 && find_composition (from - 1, -1, &start, &end, &prop, Qnil)
528 && COMPOSITION_VALID_P (start, end, prop))
530 min_pos = start;
531 if (end > to)
532 max_pos = end;
533 if (from < end)
534 Fput_text_property (make_number (from), make_number (end),
535 Qcomposition,
536 Fcons (XCAR (prop), XCDR (prop)), Qnil);
537 run_composition_function (start, end, prop);
538 from = end;
540 else if (from < ZV
541 && find_composition (from, -1, &start, &from, &prop, Qnil)
542 && COMPOSITION_VALID_P (start, from, prop))
544 if (from > to)
545 max_pos = from;
546 run_composition_function (start, from, prop);
550 if (check_mask & CHECK_INSIDE)
552 /* In this case, we are sure that (check & CHECK_TAIL) is also
553 nonzero. Thus, here we should check only compositions before
554 (to - 1). */
555 while (from < to - 1
556 && find_composition (from, to, &start, &from, &prop, Qnil)
557 && COMPOSITION_VALID_P (start, from, prop)
558 && from < to - 1)
559 run_composition_function (start, from, prop);
562 if (check_mask & CHECK_TAIL)
564 if (from < to
565 && find_composition (to - 1, -1, &start, &end, &prop, Qnil)
566 && COMPOSITION_VALID_P (start, end, prop))
568 /* TO should be also at composition boundary. But,
569 insertion or deletion will make two compositions adjacent
570 and indistinguishable when they have same (eq) property.
571 To avoid it, in such a case, we change the property of
572 the former to the copy of it. */
573 if (to < end)
575 Fput_text_property (make_number (start), make_number (to),
576 Qcomposition,
577 Fcons (XCAR (prop), XCDR (prop)), Qnil);
578 max_pos = end;
580 run_composition_function (start, end, prop);
582 else if (to < ZV
583 && find_composition (to, -1, &start, &end, &prop, Qnil)
584 && COMPOSITION_VALID_P (start, end, prop))
586 run_composition_function (start, end, prop);
587 max_pos = end;
590 if (min_pos < max_pos)
592 ptrdiff_t count = SPECPDL_INDEX ();
594 specbind (Qinhibit_read_only, Qt);
595 specbind (Qinhibit_modification_hooks, Qt);
596 specbind (Qinhibit_point_motion_hooks, Qt);
597 Fremove_list_of_text_properties (make_number (min_pos),
598 make_number (max_pos),
599 Fcons (Qauto_composed, Qnil), Qnil);
600 unbind_to (count, Qnil);
605 /* Modify composition property values in LIST destructively. LIST is
606 a list as returned from text_property_list. Change values to the
607 top-level copies of them so that none of them are `eq'. */
609 void
610 make_composition_value_copy (Lisp_Object list)
612 Lisp_Object plist, val;
614 for (; CONSP (list); list = XCDR (list))
616 plist = XCAR (XCDR (XCDR (XCAR (list))));
617 while (CONSP (plist) && CONSP (XCDR (plist)))
619 if (EQ (XCAR (plist), Qcomposition)
620 && (val = XCAR (XCDR (plist)), CONSP (val)))
621 XSETCAR (XCDR (plist), Fcons (XCAR (val), XCDR (val)));
622 plist = XCDR (XCDR (plist));
628 /* Make text in the region between START and END a composition that
629 has COMPONENTS and MODIFICATION-FUNC.
631 If STRING is non-nil, then operate on characters contained between
632 indices START and END in STRING. */
634 void
635 compose_text (ptrdiff_t start, ptrdiff_t end, Lisp_Object components,
636 Lisp_Object modification_func, Lisp_Object string)
638 Lisp_Object prop;
640 prop = Fcons (Fcons (make_number (end - start), components),
641 modification_func);
642 Fput_text_property (make_number (start), make_number (end),
643 Qcomposition, prop, string);
647 static Lisp_Object autocmp_chars (Lisp_Object, ptrdiff_t, ptrdiff_t,
648 ptrdiff_t, struct window *,
649 struct face *, Lisp_Object);
652 /* Lisp glyph-string handlers */
654 /* Hash table for automatic composition. The key is a header of a
655 lgstring (Lispy glyph-string), and the value is a body of a
656 lgstring. */
658 static Lisp_Object gstring_hash_table;
660 static Lisp_Object gstring_lookup_cache (Lisp_Object);
662 static Lisp_Object
663 gstring_lookup_cache (Lisp_Object header)
665 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
666 ptrdiff_t i = hash_lookup (h, header, NULL);
668 return (i >= 0 ? HASH_VALUE (h, i) : Qnil);
671 Lisp_Object
672 composition_gstring_put_cache (Lisp_Object gstring, ptrdiff_t len)
674 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
675 EMACS_UINT hash;
676 Lisp_Object header, copy;
677 ptrdiff_t i;
679 header = LGSTRING_HEADER (gstring);
680 hash = h->hashfn (h, header);
681 if (len < 0)
683 ptrdiff_t j, glyph_len = LGSTRING_GLYPH_LEN (gstring);
684 for (j = 0; j < glyph_len; j++)
685 if (NILP (LGSTRING_GLYPH (gstring, j)))
686 break;
687 len = j;
690 lint_assume (len <= TYPE_MAXIMUM (ptrdiff_t) - 2);
691 copy = Fmake_vector (make_number (len + 2), Qnil);
692 LGSTRING_SET_HEADER (copy, Fcopy_sequence (header));
693 for (i = 0; i < len; i++)
694 LGSTRING_SET_GLYPH (copy, i, Fcopy_sequence (LGSTRING_GLYPH (gstring, i)));
695 i = hash_put (h, LGSTRING_HEADER (copy), copy, hash);
696 LGSTRING_SET_ID (copy, make_number (i));
697 return copy;
700 Lisp_Object
701 composition_gstring_from_id (ptrdiff_t id)
703 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
705 return HASH_VALUE (h, id);
708 static Lisp_Object fill_gstring_header (Lisp_Object, Lisp_Object,
709 Lisp_Object, Lisp_Object,
710 Lisp_Object);
713 composition_gstring_p (Lisp_Object gstring)
715 Lisp_Object header;
716 ptrdiff_t i;
718 if (! VECTORP (gstring) || ASIZE (gstring) < 2)
719 return 0;
720 header = LGSTRING_HEADER (gstring);
721 if (! VECTORP (header) || ASIZE (header) < 2)
722 return 0;
723 if (! NILP (LGSTRING_FONT (gstring))
724 && (! FONT_OBJECT_P (LGSTRING_FONT (gstring))
725 && ! CODING_SYSTEM_P (LGSTRING_FONT (gstring))))
726 return 0;
727 for (i = 1; i < ASIZE (LGSTRING_HEADER (gstring)); i++)
728 if (! NATNUMP (AREF (LGSTRING_HEADER (gstring), i)))
729 return 0;
730 if (! NILP (LGSTRING_ID (gstring)) && ! NATNUMP (LGSTRING_ID (gstring)))
731 return 0;
732 for (i = 0; i < LGSTRING_GLYPH_LEN (gstring); i++)
734 Lisp_Object glyph = LGSTRING_GLYPH (gstring, i);
735 if (NILP (glyph))
736 break;
737 if (! VECTORP (glyph) || ASIZE (glyph) != LGLYPH_SIZE)
738 return 0;
740 return 1;
744 composition_gstring_width (Lisp_Object gstring, ptrdiff_t from, ptrdiff_t to,
745 struct font_metrics *metrics)
747 Lisp_Object *glyph;
748 int width = 0;
750 if (metrics)
752 Lisp_Object font_object = LGSTRING_FONT (gstring);
754 if (FONT_OBJECT_P (font_object))
756 struct font *font = XFONT_OBJECT (font_object);
758 metrics->ascent = font->ascent;
759 metrics->descent = font->descent;
761 else
763 metrics->ascent = 1;
764 metrics->descent = 0;
766 metrics->width = metrics->lbearing = metrics->rbearing = 0;
768 for (glyph = &LGSTRING_GLYPH (gstring, from); from < to; from++, glyph++)
770 int x;
772 if (NILP (LGLYPH_ADJUSTMENT (*glyph)))
773 width += LGLYPH_WIDTH (*glyph);
774 else
775 width += LGLYPH_WADJUST (*glyph);
776 if (metrics)
778 x = metrics->width + LGLYPH_LBEARING (*glyph) + LGLYPH_XOFF (*glyph);
779 if (metrics->lbearing > x)
780 metrics->lbearing = x;
781 x = metrics->width + LGLYPH_RBEARING (*glyph) + LGLYPH_XOFF (*glyph);
782 if (metrics->rbearing < x)
783 metrics->rbearing = x;
784 metrics->width = width;
785 x = LGLYPH_ASCENT (*glyph) - LGLYPH_YOFF (*glyph);
786 if (metrics->ascent < x)
787 metrics->ascent = x;
788 x = LGLYPH_DESCENT (*glyph) + LGLYPH_YOFF (*glyph);
789 if (metrics->descent < x)
790 metrics->descent = x;
793 return width;
797 static Lisp_Object gstring_work;
798 static Lisp_Object gstring_work_headers;
800 static Lisp_Object
801 fill_gstring_header (Lisp_Object header, Lisp_Object start, Lisp_Object end, Lisp_Object font_object, Lisp_Object string)
803 ptrdiff_t from, to, from_byte;
804 ptrdiff_t len, i;
806 if (NILP (string))
808 if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
809 error ("Attempt to shape unibyte text");
810 validate_region (&start, &end);
811 from = XFASTINT (start);
812 to = XFASTINT (end);
813 from_byte = CHAR_TO_BYTE (from);
815 else
817 CHECK_STRING (string);
818 if (! STRING_MULTIBYTE (string))
819 error ("Attempt to shape unibyte text");
820 /* The caller checks that START and END are nonnegative integers. */
821 if (! (XINT (start) <= XINT (end) && XINT (end) <= SCHARS (string)))
822 args_out_of_range_3 (string, start, end);
823 from = XINT (start);
824 to = XINT (end);
825 from_byte = string_char_to_byte (string, from);
828 len = to - from;
829 if (len == 0)
830 error ("Attempt to shape zero-length text");
831 if (VECTORP (header))
833 if (ASIZE (header) != len + 1)
834 args_out_of_range (header, make_number (len + 1));
836 else
838 if (len <= 8)
839 header = AREF (gstring_work_headers, len - 1);
840 else
841 header = Fmake_vector (make_number (len + 1), Qnil);
844 ASET (header, 0, font_object);
845 for (i = 0; i < len; i++)
847 int c;
849 if (NILP (string))
850 FETCH_CHAR_ADVANCE_NO_CHECK (c, from, from_byte);
851 else
852 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, string, from, from_byte);
853 ASET (header, i + 1, make_number (c));
855 return header;
858 static void
859 fill_gstring_body (Lisp_Object gstring)
861 Lisp_Object font_object = LGSTRING_FONT (gstring);
862 Lisp_Object header = AREF (gstring, 0);
863 ptrdiff_t len = LGSTRING_CHAR_LEN (gstring);
864 ptrdiff_t i;
866 for (i = 0; i < len; i++)
868 Lisp_Object g = LGSTRING_GLYPH (gstring, i);
869 int c = XFASTINT (AREF (header, i + 1));
871 if (NILP (g))
873 g = LGLYPH_NEW ();
874 LGSTRING_SET_GLYPH (gstring, i, g);
876 LGLYPH_SET_FROM (g, i);
877 LGLYPH_SET_TO (g, i);
878 LGLYPH_SET_CHAR (g, c);
879 if (FONT_OBJECT_P (font_object))
881 font_fill_lglyph_metrics (g, font_object);
883 else
885 int width = XFASTINT (CHAR_TABLE_REF (Vchar_width_table, c));
887 LGLYPH_SET_CODE (g, c);
888 LGLYPH_SET_LBEARING (g, 0);
889 LGLYPH_SET_RBEARING (g, width);
890 LGLYPH_SET_WIDTH (g, width);
891 LGLYPH_SET_ASCENT (g, 1);
892 LGLYPH_SET_DESCENT (g, 0);
894 LGLYPH_SET_ADJUSTMENT (g, Qnil);
896 if (i < LGSTRING_GLYPH_LEN (gstring))
897 LGSTRING_SET_GLYPH (gstring, i, Qnil);
901 /* Try to compose the characters at CHARPOS according to composition
902 rule RULE ([PATTERN PREV-CHARS FUNC]). LIMIT limits the characters
903 to compose. STRING, if not nil, is a target string. WIN is a
904 window where the characters are being displayed. If characters are
905 successfully composed, return the composition as a glyph-string
906 object. Otherwise return nil. */
908 static Lisp_Object
909 autocmp_chars (Lisp_Object rule, ptrdiff_t charpos, ptrdiff_t bytepos, ptrdiff_t limit, struct window *win, struct face *face, Lisp_Object string)
911 ptrdiff_t count = SPECPDL_INDEX ();
912 FRAME_PTR f = XFRAME (win->frame);
913 Lisp_Object pos = make_number (charpos);
914 ptrdiff_t to;
915 ptrdiff_t pt = PT, pt_byte = PT_BYTE;
916 Lisp_Object re, font_object, lgstring;
917 ptrdiff_t len;
919 record_unwind_save_match_data ();
920 re = AREF (rule, 0);
921 if (NILP (re))
922 len = 1;
923 else if (! STRINGP (re))
924 return unbind_to (count, Qnil);
925 else if ((len = fast_looking_at (re, charpos, bytepos, limit, -1, string))
926 > 0)
928 if (NILP (string))
929 len = BYTE_TO_CHAR (bytepos + len) - charpos;
930 else
931 len = string_byte_to_char (string, bytepos + len) - charpos;
933 if (len <= 0)
934 return unbind_to (count, Qnil);
935 to = limit = charpos + len;
936 #ifdef HAVE_WINDOW_SYSTEM
937 if (FRAME_WINDOW_P (f))
939 font_object = font_range (charpos, &to, win, face, string);
940 if (! FONT_OBJECT_P (font_object)
941 || (! NILP (re)
942 && to < limit
943 && (fast_looking_at (re, charpos, bytepos, to, -1, string) <= 0)))
944 return unbind_to (count, Qnil);
946 else
947 #endif /* not HAVE_WINDOW_SYSTEM */
948 font_object = win->frame;
949 lgstring = Fcomposition_get_gstring (pos, make_number (to), font_object,
950 string);
951 if (NILP (LGSTRING_ID (lgstring)))
953 Lisp_Object args[6];
955 /* Save point as marker before calling out to lisp. */
956 if (NILP (string))
958 Lisp_Object m = Fmake_marker ();
959 set_marker_both (m, Qnil, pt, pt_byte);
960 record_unwind_protect (restore_point_unwind, m);
963 args[0] = Vauto_composition_function;
964 args[1] = AREF (rule, 2);
965 args[2] = pos;
966 args[3] = make_number (to);
967 args[4] = font_object;
968 args[5] = string;
969 lgstring = safe_call (6, args);
971 return unbind_to (count, lgstring);
974 static Lisp_Object _work_val;
976 /* 1 iff the character C is composable. Characters of general
977 category Z? or C? are not composable except for ZWNJ and ZWJ. */
979 #define CHAR_COMPOSABLE_P(C) \
980 ((C) > ' ' \
981 && ((C) == 0x200C || (C) == 0x200D \
982 || (_work_val = CHAR_TABLE_REF (Vunicode_category_table, (C)), \
983 (INTEGERP (_work_val) \
984 && (XINT (_work_val) <= UNICODE_CATEGORY_So)))))
986 /* Update cmp_it->stop_pos to the next position after CHARPOS (and
987 BYTEPOS) where character composition may happen. If BYTEPOS is
988 negative, compute it. ENDPOS is a limit of searching. If it is
989 less than CHARPOS, search backward to ENDPOS+1 assuming that
990 set_iterator_to_next works in reverse order. In this case, if a
991 composition closest to CHARPOS is found, set cmp_it->stop_pos to
992 the last character of the composition.
994 If no composition is found, set cmp_it->ch to -2. If a static
995 composition is found, set cmp_it->ch to -1. Otherwise, set
996 cmp_it->ch to the character that triggers the automatic
997 composition. */
999 void
1000 composition_compute_stop_pos (struct composition_it *cmp_it, ptrdiff_t charpos, ptrdiff_t bytepos, ptrdiff_t endpos, Lisp_Object string)
1002 ptrdiff_t start, end;
1003 int c;
1004 Lisp_Object prop, val;
1005 /* This is from forward_to_next_line_start in xdisp.c. */
1006 const int MAX_NEWLINE_DISTANCE = 500;
1008 if (charpos < endpos)
1010 if (endpos > charpos + MAX_NEWLINE_DISTANCE)
1011 endpos = charpos + MAX_NEWLINE_DISTANCE;
1013 else if (endpos < charpos)
1015 /* We search backward for a position to check composition. */
1016 if (endpos < 0)
1018 /* But we don't know where to stop the searching. */
1019 endpos = NILP (string) ? BEGV - 1 : -1;
1020 /* Usually we don't reach ENDPOS because we stop searching
1021 at an uncomposable character (NL, LRE, etc). */
1024 cmp_it->id = -1;
1025 cmp_it->ch = -2;
1026 cmp_it->reversed_p = 0;
1027 cmp_it->stop_pos = endpos;
1028 if (charpos == endpos)
1029 return;
1030 /* FIXME: Bidi is not yet handled well in static composition. */
1031 if (charpos < endpos
1032 && find_composition (charpos, endpos, &start, &end, &prop, string)
1033 && start >= charpos
1034 && COMPOSITION_VALID_P (start, end, prop))
1036 cmp_it->stop_pos = endpos = start;
1037 cmp_it->ch = -1;
1039 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
1040 || NILP (Vauto_composition_mode))
1041 return;
1042 if (bytepos < 0)
1044 if (NILP (string))
1045 bytepos = CHAR_TO_BYTE (charpos);
1046 else
1047 bytepos = string_char_to_byte (string, charpos);
1050 start = charpos;
1051 if (charpos < endpos)
1053 /* Forward search. */
1054 while (charpos < endpos)
1056 if (STRINGP (string))
1057 FETCH_STRING_CHAR_ADVANCE (c, string, charpos, bytepos);
1058 else
1059 FETCH_CHAR_ADVANCE (c, charpos, bytepos);
1060 if (c == '\n')
1062 cmp_it->ch = -2;
1063 break;
1065 val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1066 if (! NILP (val))
1068 Lisp_Object elt;
1069 int ridx;
1071 for (ridx = 0; CONSP (val); val = XCDR (val), ridx++)
1073 elt = XCAR (val);
1074 if (VECTORP (elt) && ASIZE (elt) == 3
1075 && NATNUMP (AREF (elt, 1))
1076 && charpos - 1 - XFASTINT (AREF (elt, 1)) >= start)
1077 break;
1079 if (CONSP (val))
1081 cmp_it->rule_idx = ridx;
1082 cmp_it->lookback = XFASTINT (AREF (elt, 1));
1083 cmp_it->stop_pos = charpos - 1 - cmp_it->lookback;
1084 cmp_it->ch = c;
1085 return;
1089 if (charpos == endpos)
1091 /* We couldn't find a composition point before ENDPOS. But,
1092 some character after ENDPOS may be composed with
1093 characters before ENDPOS. So, we should stop at the safe
1094 point. */
1095 charpos = endpos - MAX_AUTO_COMPOSITION_LOOKBACK;
1096 if (charpos < start)
1097 charpos = start;
1100 else if (charpos > endpos)
1102 /* Search backward for a pattern that may be composed and the
1103 position of (possibly) the last character of the match is
1104 closest to (but not after) START. The reason for the last
1105 character is that set_iterator_to_next works in reverse order,
1106 and thus we must stop at the last character for composition
1107 check. */
1108 unsigned char *p;
1109 int len;
1110 /* Limit byte position used in fast_looking_at. This is the
1111 byte position of the character after START. */
1112 ptrdiff_t limit;
1114 if (NILP (string))
1115 p = BYTE_POS_ADDR (bytepos);
1116 else
1117 p = SDATA (string) + bytepos;
1118 c = STRING_CHAR_AND_LENGTH (p, len);
1119 limit = bytepos + len;
1120 while (CHAR_COMPOSABLE_P (c))
1122 val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1123 if (! NILP (val))
1125 Lisp_Object elt;
1126 int ridx, blen;
1128 for (ridx = 0; CONSP (val); val = XCDR (val), ridx++)
1130 elt = XCAR (val);
1131 if (VECTORP (elt) && ASIZE (elt) == 3
1132 && NATNUMP (AREF (elt, 1))
1133 && charpos - XFASTINT (AREF (elt, 1)) > endpos)
1135 ptrdiff_t back = XFASTINT (AREF (elt, 1));
1136 ptrdiff_t cpos = charpos - back, bpos;
1138 if (back == 0)
1139 bpos = bytepos;
1140 else
1141 bpos = (NILP (string) ? CHAR_TO_BYTE (cpos)
1142 : string_char_to_byte (string, cpos));
1143 if (STRINGP (AREF (elt, 0)))
1144 blen = fast_looking_at (AREF (elt, 0), cpos, bpos,
1145 start + 1, limit, string);
1146 else
1147 blen = 1;
1148 if (blen > 0)
1150 /* Make CPOS point to the last character of
1151 match. Note that BLEN is byte-length. */
1152 if (blen > 1)
1154 bpos += blen;
1155 if (NILP (string))
1156 cpos = BYTE_TO_CHAR (bpos) - 1;
1157 else
1158 cpos = string_byte_to_char (string, bpos) - 1;
1160 back = cpos - (charpos - back);
1161 if (cmp_it->stop_pos < cpos
1162 || (cmp_it->stop_pos == cpos
1163 && cmp_it->lookback < back))
1165 cmp_it->rule_idx = ridx;
1166 cmp_it->stop_pos = cpos;
1167 cmp_it->ch = c;
1168 cmp_it->lookback = back;
1169 cmp_it->nchars = back + 1;
1175 if (charpos - 1 == endpos)
1176 break;
1177 if (STRINGP (string))
1179 p--, bytepos--;
1180 while (! CHAR_HEAD_P (*p))
1181 p--, bytepos--;
1182 charpos--;
1184 else
1186 DEC_BOTH (charpos, bytepos);
1187 p = BYTE_POS_ADDR (bytepos);
1189 c = STRING_CHAR (p);
1191 if (cmp_it->ch >= 0)
1192 /* We found a position to check. */
1193 return;
1194 /* Skip all uncomposable characters. */
1195 if (NILP (string))
1197 while (charpos - 1 > endpos && ! CHAR_COMPOSABLE_P (c))
1199 DEC_BOTH (charpos, bytepos);
1200 c = FETCH_MULTIBYTE_CHAR (bytepos);
1203 else
1205 while (charpos - 1 > endpos && ! CHAR_COMPOSABLE_P (c))
1207 p--;
1208 while (! CHAR_HEAD_P (*p))
1209 p--;
1210 charpos--;
1211 c = STRING_CHAR (p);
1215 cmp_it->stop_pos = charpos;
1218 /* Check if the character at CHARPOS (and BYTEPOS) is composed
1219 (possibly with the following characters) on window W. ENDPOS limits
1220 characters to be composed. FACE, in non-NULL, is a base face of
1221 the character. If STRING is not nil, it is a string containing the
1222 character to check, and CHARPOS and BYTEPOS are indices in the
1223 string. In that case, FACE must not be NULL.
1225 If the character is composed, setup members of CMP_IT (id, nglyphs,
1226 from, to, reversed_p), and return 1. Otherwise, update
1227 CMP_IT->stop_pos, and return 0. */
1230 composition_reseat_it (struct composition_it *cmp_it, ptrdiff_t charpos, ptrdiff_t bytepos, ptrdiff_t endpos, struct window *w, struct face *face, Lisp_Object string)
1232 if (endpos < 0)
1233 endpos = NILP (string) ? BEGV : 0;
1235 if (cmp_it->ch == -2)
1237 composition_compute_stop_pos (cmp_it, charpos, bytepos, endpos, string);
1238 if (cmp_it->ch == -2 || cmp_it->stop_pos != charpos)
1239 /* The current position is not composed. */
1240 return 0;
1243 if (cmp_it->ch < 0)
1245 /* We are looking at a static composition. */
1246 ptrdiff_t start, end;
1247 Lisp_Object prop;
1249 find_composition (charpos, -1, &start, &end, &prop, string);
1250 cmp_it->id = get_composition_id (charpos, bytepos, end - start,
1251 prop, string);
1252 if (cmp_it->id < 0)
1253 goto no_composition;
1254 cmp_it->nchars = end - start;
1255 cmp_it->nglyphs = composition_table[cmp_it->id]->glyph_len;
1257 else if (w)
1259 Lisp_Object lgstring = Qnil;
1260 Lisp_Object val, elt;
1261 ptrdiff_t i;
1263 val = CHAR_TABLE_REF (Vcomposition_function_table, cmp_it->ch);
1264 for (i = 0; i < cmp_it->rule_idx; i++, val = XCDR (val));
1265 if (charpos < endpos)
1267 for (; CONSP (val); val = XCDR (val))
1269 elt = XCAR (val);
1270 if (! VECTORP (elt) || ASIZE (elt) != 3
1271 || ! INTEGERP (AREF (elt, 1)))
1272 continue;
1273 if (XFASTINT (AREF (elt, 1)) != cmp_it->lookback)
1274 goto no_composition;
1275 lgstring = autocmp_chars (elt, charpos, bytepos, endpos,
1276 w, face, string);
1277 if (composition_gstring_p (lgstring))
1278 break;
1279 lgstring = Qnil;
1280 /* Composition failed perhaps because the font doesn't
1281 support sufficient range of characters. Try the
1282 other composition rules if any. */
1284 cmp_it->reversed_p = 0;
1286 else
1288 ptrdiff_t cpos = charpos, bpos = bytepos;
1290 while (1)
1292 elt = XCAR (val);
1293 if (cmp_it->lookback > 0)
1295 cpos = charpos - cmp_it->lookback;
1296 if (STRINGP (string))
1297 bpos = string_char_to_byte (string, cpos);
1298 else
1299 bpos = CHAR_TO_BYTE (cpos);
1301 lgstring = autocmp_chars (elt, cpos, bpos, charpos + 1, w, face,
1302 string);
1303 if (composition_gstring_p (lgstring)
1304 && cpos + LGSTRING_CHAR_LEN (lgstring) - 1 == charpos)
1305 break;
1306 /* Composition failed or didn't cover the current
1307 character. */
1308 if (cmp_it->lookback == 0)
1309 goto no_composition;
1310 lgstring = Qnil;
1311 /* Try to find a shorter composition that starts after CPOS. */
1312 composition_compute_stop_pos (cmp_it, charpos, bytepos, cpos,
1313 string);
1314 if (cmp_it->ch == -2 || cmp_it->stop_pos < charpos)
1315 goto no_composition;
1316 val = CHAR_TABLE_REF (Vcomposition_function_table, cmp_it->ch);
1317 for (i = 0; i < cmp_it->rule_idx; i++, val = XCDR (val));
1319 cmp_it->reversed_p = 1;
1321 if (NILP (lgstring))
1322 goto no_composition;
1323 if (NILP (LGSTRING_ID (lgstring)))
1324 lgstring = composition_gstring_put_cache (lgstring, -1);
1325 cmp_it->id = XINT (LGSTRING_ID (lgstring));
1326 for (i = 0; i < LGSTRING_GLYPH_LEN (lgstring); i++)
1327 if (NILP (LGSTRING_GLYPH (lgstring, i)))
1328 break;
1329 cmp_it->nglyphs = i;
1330 cmp_it->from = 0;
1331 cmp_it->to = i;
1333 else
1334 goto no_composition;
1335 return 1;
1337 no_composition:
1338 if (charpos == endpos)
1339 return 0;
1340 if (charpos < endpos)
1342 charpos++;
1343 if (NILP (string))
1344 INC_POS (bytepos);
1345 else
1346 bytepos += BYTES_BY_CHAR_HEAD (*(SDATA (string) + bytepos));
1348 else
1350 charpos--;
1351 /* BYTEPOS is calculated in composition_compute_stop_pos */
1352 bytepos = -1;
1354 composition_compute_stop_pos (cmp_it, charpos, bytepos, endpos, string);
1355 return 0;
1358 /* Update charpos, nchars, nbytes, and width of the current grapheme
1359 cluster.
1361 If the composition is static or automatic in L2R context, the
1362 cluster is identified by CMP_IT->from, and CHARPOS is the position
1363 of the first character of the cluster. In this case, update
1364 CMP_IT->to too.
1366 If the composition is automatic in R2L context, the cluster is
1367 identified by CMP_IT->to, and CHARPOS is the position of the last
1368 character of the cluster. In this case, update CMP_IT->from too.
1370 The return value is the character code of the first character of
1371 the cluster, or -1 if the composition is somehow broken. */
1374 composition_update_it (struct composition_it *cmp_it, ptrdiff_t charpos, ptrdiff_t bytepos, Lisp_Object string)
1376 int i, c IF_LINT (= 0);
1378 if (cmp_it->ch < 0)
1380 /* static composition */
1381 struct composition *cmp = composition_table[cmp_it->id];
1383 cmp_it->charpos = charpos;
1384 cmp_it->to = cmp_it->nglyphs;
1385 if (cmp_it->nglyphs == 0)
1386 c = -1;
1387 else
1389 for (i = 0; i < cmp->glyph_len; i++)
1390 /* TAB in a composition means display glyphs with padding
1391 space on the left or right. */
1392 if ((c = COMPOSITION_GLYPH (cmp, i)) != '\t')
1393 break;
1394 if (c == '\t')
1395 c = ' ';
1397 cmp_it->width = cmp->width;
1398 charpos += cmp_it->nchars;
1399 if (STRINGP (string))
1400 cmp_it->nbytes = string_char_to_byte (string, charpos) - bytepos;
1401 else
1402 cmp_it->nbytes = CHAR_TO_BYTE (charpos) - bytepos;
1404 else
1406 /* automatic composition */
1407 Lisp_Object gstring = composition_gstring_from_id (cmp_it->id);
1408 Lisp_Object glyph;
1409 ptrdiff_t from;
1411 if (cmp_it->nglyphs == 0)
1413 cmp_it->nchars = LGSTRING_CHAR_LEN (gstring);
1414 cmp_it->width = 0;
1415 cmp_it->from = cmp_it->to = 0;
1416 return -1;
1418 if (! cmp_it->reversed_p)
1420 glyph = LGSTRING_GLYPH (gstring, cmp_it->from);
1421 from = LGLYPH_FROM (glyph);
1422 for (cmp_it->to = cmp_it->from + 1; cmp_it->to < cmp_it->nglyphs;
1423 cmp_it->to++)
1425 glyph = LGSTRING_GLYPH (gstring, cmp_it->to);
1426 if (LGLYPH_FROM (glyph) != from)
1427 break;
1429 cmp_it->charpos = charpos;
1431 else
1433 glyph = LGSTRING_GLYPH (gstring, cmp_it->to - 1);
1434 from = LGLYPH_FROM (glyph);
1435 cmp_it->charpos = charpos - (LGLYPH_TO (glyph) - from);
1436 for (cmp_it->from = cmp_it->to - 1; cmp_it->from > 0;
1437 cmp_it->from--)
1439 glyph = LGSTRING_GLYPH (gstring, cmp_it->from - 1);
1440 if (LGLYPH_FROM (glyph) != from)
1441 break;
1444 glyph = LGSTRING_GLYPH (gstring, cmp_it->from);
1445 cmp_it->nchars = LGLYPH_TO (glyph) + 1 - from;
1446 cmp_it->nbytes = 0;
1447 cmp_it->width = 0;
1448 for (i = cmp_it->nchars - 1; i >= 0; i--)
1450 c = XINT (LGSTRING_CHAR (gstring, i));
1451 cmp_it->nbytes += CHAR_BYTES (c);
1452 cmp_it->width += CHAR_WIDTH (c);
1455 return c;
1459 struct position_record
1461 ptrdiff_t pos, pos_byte;
1462 unsigned char *p;
1465 /* Update the members of POSITION to the next character boundary. */
1466 #define FORWARD_CHAR(POSITION, STOP) \
1467 do { \
1468 (POSITION).pos++; \
1469 if ((POSITION).pos == (STOP)) \
1471 (POSITION).p = GAP_END_ADDR; \
1472 (POSITION).pos_byte = GPT_BYTE; \
1474 else \
1476 (POSITION).pos_byte += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
1477 (POSITION).p += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
1479 } while (0)
1481 /* Update the members of POSITION to the previous character boundary. */
1482 #define BACKWARD_CHAR(POSITION, STOP) \
1483 do { \
1484 if ((POSITION).pos == (STOP)) \
1485 (POSITION).p = GPT_ADDR; \
1486 do { \
1487 (POSITION).pos_byte--; \
1488 (POSITION).p--; \
1489 } while (! CHAR_HEAD_P (*((POSITION).p))); \
1490 (POSITION).pos--; \
1491 } while (0)
1493 /* This is like find_composition, but find an automatic composition
1494 instead. It is assured that POS is not within a static
1495 composition. If found, set *GSTRING to the glyph-string
1496 representing the composition, and return 1. Otherwise, *GSTRING to
1497 Qnil, and return 0. */
1499 static int
1500 find_automatic_composition (ptrdiff_t pos, ptrdiff_t limit,
1501 ptrdiff_t *start, ptrdiff_t *end,
1502 Lisp_Object *gstring, Lisp_Object string)
1504 ptrdiff_t head, tail, stop;
1505 /* Forward limit position of checking a composition taking a
1506 looking-back count into account. */
1507 ptrdiff_t fore_check_limit;
1508 struct position_record cur, prev;
1509 int c;
1510 Lisp_Object window;
1511 struct window *w;
1512 int need_adjustment = 0;
1514 window = Fget_buffer_window (Fcurrent_buffer (), Qnil);
1515 if (NILP (window))
1516 return 0;
1517 w = XWINDOW (window);
1519 cur.pos = pos;
1520 if (NILP (string))
1522 head = BEGV, tail = ZV, stop = GPT;
1523 cur.pos_byte = CHAR_TO_BYTE (cur.pos);
1524 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1526 else
1528 head = 0, tail = SCHARS (string), stop = -1;
1529 cur.pos_byte = string_char_to_byte (string, cur.pos);
1530 cur.p = SDATA (string) + cur.pos_byte;
1532 if (limit < 0)
1533 /* Finding a composition covering the character after POS is the
1534 same as setting LIMIT to POS. */
1535 limit = pos;
1536 if (limit <= pos)
1537 fore_check_limit = min (tail, pos + 1 + MAX_AUTO_COMPOSITION_LOOKBACK);
1538 else
1539 fore_check_limit = min (tail, limit + MAX_AUTO_COMPOSITION_LOOKBACK);
1541 /* Provided that we have these possible compositions now:
1543 POS: 1 2 3 4 5 6 7 8 9
1544 |-A-|
1545 |-B-|-C-|--D--|
1547 Here, it is known that characters after positions 1 and 9 can
1548 never be composed (i.e. ! CHAR_COMPOSABLE_P (CH)), and
1549 composition A is an invalid one because it's partially covered by
1550 the valid composition C. And to know whether a composition is
1551 valid or not, the only way is to start searching forward from a
1552 position that can not be a tail part of composition (it's 2 in
1553 the above case).
1555 Now we have these cases (1 through 4):
1557 -- character after POS is ... --
1558 not composable composable
1559 LIMIT <= POS (1) (3)
1560 POS < LIMIT (2) (4)
1562 Among them, in case (2), we simply search forward from POS.
1564 In the other cases, we at first rewind back to the position where
1565 the previous character is not composable or the beginning of
1566 buffer (string), then search compositions forward. In case (1)
1567 and (3) we repeat this process until a composition is found. */
1569 while (1)
1571 c = STRING_CHAR (cur.p);
1572 if (! CHAR_COMPOSABLE_P (c))
1574 if (limit <= pos) /* case (1) */
1576 do {
1577 if (cur.pos <= limit)
1578 return 0;
1579 BACKWARD_CHAR (cur, stop);
1580 c = STRING_CHAR (cur.p);
1581 } while (! CHAR_COMPOSABLE_P (c));
1582 fore_check_limit = cur.pos + 1;
1584 else /* case (2) */
1585 /* No need of rewinding back. */
1586 goto search_forward;
1589 /* Rewind back to the position where we can safely search
1590 forward for compositions. It is assured that the character
1591 at cur.pos is composable. */
1592 while (head < cur.pos)
1594 prev = cur;
1595 BACKWARD_CHAR (cur, stop);
1596 c = STRING_CHAR (cur.p);
1597 if (! CHAR_COMPOSABLE_P (c))
1599 cur = prev;
1600 break;
1604 search_forward:
1605 /* Now search forward. */
1606 *gstring = Qnil;
1607 prev = cur; /* remember the start of searching position. */
1608 while (cur.pos < fore_check_limit)
1610 Lisp_Object val;
1612 c = STRING_CHAR (cur.p);
1613 for (val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1614 CONSP (val); val = XCDR (val))
1616 Lisp_Object elt = XCAR (val);
1618 if (VECTORP (elt) && ASIZE (elt) == 3 && NATNUMP (AREF (elt, 1)))
1620 EMACS_INT check_pos = cur.pos - XFASTINT (AREF (elt, 1));
1621 struct position_record check;
1623 if (check_pos < head
1624 || (limit <= pos ? pos < check_pos
1625 : limit <= check_pos))
1626 continue;
1627 for (check = cur; check_pos < check.pos; )
1628 BACKWARD_CHAR (check, stop);
1629 *gstring = autocmp_chars (elt, check.pos, check.pos_byte,
1630 tail, w, NULL, string);
1631 need_adjustment = 1;
1632 if (NILP (*gstring))
1634 /* As we have called Lisp, there's a possibility
1635 that buffer/string is relocated. */
1636 if (NILP (string))
1637 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1638 else
1639 cur.p = SDATA (string) + cur.pos_byte;
1641 else
1643 /* We found a candidate of a target composition. */
1644 *start = check.pos;
1645 *end = check.pos + LGSTRING_CHAR_LEN (*gstring);
1646 if (pos < limit
1647 ? pos < *end
1648 : *start <= pos && pos < *end)
1649 /* This is the target composition. */
1650 return 1;
1651 cur.pos = *end;
1652 if (NILP (string))
1654 cur.pos_byte = CHAR_TO_BYTE (cur.pos);
1655 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1657 else
1659 cur.pos_byte = string_char_to_byte (string, cur.pos);
1660 cur.p = SDATA (string) + cur.pos_byte;
1662 break;
1666 if (! CONSP (val))
1667 /* We found no composition here. */
1668 FORWARD_CHAR (cur, stop);
1671 if (pos < limit) /* case (2) and (4)*/
1672 return 0;
1673 if (! NILP (*gstring))
1674 return 1;
1675 if (prev.pos == head)
1676 return 0;
1677 cur = prev;
1678 if (need_adjustment)
1680 if (NILP (string))
1681 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1682 else
1683 cur.p = SDATA (string) + cur.pos_byte;
1685 BACKWARD_CHAR (cur, stop);
1689 /* Return the adjusted point provided that point is moved from LAST_PT
1690 to NEW_PT. */
1692 ptrdiff_t
1693 composition_adjust_point (ptrdiff_t last_pt, ptrdiff_t new_pt)
1695 ptrdiff_t i, beg, end;
1696 Lisp_Object val;
1698 if (new_pt == BEGV || new_pt == ZV)
1699 return new_pt;
1701 /* At first check the static composition. */
1702 if (get_property_and_range (new_pt, Qcomposition, &val, &beg, &end, Qnil)
1703 && COMPOSITION_VALID_P (beg, end, val))
1705 if (beg < new_pt /* && end > new_pt <- It's always the case. */
1706 && (last_pt <= beg || last_pt >= end))
1707 return (new_pt < last_pt ? beg : end);
1708 return new_pt;
1711 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
1712 || NILP (Vauto_composition_mode))
1713 return new_pt;
1715 /* Next check the automatic composition. */
1716 if (! find_automatic_composition (new_pt, (ptrdiff_t) -1, &beg, &end, &val,
1717 Qnil)
1718 || beg == new_pt)
1719 return new_pt;
1720 for (i = 0; i < LGSTRING_GLYPH_LEN (val); i++)
1722 Lisp_Object glyph = LGSTRING_GLYPH (val, i);
1724 if (NILP (glyph))
1725 break;
1726 if (beg + LGLYPH_FROM (glyph) == new_pt)
1727 return new_pt;
1728 if (beg + LGLYPH_TO (glyph) >= new_pt)
1729 return (new_pt < last_pt
1730 ? beg + LGLYPH_FROM (glyph)
1731 : beg + LGLYPH_TO (glyph) + 1);
1733 return new_pt;
1736 DEFUN ("composition-get-gstring", Fcomposition_get_gstring,
1737 Scomposition_get_gstring, 4, 4, 0,
1738 doc: /* Return a glyph-string for characters between FROM and TO.
1739 If the glyph string is for graphic display, FONT-OBJECT must be
1740 a font-object to use for those characters.
1741 Otherwise (for terminal display), FONT-OBJECT must be a terminal ID, a
1742 frame, or nil for the selected frame's terminal device.
1744 If the optional 4th argument STRING is not nil, it is a string
1745 containing the target characters between indices FROM and TO.
1747 A glyph-string is a vector containing information about how to display
1748 a specific character sequence. The format is:
1749 [HEADER ID GLYPH ...]
1751 HEADER is a vector of this form:
1752 [FONT-OBJECT CHAR ...]
1753 where
1754 FONT-OBJECT is a font-object for all glyphs in the glyph-string,
1755 or the terminal coding system of the specified terminal.
1756 CHARs are characters to be composed by GLYPHs.
1758 ID is an identification number of the glyph-string. It may be nil if
1759 not yet shaped.
1761 GLYPH is a vector whose elements have this form:
1762 [ FROM-IDX TO-IDX C CODE WIDTH LBEARING RBEARING ASCENT DESCENT
1763 [ [X-OFF Y-OFF WADJUST] | nil] ]
1764 where
1765 FROM-IDX and TO-IDX are used internally and should not be touched.
1766 C is the character of the glyph.
1767 CODE is the glyph-code of C in FONT-OBJECT.
1768 WIDTH thru DESCENT are the metrics (in pixels) of the glyph.
1769 X-OFF and Y-OFF are offsets to the base position for the glyph.
1770 WADJUST is the adjustment to the normal width of the glyph.
1772 If GLYPH is nil, the remaining elements of the glyph-string vector
1773 should be ignored. */)
1774 (Lisp_Object from, Lisp_Object to, Lisp_Object font_object, Lisp_Object string)
1776 Lisp_Object gstring, header;
1777 ptrdiff_t frompos, topos;
1779 CHECK_NATNUM (from);
1780 CHECK_NATNUM (to);
1781 if (! FONT_OBJECT_P (font_object))
1783 struct coding_system *coding;
1784 struct terminal *terminal = get_terminal (font_object, 1);
1786 coding = ((TERMINAL_TERMINAL_CODING (terminal)->common_flags
1787 & CODING_REQUIRE_ENCODING_MASK)
1788 ? TERMINAL_TERMINAL_CODING (terminal) : &safe_terminal_coding);
1789 font_object = CODING_ID_NAME (coding->id);
1792 header = fill_gstring_header (Qnil, from, to, font_object, string);
1793 gstring = gstring_lookup_cache (header);
1794 if (! NILP (gstring))
1795 return gstring;
1797 frompos = XINT (from);
1798 topos = XINT (to);
1799 if (LGSTRING_GLYPH_LEN (gstring_work) < topos - frompos)
1800 gstring_work = Fmake_vector (make_number (topos - frompos + 2), Qnil);
1801 LGSTRING_SET_HEADER (gstring_work, header);
1802 LGSTRING_SET_ID (gstring_work, Qnil);
1803 fill_gstring_body (gstring_work);
1804 return gstring_work;
1808 /* Emacs Lisp APIs. */
1810 DEFUN ("compose-region-internal", Fcompose_region_internal,
1811 Scompose_region_internal, 2, 4, 0,
1812 doc: /* Internal use only.
1814 Compose text in the region between START and END.
1815 Optional 3rd and 4th arguments are COMPONENTS and MODIFICATION-FUNC
1816 for the composition. See `compose-region' for more details. */)
1817 (Lisp_Object start, Lisp_Object end, Lisp_Object components, Lisp_Object modification_func)
1819 validate_region (&start, &end);
1820 if (!NILP (components)
1821 && !INTEGERP (components)
1822 && !CONSP (components)
1823 && !STRINGP (components))
1824 CHECK_VECTOR (components);
1826 compose_text (XINT (start), XINT (end), components, modification_func, Qnil);
1827 return Qnil;
1830 DEFUN ("compose-string-internal", Fcompose_string_internal,
1831 Scompose_string_internal, 3, 5, 0,
1832 doc: /* Internal use only.
1834 Compose text between indices START and END of STRING.
1835 Optional 4th and 5th arguments are COMPONENTS and MODIFICATION-FUNC
1836 for the composition. See `compose-string' for more details. */)
1837 (Lisp_Object string, Lisp_Object start, Lisp_Object end, Lisp_Object components, Lisp_Object modification_func)
1839 CHECK_STRING (string);
1840 CHECK_NUMBER (start);
1841 CHECK_NUMBER (end);
1843 if (XINT (start) < 0 ||
1844 XINT (start) > XINT (end)
1845 || XINT (end) > SCHARS (string))
1846 args_out_of_range (start, end);
1848 compose_text (XINT (start), XINT (end), components, modification_func, string);
1849 return string;
1852 DEFUN ("find-composition-internal", Ffind_composition_internal,
1853 Sfind_composition_internal, 4, 4, 0,
1854 doc: /* Internal use only.
1856 Return information about composition at or nearest to position POS.
1857 See `find-composition' for more details. */)
1858 (Lisp_Object pos, Lisp_Object limit, Lisp_Object string, Lisp_Object detail_p)
1860 Lisp_Object prop, tail, gstring;
1861 ptrdiff_t start, end, from, to;
1862 int id;
1864 CHECK_NUMBER_COERCE_MARKER (pos);
1865 if (!NILP (limit))
1867 CHECK_NUMBER_COERCE_MARKER (limit);
1868 to = min (XINT (limit), ZV);
1870 else
1871 to = -1;
1873 if (!NILP (string))
1875 CHECK_STRING (string);
1876 if (XINT (pos) < 0 || XINT (pos) > SCHARS (string))
1877 args_out_of_range (string, pos);
1879 else
1881 if (XINT (pos) < BEGV || XINT (pos) > ZV)
1882 args_out_of_range (Fcurrent_buffer (), pos);
1884 from = XINT (pos);
1886 if (!find_composition (from, to, &start, &end, &prop, string))
1888 if (!NILP (BVAR (current_buffer, enable_multibyte_characters))
1889 && ! NILP (Vauto_composition_mode)
1890 && find_automatic_composition (from, to, &start, &end, &gstring,
1891 string))
1892 return list3 (make_number (start), make_number (end), gstring);
1893 return Qnil;
1895 if ((end <= XINT (pos) || start > XINT (pos)))
1897 ptrdiff_t s, e;
1899 if (find_automatic_composition (from, to, &s, &e, &gstring, string)
1900 && (e <= XINT (pos) ? e > end : s < start))
1901 return list3 (make_number (s), make_number (e), gstring);
1903 if (!COMPOSITION_VALID_P (start, end, prop))
1904 return Fcons (make_number (start), Fcons (make_number (end),
1905 Fcons (Qnil, Qnil)));
1906 if (NILP (detail_p))
1907 return Fcons (make_number (start), Fcons (make_number (end),
1908 Fcons (Qt, Qnil)));
1910 if (COMPOSITION_REGISTERD_P (prop))
1911 id = COMPOSITION_ID (prop);
1912 else
1914 ptrdiff_t start_byte = (NILP (string)
1915 ? CHAR_TO_BYTE (start)
1916 : string_char_to_byte (string, start));
1917 id = get_composition_id (start, start_byte, end - start, prop, string);
1920 if (id >= 0)
1922 Lisp_Object components, relative_p, mod_func;
1923 enum composition_method method = COMPOSITION_METHOD (prop);
1924 int width = composition_table[id]->width;
1926 components = Fcopy_sequence (COMPOSITION_COMPONENTS (prop));
1927 relative_p = (method == COMPOSITION_WITH_RULE_ALTCHARS
1928 ? Qnil : Qt);
1929 mod_func = COMPOSITION_MODIFICATION_FUNC (prop);
1930 tail = Fcons (components,
1931 Fcons (relative_p,
1932 Fcons (mod_func,
1933 Fcons (make_number (width), Qnil))));
1935 else
1936 tail = Qnil;
1938 return Fcons (make_number (start), Fcons (make_number (end), tail));
1942 void
1943 syms_of_composite (void)
1945 int i;
1947 DEFSYM (Qcomposition, "composition");
1949 /* Make a hash table for static composition. */
1951 Lisp_Object args[6];
1953 args[0] = QCtest;
1954 args[1] = Qequal;
1955 args[2] = QCweakness;
1956 /* We used to make the hash table weak so that unreferenced
1957 compositions can be garbage-collected. But, usually once
1958 created compositions are repeatedly used in an Emacs session,
1959 and thus it's not worth to save memory in such a way. So, we
1960 make the table not weak. */
1961 args[3] = Qnil;
1962 args[4] = QCsize;
1963 args[5] = make_number (311);
1964 composition_hash_table = Fmake_hash_table (6, args);
1965 staticpro (&composition_hash_table);
1968 /* Make a hash table for glyph-string. */
1970 Lisp_Object args[6];
1971 args[0] = QCtest;
1972 args[1] = Qequal;
1973 args[2] = QCweakness;
1974 args[3] = Qnil;
1975 args[4] = QCsize;
1976 args[5] = make_number (311);
1977 gstring_hash_table = Fmake_hash_table (6, args);
1978 staticpro (&gstring_hash_table);
1981 staticpro (&gstring_work_headers);
1982 gstring_work_headers = Fmake_vector (make_number (8), Qnil);
1983 for (i = 0; i < 8; i++)
1984 ASET (gstring_work_headers, i, Fmake_vector (make_number (i + 2), Qnil));
1985 staticpro (&gstring_work);
1986 gstring_work = Fmake_vector (make_number (10), Qnil);
1988 /* Text property `composition' should be nonsticky by default. */
1989 Vtext_property_default_nonsticky
1990 = Fcons (Fcons (Qcomposition, Qt), Vtext_property_default_nonsticky);
1992 DEFVAR_LISP ("compose-chars-after-function", Vcompose_chars_after_function,
1993 doc: /* Function to adjust composition of buffer text.
1995 This function is called with three arguments: FROM, TO, and OBJECT.
1996 FROM and TO specify the range of text whose composition should be
1997 adjusted. OBJECT, if non-nil, is a string that contains the text.
1999 This function is called after a text with `composition' property is
2000 inserted or deleted to keep `composition' property of buffer text
2001 valid.
2003 The default value is the function `compose-chars-after'. */);
2004 Vcompose_chars_after_function = intern_c_string ("compose-chars-after");
2006 DEFSYM (Qauto_composed, "auto-composed");
2007 DEFSYM (Qauto_composition_function, "auto-composition-function");
2009 DEFVAR_LISP ("auto-composition-mode", Vauto_composition_mode,
2010 doc: /* Non-nil if Auto-Composition mode is enabled.
2011 Use the command `auto-composition-mode' to change this variable. */);
2012 Vauto_composition_mode = Qt;
2014 DEFVAR_LISP ("auto-composition-function", Vauto_composition_function,
2015 doc: /* Function to call to compose characters automatically.
2016 This function is called from the display routine with four arguments:
2017 FROM, TO, WINDOW, and STRING.
2019 If STRING is nil, the function must compose characters in the region
2020 between FROM and TO in the current buffer.
2022 Otherwise, STRING is a string, and FROM and TO are indices into the
2023 string. In this case, the function must compose characters in the
2024 string. */);
2025 Vauto_composition_function = Qnil;
2027 DEFVAR_LISP ("composition-function-table", Vcomposition_function_table,
2028 doc: /* Char-table of functions for automatic character composition.
2029 For each character that has to be composed automatically with
2030 preceding and/or following characters, this char-table contains
2031 a function to call to compose that character.
2033 The element at index C in the table, if non-nil, is a list of
2034 composition rules of this form: ([PATTERN PREV-CHARS FUNC] ...)
2036 PATTERN is a regular expression which C and the surrounding
2037 characters must match.
2039 PREV-CHARS is a non-negative integer (less than 4) specifying how many
2040 characters before C to check the matching with PATTERN. If it is 0,
2041 PATTERN must match C and the following characters. If it is 1,
2042 PATTERN must match a character before C and the following characters.
2044 If PREV-CHARS is 0, PATTERN can be nil, which means that the
2045 single character C should be composed.
2047 FUNC is a function to return a glyph-string representing a
2048 composition of the characters that match PATTERN. It is
2049 called with one argument GSTRING.
2051 GSTRING is a template of a glyph-string to return. It is already
2052 filled with a proper header for the characters to compose, and
2053 glyphs corresponding to those characters one by one. The
2054 function must return a new glyph-string with the same header as
2055 GSTRING, or modify GSTRING itself and return it.
2057 See also the documentation of `auto-composition-mode'. */);
2058 Vcomposition_function_table = Fmake_char_table (Qnil, Qnil);
2060 defsubr (&Scompose_region_internal);
2061 defsubr (&Scompose_string_internal);
2062 defsubr (&Sfind_composition_internal);
2063 defsubr (&Scomposition_get_gstring);