Add missing copyright years.
[emacs.git] / src / composite.c
blob92bedcc5f2b1d3d2e829924f2ff41c9088db298b
1 /* Composite sequence support.
2 Copyright (C) 2001, 2002, 2003, 2004, 2005,
3 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
4 Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
5 National Institute of Advanced Industrial Science and Technology (AIST)
6 Registration Number H14PRO021
7 Copyright (C) 2003, 2006
8 National Institute of Advanced Industrial Science and Technology (AIST)
9 Registration Number H13PRO009
11 This file is part of GNU Emacs.
13 GNU Emacs is free software: you can redistribute it and/or modify
14 it under the terms of the GNU General Public License as published by
15 the Free Software Foundation, either version 3 of the License, or
16 (at your option) any later version.
18 GNU Emacs is distributed in the hope that it will be useful,
19 but WITHOUT ANY WARRANTY; without even the implied warranty of
20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 GNU General Public License for more details.
23 You should have received a copy of the GNU General Public License
24 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
26 #include <config.h>
27 #include <setjmp.h>
28 #include "lisp.h"
29 #include "buffer.h"
30 #include "character.h"
31 #include "coding.h"
32 #include "intervals.h"
33 #include "window.h"
34 #include "frame.h"
35 #include "dispextern.h"
36 #include "font.h"
37 #include "termhooks.h"
40 /* Emacs uses special text property `composition' to support character
41 composition. A sequence of characters that have the same (i.e. eq)
42 `composition' property value is treated as a single composite
43 sequence (we call it just `composition' here after). Characters in
44 a composition are all composed somehow on the screen.
46 The property value has this form when the composition is made:
47 ((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
48 then turns to this form:
49 (COMPOSITION-ID . (LENGTH COMPONENTS-VEC . MODIFICATION-FUNC))
50 when the composition is registered in composition_hash_table and
51 composition_table. These rather peculiar structures were designed
52 to make it easy to distinguish them quickly (we can do that by
53 checking only the first element) and to extract LENGTH (from the
54 former form) and COMPOSITION-ID (from the latter form).
56 We register a composition when it is displayed, or when the width
57 is required (for instance, to calculate columns).
59 LENGTH -- Length of the composition. This information is used to
60 check the validity of the composition.
62 COMPONENTS -- Character, string, vector, list, or nil.
64 If it is nil, characters in the text are composed relatively
65 according to their metrics in font glyphs.
67 If it is a character or a string, the character or characters
68 in the string are composed relatively.
70 If it is a vector or list of integers, the element is a
71 character or an encoded composition rule. The characters are
72 composed according to the rules. (2N)th elements are
73 characters to be composed and (2N+1)th elements are
74 composition rules to tell how to compose (2N+2)th element with
75 the previously composed 2N glyphs.
77 COMPONENTS-VEC -- Vector of integers. In a relative composition,
78 the elements are the characters to be composed. In a rule-base
79 composition, the elements are characters or encoded
80 composition rules.
82 MODIFICATION-FUNC -- If non nil, it is a function to call when the
83 composition gets invalid after a modification in a buffer. If
84 it is nil, a function in `composition-function-table' of the
85 first character in the sequence is called.
87 COMPOSITION-ID --Identification number of the composition. It is
88 used as an index to composition_table for the composition.
90 When Emacs has to display a composition or has to know its
91 displaying width, the function get_composition_id is called. It
92 returns COMPOSITION-ID so that the caller can access the
93 information about the composition through composition_table. If a
94 COMPOSITION-ID has not yet been assigned to the composition,
95 get_composition_id checks the validity of `composition' property,
96 and, if valid, assigns a new ID, registers the information in
97 composition_hash_table and composition_table, and changes the form
98 of the property value. If the property is invalid,
99 get_composition_id returns -1 without changing the property value.
101 We use two tables to keep the information about composition;
102 composition_hash_table and composition_table.
104 The former is a hash table whose keys are COMPONENTS-VECs and
105 values are the corresponding COMPOSITION-IDs. This hash table is
106 weak, but as each key (COMPONENTS-VEC) is also kept as a value of the
107 `composition' property, it won't be collected as garbage until all
108 bits of text that have the same COMPONENTS-VEC are deleted.
110 The latter is a table of pointers to `struct composition' indexed
111 by COMPOSITION-ID. This structure keeps the other information (see
112 composite.h).
114 In general, a text property holds information about individual
115 characters. But, a `composition' property holds information about
116 a sequence of characters (in this sense, it is like the `intangible'
117 property). That means that we should not share the property value
118 in adjacent compositions -- we can't distinguish them if they have the
119 same property. So, after any changes, we call
120 `update_compositions' and change a property of one of adjacent
121 compositions to a copy of it. This function also runs a proper
122 composition modification function to make a composition that gets
123 invalid by the change valid again.
125 As the value of the `composition' property holds information about a
126 specific range of text, the value gets invalid if we change the
127 text in the range. We treat the `composition' property as always
128 rear-nonsticky (currently by setting default-text-properties to
129 (rear-nonsticky (composition))) and we never make properties of
130 adjacent compositions identical. Thus, any such changes make the
131 range just shorter. So, we can check the validity of the `composition'
132 property by comparing LENGTH information with the actual length of
133 the composition.
138 Lisp_Object Qcomposition;
140 /* Table of pointers to the structure `composition' indexed by
141 COMPOSITION-ID. This structure is for storing information about
142 each composition except for COMPONENTS-VEC. */
143 struct composition **composition_table;
145 /* The current size of `composition_table'. */
146 static int composition_table_size;
148 /* Number of compositions currently made. */
149 int n_compositions;
151 /* Hash table for compositions. The key is COMPONENTS-VEC of
152 `composition' property. The value is the corresponding
153 COMPOSITION-ID. */
154 Lisp_Object composition_hash_table;
156 /* Function to call to adjust composition. */
157 Lisp_Object Vcompose_chars_after_function;
159 Lisp_Object Qauto_composed;
160 Lisp_Object Vauto_composition_mode;
161 Lisp_Object Vauto_composition_function;
162 Lisp_Object Qauto_composition_function;
163 Lisp_Object Vcomposition_function_table;
165 /* Maximum number of characters to look back for
166 auto-compositions. */
167 #define MAX_AUTO_COMPOSITION_LOOKBACK 3
169 EXFUN (Fremove_list_of_text_properties, 4);
171 /* Temporary variable used in macros COMPOSITION_XXX. */
172 Lisp_Object composition_temp;
175 /* Return COMPOSITION-ID of a composition at buffer position
176 CHARPOS/BYTEPOS and length NCHARS. The `composition' property of
177 the sequence is PROP. STRING, if non-nil, is a string that
178 contains the composition instead of the current buffer.
180 If the composition is invalid, return -1. */
183 get_composition_id (EMACS_INT charpos, EMACS_INT bytepos, EMACS_INT nchars,
184 Lisp_Object prop, Lisp_Object string)
186 Lisp_Object id, length, components, key, *key_contents;
187 int glyph_len;
188 struct Lisp_Hash_Table *hash_table = XHASH_TABLE (composition_hash_table);
189 int hash_index;
190 unsigned hash_code;
191 struct composition *cmp;
192 EMACS_INT i;
193 int ch;
195 /* PROP should be
196 Form-A: ((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
198 Form-B: (COMPOSITION-ID . (LENGTH COMPONENTS-VEC . MODIFICATION-FUNC))
200 if (nchars == 0 || !CONSP (prop))
201 goto invalid_composition;
203 id = XCAR (prop);
204 if (INTEGERP (id))
206 /* PROP should be Form-B. */
207 if (XINT (id) < 0 || XINT (id) >= n_compositions)
208 goto invalid_composition;
209 return XINT (id);
212 /* PROP should be Form-A.
213 Thus, ID should be (LENGTH . COMPONENTS). */
214 if (!CONSP (id))
215 goto invalid_composition;
216 length = XCAR (id);
217 if (!INTEGERP (length) || XINT (length) != nchars)
218 goto invalid_composition;
220 components = XCDR (id);
222 /* Check if the same composition has already been registered or not
223 by consulting composition_hash_table. The key for this table is
224 COMPONENTS (converted to a vector COMPONENTS-VEC) or, if it is
225 nil, vector of characters in the composition range. */
226 if (INTEGERP (components))
227 key = Fmake_vector (make_number (1), components);
228 else if (STRINGP (components) || CONSP (components))
229 key = Fvconcat (1, &components);
230 else if (VECTORP (components))
231 key = components;
232 else if (NILP (components))
234 key = Fmake_vector (make_number (nchars), Qnil);
235 if (STRINGP (string))
236 for (i = 0; i < nchars; i++)
238 FETCH_STRING_CHAR_ADVANCE (ch, string, charpos, bytepos);
239 XVECTOR (key)->contents[i] = make_number (ch);
241 else
242 for (i = 0; i < nchars; i++)
244 FETCH_CHAR_ADVANCE (ch, charpos, bytepos);
245 XVECTOR (key)->contents[i] = make_number (ch);
248 else
249 goto invalid_composition;
251 hash_index = hash_lookup (hash_table, key, &hash_code);
252 if (hash_index >= 0)
254 /* We have already registered the same composition. Change PROP
255 from Form-A above to Form-B while replacing COMPONENTS with
256 COMPONENTS-VEC stored in the hash table. We can directly
257 modify the cons cell of PROP because it is not shared. */
258 key = HASH_KEY (hash_table, hash_index);
259 id = HASH_VALUE (hash_table, hash_index);
260 XSETCAR (prop, id);
261 XSETCDR (prop, Fcons (make_number (nchars), Fcons (key, XCDR (prop))));
262 return XINT (id);
265 /* This composition is a new one. We must register it. */
267 /* Check if we have sufficient memory to store this information. */
268 if (composition_table_size == 0)
270 composition_table_size = 256;
271 composition_table
272 = (struct composition **) xmalloc (sizeof (composition_table[0])
273 * composition_table_size);
275 else if (composition_table_size <= n_compositions)
277 composition_table_size += 256;
278 composition_table
279 = (struct composition **) xrealloc (composition_table,
280 sizeof (composition_table[0])
281 * composition_table_size);
284 key_contents = XVECTOR (key)->contents;
286 /* Check if the contents of COMPONENTS are valid if COMPONENTS is a
287 vector or a list. It should be a sequence of:
288 char1 rule1 char2 rule2 char3 ... ruleN charN+1 */
290 if (VECTORP (components)
291 && ASIZE (components) >= 2
292 && VECTORP (AREF (components, 0)))
294 /* COMPONENTS is a glyph-string. */
295 EMACS_UINT len = ASIZE (key);
297 for (i = 1; i < len; i++)
298 if (! VECTORP (AREF (key, i)))
299 goto invalid_composition;
301 else if (VECTORP (components) || CONSP (components))
303 EMACS_UINT len = XVECTOR (key)->size;
305 /* The number of elements should be odd. */
306 if ((len % 2) == 0)
307 goto invalid_composition;
308 /* All elements should be integers (character or encoded
309 composition rule). */
310 for (i = 0; i < len; i++)
312 if (!INTEGERP (key_contents[i]))
313 goto invalid_composition;
317 /* Change PROP from Form-A above to Form-B. We can directly modify
318 the cons cell of PROP because it is not shared. */
319 XSETFASTINT (id, n_compositions);
320 XSETCAR (prop, id);
321 XSETCDR (prop, Fcons (make_number (nchars), Fcons (key, XCDR (prop))));
323 /* Register the composition in composition_hash_table. */
324 hash_index = hash_put (hash_table, key, id, hash_code);
326 /* Register the composition in composition_table. */
327 cmp = (struct composition *) xmalloc (sizeof (struct composition));
329 cmp->method = (NILP (components)
330 ? COMPOSITION_RELATIVE
331 : ((INTEGERP (components) || STRINGP (components))
332 ? COMPOSITION_WITH_ALTCHARS
333 : COMPOSITION_WITH_RULE_ALTCHARS));
334 cmp->hash_index = hash_index;
335 glyph_len = (cmp->method == COMPOSITION_WITH_RULE_ALTCHARS
336 ? (XVECTOR (key)->size + 1) / 2
337 : XVECTOR (key)->size);
338 cmp->glyph_len = glyph_len;
339 cmp->offsets = (short *) xmalloc (sizeof (short) * glyph_len * 2);
340 cmp->font = NULL;
342 if (cmp->method != COMPOSITION_WITH_RULE_ALTCHARS)
344 /* Relative composition. */
345 cmp->width = 0;
346 for (i = 0; i < glyph_len; i++)
348 int this_width;
349 ch = XINT (key_contents[i]);
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 float 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, xoff, yoff;
366 int this_width;
367 float 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_RULE (rule, gref, nref, xoff, yoff);
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 (EMACS_INT pos, EMACS_INT limit,
433 EMACS_INT *start, EMACS_INT *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 (EMACS_INT from, EMACS_INT to, Lisp_Object prop)
474 Lisp_Object func;
475 EMACS_INT 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 (EMACS_INT from, EMACS_INT to, int check_mask)
506 Lisp_Object prop;
507 EMACS_INT start, end;
508 /* The beginning and end of the region to set the property
509 `auto-composed' to nil. */
510 EMACS_INT 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 int 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 (EMACS_INT start, EMACS_INT 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, EMACS_INT, EMACS_INT,
648 EMACS_INT, 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 int 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, int len)
674 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
675 unsigned hash;
676 Lisp_Object header, copy;
677 int i;
679 header = LGSTRING_HEADER (gstring);
680 hash = h->hashfn (h, header);
681 if (len < 0)
683 len = LGSTRING_GLYPH_LEN (gstring);
684 for (i = 0; i < len; i++)
685 if (NILP (LGSTRING_GLYPH (gstring, i)))
686 break;
687 len = i;
690 copy = Fmake_vector (make_number (len + 2), Qnil);
691 LGSTRING_SET_HEADER (copy, Fcopy_sequence (header));
692 for (i = 0; i < len; i++)
693 LGSTRING_SET_GLYPH (copy, i, Fcopy_sequence (LGSTRING_GLYPH (gstring, i)));
694 i = hash_put (h, LGSTRING_HEADER (copy), copy, hash);
695 LGSTRING_SET_ID (copy, make_number (i));
696 return copy;
699 Lisp_Object
700 composition_gstring_from_id (int id)
702 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
704 return HASH_VALUE (h, id);
707 static Lisp_Object fill_gstring_header (Lisp_Object, Lisp_Object,
708 Lisp_Object, Lisp_Object,
709 Lisp_Object);
712 composition_gstring_p (Lisp_Object gstring)
714 Lisp_Object header;
715 int i;
717 if (! VECTORP (gstring) || ASIZE (gstring) < 2)
718 return 0;
719 header = LGSTRING_HEADER (gstring);
720 if (! VECTORP (header) || ASIZE (header) < 2)
721 return 0;
722 if (! NILP (LGSTRING_FONT (gstring))
723 && (! FONT_OBJECT_P (LGSTRING_FONT (gstring))
724 && ! CODING_SYSTEM_P (LGSTRING_FONT (gstring))))
725 return 0;
726 for (i = 1; i < ASIZE (LGSTRING_HEADER (gstring)); i++)
727 if (! NATNUMP (AREF (LGSTRING_HEADER (gstring), i)))
728 return 0;
729 if (! NILP (LGSTRING_ID (gstring)) && ! NATNUMP (LGSTRING_ID (gstring)))
730 return 0;
731 for (i = 0; i < LGSTRING_GLYPH_LEN (gstring); i++)
733 Lisp_Object glyph = LGSTRING_GLYPH (gstring, i);
734 if (NILP (glyph))
735 break;
736 if (! VECTORP (glyph) || ASIZE (glyph) != LGLYPH_SIZE)
737 return 0;
739 return 1;
743 composition_gstring_width (Lisp_Object gstring, EMACS_INT from, EMACS_INT to,
744 struct font_metrics *metrics)
746 Lisp_Object *glyph;
747 int width = 0;
749 if (metrics)
751 Lisp_Object font_object = LGSTRING_FONT (gstring);
753 if (FONT_OBJECT_P (font_object))
755 struct font *font = XFONT_OBJECT (font_object);
757 metrics->ascent = font->ascent;
758 metrics->descent = font->descent;
760 else
762 metrics->ascent = 1;
763 metrics->descent = 0;
765 metrics->width = metrics->lbearing = metrics->rbearing = 0;
767 for (glyph = &LGSTRING_GLYPH (gstring, from); from < to; from++, glyph++)
769 int x;
771 if (NILP (LGLYPH_ADJUSTMENT (*glyph)))
772 width += LGLYPH_WIDTH (*glyph);
773 else
774 width += LGLYPH_WADJUST (*glyph);
775 if (metrics)
777 x = metrics->width + LGLYPH_LBEARING (*glyph) + LGLYPH_XOFF (*glyph);
778 if (metrics->lbearing > x)
779 metrics->lbearing = x;
780 x = metrics->width + LGLYPH_RBEARING (*glyph) + LGLYPH_XOFF (*glyph);
781 if (metrics->rbearing < x)
782 metrics->rbearing = x;
783 metrics->width = width;
784 x = LGLYPH_ASCENT (*glyph) - LGLYPH_YOFF (*glyph);
785 if (metrics->ascent < x)
786 metrics->ascent = x;
787 x = LGLYPH_DESCENT (*glyph) + LGLYPH_YOFF (*glyph);
788 if (metrics->descent < x)
789 metrics->descent = x;
792 return width;
796 static Lisp_Object gstring_work;
797 static Lisp_Object gstring_work_headers;
799 static Lisp_Object
800 fill_gstring_header (Lisp_Object header, Lisp_Object start, Lisp_Object end, Lisp_Object font_object, Lisp_Object string)
802 EMACS_INT from, to, from_byte;
803 EMACS_INT len, i;
805 if (NILP (string))
807 if (NILP (current_buffer->enable_multibyte_characters))
808 error ("Attempt to shape unibyte text");
809 validate_region (&start, &end);
810 from = XFASTINT (start);
811 to = XFASTINT (end);
812 from_byte = CHAR_TO_BYTE (from);
814 else
816 CHECK_STRING (string);
817 if (! STRING_MULTIBYTE (string))
818 error ("Attempt to shape unibyte text");
819 /* FROM and TO are checked by the caller. */
820 from = XINT (start);
821 to = XINT (end);
822 if (from < 0 || from > to || to > SCHARS (string))
823 args_out_of_range_3 (string, start, end);
824 from_byte = string_char_to_byte (string, from);
827 len = to - from;
828 if (len == 0)
829 error ("Attempt to shape zero-length text");
830 if (VECTORP (header))
832 if (ASIZE (header) != len + 1)
833 args_out_of_range (header, make_number (len + 1));
835 else
837 if (len <= 8)
838 header = AREF (gstring_work_headers, len - 1);
839 else
840 header = Fmake_vector (make_number (len + 1), Qnil);
843 ASET (header, 0, font_object);
844 for (i = 0; i < len; i++)
846 int c;
848 if (NILP (string))
849 FETCH_CHAR_ADVANCE_NO_CHECK (c, from, from_byte);
850 else
851 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, string, from, from_byte);
852 ASET (header, i + 1, make_number (c));
854 return header;
857 static void
858 fill_gstring_body (Lisp_Object gstring)
860 Lisp_Object font_object = LGSTRING_FONT (gstring);
861 Lisp_Object header = AREF (gstring, 0);
862 EMACS_INT len = LGSTRING_CHAR_LEN (gstring);
863 EMACS_INT i;
865 for (i = 0; i < len; i++)
867 Lisp_Object g = LGSTRING_GLYPH (gstring, i);
868 EMACS_INT c = XINT (AREF (header, i + 1));
870 if (NILP (g))
872 g = LGLYPH_NEW ();
873 LGSTRING_SET_GLYPH (gstring, i, g);
875 LGLYPH_SET_FROM (g, i);
876 LGLYPH_SET_TO (g, i);
877 LGLYPH_SET_CHAR (g, c);
878 if (FONT_OBJECT_P (font_object))
880 font_fill_lglyph_metrics (g, font_object);
882 else
884 int width = XFASTINT (CHAR_TABLE_REF (Vchar_width_table, c));
886 LGLYPH_SET_CODE (g, c);
887 LGLYPH_SET_LBEARING (g, 0);
888 LGLYPH_SET_RBEARING (g, width);
889 LGLYPH_SET_WIDTH (g, width);
890 LGLYPH_SET_ASCENT (g, 1);
891 LGLYPH_SET_DESCENT (g, 0);
893 LGLYPH_SET_ADJUSTMENT (g, Qnil);
895 if (i < LGSTRING_GLYPH_LEN (gstring))
896 LGSTRING_SET_GLYPH (gstring, i, Qnil);
900 /* Try to compose the characters at CHARPOS according to composition
901 rule RULE ([PATTERN PREV-CHARS FUNC]). LIMIT limits the characters
902 to compose. STRING, if not nil, is a target string. WIN is a
903 window where the characters are being displayed. If characters are
904 successfully composed, return the composition as a glyph-string
905 object. Otherwise return nil. */
907 static Lisp_Object
908 autocmp_chars (Lisp_Object rule, EMACS_INT charpos, EMACS_INT bytepos, EMACS_INT limit, struct window *win, struct face *face, Lisp_Object string)
910 int count = SPECPDL_INDEX ();
911 FRAME_PTR f = XFRAME (win->frame);
912 Lisp_Object pos = make_number (charpos);
913 EMACS_INT to;
914 EMACS_INT pt = PT, pt_byte = PT_BYTE;
915 Lisp_Object re, font_object, lgstring;
916 EMACS_INT len;
918 record_unwind_save_match_data ();
919 re = AREF (rule, 0);
920 if (NILP (re))
921 len = 1;
922 else if (! STRINGP (re))
923 return unbind_to (count, Qnil);
924 else if ((len = fast_looking_at (re, charpos, bytepos, limit, -1, string))
925 > 0)
927 if (NILP (string))
928 len = BYTE_TO_CHAR (bytepos + len) - charpos;
929 else
930 len = string_byte_to_char (string, bytepos + len) - charpos;
932 if (len <= 0)
933 return unbind_to (count, Qnil);
934 to = limit = charpos + len;
935 #ifdef HAVE_WINDOW_SYSTEM
936 if (FRAME_WINDOW_P (f))
938 font_object = font_range (charpos, &to, win, face, string);
939 if (! FONT_OBJECT_P (font_object)
940 || (! NILP (re)
941 && to < limit
942 && (fast_looking_at (re, charpos, bytepos, to, -1, string) <= 0)))
943 return unbind_to (count, Qnil);
945 else
946 #endif /* not HAVE_WINDOW_SYSTEM */
947 font_object = win->frame;
948 lgstring = Fcomposition_get_gstring (pos, make_number (to), font_object,
949 string);
950 if (NILP (LGSTRING_ID (lgstring)))
952 Lisp_Object args[6];
954 /* Save point as marker before calling out to lisp. */
955 if (NILP (string))
957 Lisp_Object m = Fmake_marker ();
958 set_marker_both (m, Qnil, pt, pt_byte);
959 record_unwind_protect (restore_point_unwind, m);
962 args[0] = Vauto_composition_function;
963 args[1] = AREF (rule, 2);
964 args[2] = pos;
965 args[3] = make_number (to);
966 args[4] = font_object;
967 args[5] = string;
968 lgstring = safe_call (6, args);
969 if (NILP (string))
970 TEMP_SET_PT_BOTH (pt, pt_byte);
972 return unbind_to (count, lgstring);
975 static Lisp_Object _work_val;
976 static int _work_char;
978 /* 1 iff the character C is composable. Characters of general
979 category Z? or C? are not composable except for ZWNJ and ZWJ. */
981 #define CHAR_COMPOSABLE_P(C) \
982 ((C) == 0x200C || (C) == 0x200D \
983 || (_work_val = CHAR_TABLE_REF (Vunicode_category_table, (C)), \
984 (SYMBOLP (_work_val) \
985 && (_work_char = SDATA (SYMBOL_NAME (_work_val))[0]) != 'C' \
986 && _work_char != 'Z')))
988 /* Update cmp_it->stop_pos to the next position after CHARPOS (and
989 BYTEPOS) where character composition may happen. If BYTEPOS is
990 negative, compute it. ENDPOS is a limit of searching. If it is
991 less than CHARPOS, search backward to ENDPOS+1 assuming that
992 set_iterator_to_next works in reverse order. In this case, if a
993 composition closest to CHARPOS is found, set cmp_it->stop_pos to
994 the last character of the composition.
996 If no composition is found, set cmp_it->ch to -2. If a static
997 composition is found, set cmp_it->ch to -1. Otherwise, set
998 cmp_it->ch to the character that triggers the automatic
999 composition. */
1001 void
1002 composition_compute_stop_pos (struct composition_it *cmp_it, EMACS_INT charpos, EMACS_INT bytepos, EMACS_INT endpos, Lisp_Object string)
1004 EMACS_INT start, end, c;
1005 Lisp_Object prop, val;
1006 /* This is from forward_to_next_line_start in xdisp.c. */
1007 const int MAX_NEWLINE_DISTANCE = 500;
1009 if (charpos < endpos)
1011 if (endpos > charpos + MAX_NEWLINE_DISTANCE)
1012 endpos = charpos + MAX_NEWLINE_DISTANCE;
1014 else if (endpos < charpos)
1016 /* We search backward for a position to check composition. */
1017 if (endpos < 0)
1019 /* But we don't know where to stop the searching. */
1020 endpos = NILP (string) ? BEGV - 1 : -1;
1021 /* Usually we don't reach ENDPOS because we stop searching
1022 at an uncomposable character (NL, LRE, etc). */
1025 cmp_it->id = -1;
1026 cmp_it->ch = -2;
1027 cmp_it->reversed_p = 0;
1028 cmp_it->stop_pos = endpos;
1029 if (charpos == endpos)
1030 return;
1031 /* FIXME: Bidi is not yet handled well in static composition. */
1032 if (charpos < endpos
1033 && find_composition (charpos, endpos, &start, &end, &prop, string)
1034 && COMPOSITION_VALID_P (start, end, prop))
1036 cmp_it->stop_pos = endpos = start;
1037 cmp_it->ch = -1;
1039 if (NILP (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 EMACS_INT 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, back, len;
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 - (back = XFASTINT (AREF (elt, 1))) > endpos)
1135 EMACS_INT cpos = charpos - back, bpos;
1137 if (back == 0)
1138 bpos = bytepos;
1139 else
1140 bpos = (NILP (string) ? CHAR_TO_BYTE (cpos)
1141 : string_char_to_byte (string, cpos));
1142 if (STRINGP (AREF (elt, 0)))
1143 len = fast_looking_at (AREF (elt, 0), cpos, bpos,
1144 start + 1, limit, string);
1145 else
1146 len = 1;
1147 if (len > 0)
1149 /* Make CPOS point to the last character of
1150 match. Note that LEN is byte-length. */
1151 if (len > 1)
1153 bpos += len;
1154 if (NILP (string))
1155 cpos = BYTE_TO_CHAR (bpos) - 1;
1156 else
1157 cpos = string_byte_to_char (string, bpos) - 1;
1159 back = cpos - (charpos - back);
1160 if (cmp_it->stop_pos < cpos
1161 || (cmp_it->stop_pos == cpos
1162 && cmp_it->lookback < back))
1164 cmp_it->rule_idx = ridx;
1165 cmp_it->stop_pos = cpos;
1166 cmp_it->ch = c;
1167 cmp_it->lookback = back;
1168 cmp_it->nchars = back + 1;
1174 if (charpos - 1 == endpos)
1175 break;
1176 if (STRINGP (string))
1178 p--, bytepos--;
1179 while (! CHAR_HEAD_P (*p))
1180 p--, bytepos--;
1181 charpos--;
1183 else
1185 DEC_BOTH (charpos, bytepos);
1186 p = BYTE_POS_ADDR (bytepos);
1188 c = STRING_CHAR (p);
1190 if (cmp_it->ch >= 0)
1191 /* We found a position to check. */
1192 return;
1193 /* Skip all uncomposable characters. */
1194 if (NILP (string))
1196 while (charpos - 1 > endpos && ! CHAR_COMPOSABLE_P (c))
1198 DEC_BOTH (charpos, bytepos);
1199 c = FETCH_MULTIBYTE_CHAR (bytepos);
1202 else
1204 while (charpos - 1 > endpos && ! CHAR_COMPOSABLE_P (c))
1206 p--;
1207 while (! CHAR_HEAD_P (*p))
1208 p--;
1209 charpos--;
1210 c = STRING_CHAR (p);
1214 cmp_it->stop_pos = charpos;
1217 /* Check if the character at CHARPOS (and BYTEPOS) is composed
1218 (possibly with the following characters) on window W. ENDPOS limits
1219 characters to be composed. FACE, in non-NULL, is a base face of
1220 the character. If STRING is not nil, it is a string containing the
1221 character to check, and CHARPOS and BYTEPOS are indices in the
1222 string. In that case, FACE must not be NULL.
1224 If the character is composed, setup members of CMP_IT (id, nglyphs,
1225 from, to, reversed_p), and return 1. Otherwise, update
1226 CMP_IT->stop_pos, and return 0. */
1229 composition_reseat_it (struct composition_it *cmp_it, EMACS_INT charpos, EMACS_INT bytepos, EMACS_INT endpos, struct window *w, struct face *face, Lisp_Object string)
1231 if (endpos < 0)
1232 endpos = NILP (string) ? BEGV : 0;
1234 if (cmp_it->ch == -2)
1236 composition_compute_stop_pos (cmp_it, charpos, bytepos, endpos, string);
1237 if (cmp_it->ch == -2 || cmp_it->stop_pos != charpos)
1238 /* The current position is not composed. */
1239 return 0;
1242 if (cmp_it->ch < 0)
1244 /* We are looking at a static composition. */
1245 EMACS_INT start, end;
1246 Lisp_Object prop;
1248 find_composition (charpos, -1, &start, &end, &prop, string);
1249 cmp_it->id = get_composition_id (charpos, bytepos, end - start,
1250 prop, string);
1251 if (cmp_it->id < 0)
1252 goto no_composition;
1253 cmp_it->nchars = end - start;
1254 cmp_it->nglyphs = composition_table[cmp_it->id]->glyph_len;
1256 else if (w)
1258 Lisp_Object lgstring = Qnil;
1259 Lisp_Object val, elt, re;
1260 int len, i;
1262 val = CHAR_TABLE_REF (Vcomposition_function_table, cmp_it->ch);
1263 for (i = 0; i < cmp_it->rule_idx; i++, val = XCDR (val));
1264 if (charpos < endpos)
1266 for (; CONSP (val); val = XCDR (val))
1268 elt = XCAR (val);
1269 if (! VECTORP (elt) || ASIZE (elt) != 3
1270 || ! INTEGERP (AREF (elt, 1)))
1271 continue;
1272 if (XFASTINT (AREF (elt, 1)) != cmp_it->lookback)
1273 goto no_composition;
1274 lgstring = autocmp_chars (elt, charpos, bytepos, endpos,
1275 w, face, string);
1276 if (composition_gstring_p (lgstring))
1277 break;
1278 lgstring = Qnil;
1279 /* Composition failed perhaps because the font doesn't
1280 support sufficient range of characters. Try the
1281 other composition rules if any. */
1283 cmp_it->reversed_p = 0;
1285 else
1287 EMACS_INT cpos = charpos, bpos = bytepos;
1289 while (1)
1291 elt = XCAR (val);
1292 if (cmp_it->lookback > 0)
1294 cpos = charpos - cmp_it->lookback;
1295 if (STRINGP (string))
1296 bpos = string_char_to_byte (string, cpos);
1297 else
1298 bpos = CHAR_TO_BYTE (cpos);
1300 lgstring = autocmp_chars (elt, cpos, bpos, charpos + 1, w, face,
1301 string);
1302 if (composition_gstring_p (lgstring)
1303 && cpos + LGSTRING_CHAR_LEN (lgstring) - 1 == charpos)
1304 break;
1305 /* Composition failed or didn't cover the current
1306 character. */
1307 if (cmp_it->lookback == 0)
1308 goto no_composition;
1309 lgstring = Qnil;
1310 /* Try to find a shorter compostion that starts after CPOS. */
1311 composition_compute_stop_pos (cmp_it, charpos, bytepos, cpos,
1312 string);
1313 if (cmp_it->ch == -2 || cmp_it->stop_pos < charpos)
1314 goto no_composition;
1315 val = CHAR_TABLE_REF (Vcomposition_function_table, cmp_it->ch);
1316 for (i = 0; i < cmp_it->rule_idx; i++, val = XCDR (val));
1318 cmp_it->reversed_p = 1;
1320 if (NILP (lgstring))
1321 goto no_composition;
1322 if (NILP (LGSTRING_ID (lgstring)))
1323 lgstring = composition_gstring_put_cache (lgstring, -1);
1324 cmp_it->id = XINT (LGSTRING_ID (lgstring));
1325 for (i = 0; i < LGSTRING_GLYPH_LEN (lgstring); i++)
1326 if (NILP (LGSTRING_GLYPH (lgstring, i)))
1327 break;
1328 cmp_it->nglyphs = i;
1329 cmp_it->from = 0;
1330 cmp_it->to = i;
1332 else
1333 goto no_composition;
1334 return 1;
1336 no_composition:
1337 if (charpos == endpos)
1338 return 0;
1339 if (charpos < endpos)
1341 charpos++;
1342 if (NILP (string))
1343 INC_POS (bytepos);
1344 else
1345 bytepos += BYTES_BY_CHAR_HEAD (*(SDATA (string) + bytepos));
1347 else
1349 charpos--;
1350 /* BYTEPOS is calculated in composition_compute_stop_pos */
1351 bytepos = -1;
1353 composition_compute_stop_pos (cmp_it, charpos, bytepos, endpos, string);
1354 return 0;
1357 /* Update charpos, nchars, nbytes, and width of the current grapheme
1358 cluster.
1360 If the composition is static or automatic in L2R context, the
1361 cluster is identified by CMP_IT->from, and CHARPOS is the position
1362 of the first character of the cluster. In this case, update
1363 CMP_IT->to too.
1365 If the composition is automatic in R2L context, the cluster is
1366 identified by CMP_IT->to, and CHARPOS is the position of the last
1367 character of the cluster. In this case, update CMP_IT->from too.
1369 The return value is the character code of the first character of
1370 the cluster, or -1 if the composition is somehow broken. */
1373 composition_update_it (struct composition_it *cmp_it, EMACS_INT charpos, EMACS_INT bytepos, Lisp_Object string)
1375 int i, c;
1377 if (cmp_it->ch < 0)
1379 /* static composition */
1380 struct composition *cmp = composition_table[cmp_it->id];
1382 cmp_it->charpos = charpos;
1383 cmp_it->to = cmp_it->nglyphs;
1384 if (cmp_it->nglyphs == 0)
1385 c = -1;
1386 else
1388 for (i = 0; i < cmp->glyph_len; i++)
1389 if ((c = COMPOSITION_GLYPH (cmp, i)) != '\t')
1390 break;
1391 if (c == '\t')
1392 c = ' ';
1394 cmp_it->width = cmp->width;
1395 charpos += cmp_it->nchars;
1396 if (STRINGP (string))
1397 cmp_it->nbytes = string_char_to_byte (string, charpos) - bytepos;
1398 else
1399 cmp_it->nbytes = CHAR_TO_BYTE (charpos) - bytepos;
1401 else
1403 /* automatic composition */
1404 Lisp_Object gstring = composition_gstring_from_id (cmp_it->id);
1405 Lisp_Object glyph;
1406 EMACS_INT from;
1408 if (cmp_it->nglyphs == 0)
1410 cmp_it->nchars = LGSTRING_CHAR_LEN (gstring);
1411 cmp_it->width = 0;
1412 cmp_it->from = cmp_it->to = 0;
1413 return -1;
1415 if (! cmp_it->reversed_p)
1417 glyph = LGSTRING_GLYPH (gstring, cmp_it->from);
1418 from = LGLYPH_FROM (glyph);
1419 for (cmp_it->to = cmp_it->from + 1; cmp_it->to < cmp_it->nglyphs;
1420 cmp_it->to++)
1422 glyph = LGSTRING_GLYPH (gstring, cmp_it->to);
1423 if (LGLYPH_FROM (glyph) != from)
1424 break;
1426 cmp_it->charpos = charpos;
1428 else
1430 glyph = LGSTRING_GLYPH (gstring, cmp_it->to - 1);
1431 from = LGLYPH_FROM (glyph);
1432 cmp_it->charpos = charpos - (LGLYPH_TO (glyph) - from);
1433 for (cmp_it->from = cmp_it->to - 1; cmp_it->from > 0;
1434 cmp_it->from--)
1436 glyph = LGSTRING_GLYPH (gstring, cmp_it->from - 1);
1437 if (LGLYPH_FROM (glyph) != from)
1438 break;
1441 glyph = LGSTRING_GLYPH (gstring, cmp_it->from);
1442 cmp_it->nchars = LGLYPH_TO (glyph) + 1 - from;
1443 cmp_it->nbytes = 0;
1444 cmp_it->width = 0;
1445 for (i = cmp_it->nchars - 1; i >= 0; i--)
1447 c = XINT (LGSTRING_CHAR (gstring, i));
1448 cmp_it->nbytes += CHAR_BYTES (c);
1449 cmp_it->width += CHAR_WIDTH (c);
1452 return c;
1456 struct position_record
1458 EMACS_INT pos, pos_byte;
1459 unsigned char *p;
1462 /* Update the members of POSITION to the next character boundary. */
1463 #define FORWARD_CHAR(POSITION, STOP) \
1464 do { \
1465 (POSITION).pos++; \
1466 if ((POSITION).pos == (STOP)) \
1468 (POSITION).p = GAP_END_ADDR; \
1469 (POSITION).pos_byte = GPT_BYTE; \
1471 else \
1473 (POSITION).pos_byte += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
1474 (POSITION).p += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
1476 } while (0)
1478 /* Update the members of POSITION to the previous character boundary. */
1479 #define BACKWARD_CHAR(POSITION, STOP) \
1480 do { \
1481 if ((POSITION).pos == STOP) \
1482 (POSITION).p = GPT_ADDR; \
1483 do { \
1484 (POSITION).pos_byte--; \
1485 (POSITION).p--; \
1486 } while (! CHAR_HEAD_P (*((POSITION).p))); \
1487 (POSITION).pos--; \
1488 } while (0)
1490 /* This is like find_composition, but find an automatic composition
1491 instead. If found, set *GSTRING to the glyph-string representing
1492 the composition, and return 1. Otherwise, return 0. */
1494 static int
1495 find_automatic_composition (EMACS_INT pos, EMACS_INT limit, EMACS_INT *start, EMACS_INT *end, Lisp_Object *gstring, Lisp_Object string)
1497 EMACS_INT head, tail, stop;
1498 /* Limit to check a composition after POS. */
1499 EMACS_INT fore_check_limit;
1500 struct position_record orig, cur, check, prev;
1501 Lisp_Object check_val, val, elt;
1502 int check_lookback;
1503 int c;
1504 Lisp_Object window;
1505 struct window *w;
1507 window = Fget_buffer_window (Fcurrent_buffer (), Qnil);
1508 if (NILP (window))
1509 return 0;
1510 w = XWINDOW (window);
1512 orig.pos = pos;
1513 if (NILP (string))
1515 head = BEGV, tail = ZV, stop = GPT;
1516 orig.pos_byte = CHAR_TO_BYTE (orig.pos);
1517 orig.p = BYTE_POS_ADDR (orig.pos_byte);
1519 else
1521 head = 0, tail = SCHARS (string), stop = -1;
1522 orig.pos_byte = string_char_to_byte (string, orig.pos);
1523 orig.p = SDATA (string) + orig.pos_byte;
1525 if (limit < pos)
1526 fore_check_limit = min (tail, pos + MAX_AUTO_COMPOSITION_LOOKBACK);
1527 else
1528 fore_check_limit = min (tail, limit + MAX_AUTO_COMPOSITION_LOOKBACK);
1529 cur = orig;
1531 retry:
1532 check_val = Qnil;
1533 /* At first, check if POS is composable. */
1534 c = STRING_CHAR (cur.p);
1535 if (! CHAR_COMPOSABLE_P (c))
1537 if (limit < 0)
1538 return 0;
1539 if (limit >= cur.pos)
1540 goto search_forward;
1542 else
1544 val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1545 if (! NILP (val))
1546 check_val = val, check = cur;
1547 else
1548 while (cur.pos + 1 < fore_check_limit)
1550 EMACS_INT b, e;
1552 FORWARD_CHAR (cur, stop);
1553 if (get_property_and_range (cur.pos, Qcomposition, &val, &b, &e,
1554 Qnil)
1555 && COMPOSITION_VALID_P (b, e, val))
1557 fore_check_limit = cur.pos;
1558 break;
1560 c = STRING_CHAR (cur.p);
1561 if (! CHAR_COMPOSABLE_P (c))
1562 break;
1563 val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1564 if (NILP (val))
1565 continue;
1566 check_val = val, check = cur;
1567 break;
1569 cur = orig;
1571 /* Rewind back to the position where we can safely search forward
1572 for compositions. */
1573 while (cur.pos > head)
1575 EMACS_INT b, e;
1577 BACKWARD_CHAR (cur, stop);
1578 if (get_property_and_range (cur.pos, Qcomposition, &val, &b, &e, Qnil)
1579 && COMPOSITION_VALID_P (b, e, val))
1580 break;
1581 c = STRING_CHAR (cur.p);
1582 if (! CHAR_COMPOSABLE_P (c))
1583 break;
1584 val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1585 if (! NILP (val))
1586 check_val = val, check = cur;
1588 prev = cur;
1589 /* Now search forward. */
1590 search_forward:
1591 *gstring = Qnil;
1592 if (! NILP (check_val) || limit >= orig.pos)
1594 if (NILP (check_val))
1595 cur = orig;
1596 else
1597 cur = check;
1598 while (cur.pos < fore_check_limit)
1600 int need_adjustment = 0;
1602 if (NILP (check_val))
1604 c = STRING_CHAR (cur.p);
1605 check_val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1607 for (; CONSP (check_val); check_val = XCDR (check_val))
1609 elt = XCAR (check_val);
1610 if (VECTORP (elt) && ASIZE (elt) == 3 && NATNUMP (AREF (elt, 1))
1611 && cur.pos - XFASTINT (AREF (elt, 1)) >= head)
1613 check.pos = cur.pos - XFASTINT (AREF (elt, 1));
1614 if (check.pos == cur.pos)
1615 check.pos_byte = cur.pos_byte;
1616 else
1617 check.pos_byte = CHAR_TO_BYTE (check.pos);
1618 val = autocmp_chars (elt, check.pos, check.pos_byte,
1619 tail, w, NULL, string);
1620 need_adjustment = 1;
1621 if (! NILP (val))
1623 *gstring = val;
1624 *start = check.pos;
1625 *end = check.pos + LGSTRING_CHAR_LEN (*gstring);
1626 if (*start <= orig.pos ? *end > orig.pos
1627 : limit >= orig.pos)
1628 return 1;
1629 cur.pos = *end;
1630 cur.pos_byte = CHAR_TO_BYTE (cur.pos);
1631 break;
1635 if (need_adjustment)
1637 /* As we have called Lisp, there's a possibility that
1638 buffer/string is relocated. */
1639 if (NILP (string))
1640 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1641 else
1642 cur.p = SDATA (string) + cur.pos_byte;
1644 if (! CONSP (check_val))
1645 FORWARD_CHAR (cur, stop);
1646 check_val = Qnil;
1649 if (! NILP (*gstring))
1650 return (limit >= 0 || (*start <= orig.pos && *end > orig.pos));
1651 if (limit >= 0 && limit < orig.pos && prev.pos > head)
1653 cur = prev;
1654 BACKWARD_CHAR (cur, stop);
1655 orig = cur;
1656 fore_check_limit = orig.pos;
1657 goto retry;
1659 return 0;
1662 /* Return the adjusted point provided that point is moved from LAST_PT
1663 to NEW_PT. */
1665 EMACS_INT
1666 composition_adjust_point (EMACS_INT last_pt, EMACS_INT new_pt)
1668 EMACS_INT charpos, bytepos, startpos, beg, end, pos;
1669 Lisp_Object val;
1670 int i;
1672 if (new_pt == BEGV || new_pt == ZV)
1673 return new_pt;
1675 /* At first check the static composition. */
1676 if (get_property_and_range (new_pt, Qcomposition, &val, &beg, &end, Qnil)
1677 && COMPOSITION_VALID_P (beg, end, val))
1679 if (beg < new_pt /* && end > new_pt <- It's always the case. */
1680 && (last_pt <= beg || last_pt >= end))
1681 return (new_pt < last_pt ? beg : end);
1682 return new_pt;
1685 if (NILP (current_buffer->enable_multibyte_characters)
1686 || NILP (Vauto_composition_mode))
1687 return new_pt;
1689 /* Next check the automatic composition. */
1690 if (! find_automatic_composition (new_pt, (EMACS_INT) -1, &beg, &end, &val,
1691 Qnil)
1692 || beg == new_pt)
1693 return new_pt;
1694 for (i = 0; i < LGSTRING_GLYPH_LEN (val); i++)
1696 Lisp_Object glyph = LGSTRING_GLYPH (val, i);
1698 if (NILP (glyph))
1699 break;
1700 if (beg + LGLYPH_FROM (glyph) == new_pt)
1701 return new_pt;
1702 if (beg + LGLYPH_TO (glyph) >= new_pt)
1703 return (new_pt < last_pt
1704 ? beg + LGLYPH_FROM (glyph)
1705 : beg + LGLYPH_TO (glyph) + 1);
1707 return new_pt;
1710 DEFUN ("composition-get-gstring", Fcomposition_get_gstring,
1711 Scomposition_get_gstring, 4, 4, 0,
1712 doc: /* Return a glyph-string for characters between FROM and TO.
1713 If the glyph string is for graphic display, FONT-OBJECT must be
1714 a font-object to use for those characters.
1715 Otherwise (for terminal display), FONT-OBJECT must be a terminal ID, a
1716 frame, or nil for the selected frame's terminal device.
1718 If the optional 4th argument STRING is not nil, it is a string
1719 containing the target characters between indices FROM and TO.
1721 A glyph-string is a vector containing information about how to display
1722 a specific character sequence. The format is:
1723 [HEADER ID GLYPH ...]
1725 HEADER is a vector of this form:
1726 [FONT-OBJECT CHAR ...]
1727 where
1728 FONT-OBJECT is a font-object for all glyphs in the glyph-string,
1729 or the terminal coding system of the specified terminal.
1730 CHARs are characters to be composed by GLYPHs.
1732 ID is an identification number of the glyph-string. It may be nil if
1733 not yet shaped.
1735 GLYPH is a vector whose elements have this form:
1736 [ FROM-IDX TO-IDX C CODE WIDTH LBEARING RBEARING ASCENT DESCENT
1737 [ [X-OFF Y-OFF WADJUST] | nil] ]
1738 where
1739 FROM-IDX and TO-IDX are used internally and should not be touched.
1740 C is the character of the glyph.
1741 CODE is the glyph-code of C in FONT-OBJECT.
1742 WIDTH thru DESCENT are the metrics (in pixels) of the glyph.
1743 X-OFF and Y-OFF are offsets to the base position for the glyph.
1744 WADJUST is the adjustment to the normal width of the glyph.
1746 If GLYPH is nil, the remaining elements of the glyph-string vector
1747 should be ignored. */)
1748 (Lisp_Object from, Lisp_Object to, Lisp_Object font_object, Lisp_Object string)
1750 Lisp_Object gstring, header;
1751 EMACS_INT frompos, topos;
1753 CHECK_NATNUM (from);
1754 CHECK_NATNUM (to);
1755 if (! FONT_OBJECT_P (font_object))
1757 struct coding_system *coding;
1758 struct terminal *terminal = get_terminal (font_object, 1);
1760 coding = ((TERMINAL_TERMINAL_CODING (terminal)->common_flags
1761 & CODING_REQUIRE_ENCODING_MASK)
1762 ? TERMINAL_TERMINAL_CODING (terminal) : &safe_terminal_coding);
1763 font_object = CODING_ID_NAME (coding->id);
1766 header = fill_gstring_header (Qnil, from, to, font_object, string);
1767 gstring = gstring_lookup_cache (header);
1768 if (! NILP (gstring))
1769 return gstring;
1771 frompos = XINT (from);
1772 topos = XINT (to);
1773 if (LGSTRING_GLYPH_LEN (gstring_work) < topos - frompos)
1774 gstring_work = Fmake_vector (make_number (topos - frompos + 2), Qnil);
1775 LGSTRING_SET_HEADER (gstring_work, header);
1776 LGSTRING_SET_ID (gstring_work, Qnil);
1777 fill_gstring_body (gstring_work);
1778 return gstring_work;
1782 /* Emacs Lisp APIs. */
1784 DEFUN ("compose-region-internal", Fcompose_region_internal,
1785 Scompose_region_internal, 2, 4, 0,
1786 doc: /* Internal use only.
1788 Compose text in the region between START and END.
1789 Optional 3rd and 4th arguments are COMPONENTS and MODIFICATION-FUNC
1790 for the composition. See `compose-region' for more details. */)
1791 (Lisp_Object start, Lisp_Object end, Lisp_Object components, Lisp_Object modification_func)
1793 validate_region (&start, &end);
1794 if (!NILP (components)
1795 && !INTEGERP (components)
1796 && !CONSP (components)
1797 && !STRINGP (components))
1798 CHECK_VECTOR (components);
1800 compose_text (XINT (start), XINT (end), components, modification_func, Qnil);
1801 return Qnil;
1804 DEFUN ("compose-string-internal", Fcompose_string_internal,
1805 Scompose_string_internal, 3, 5, 0,
1806 doc: /* Internal use only.
1808 Compose text between indices START and END of STRING.
1809 Optional 4th and 5th arguments are COMPONENTS and MODIFICATION-FUNC
1810 for the composition. See `compose-string' for more details. */)
1811 (Lisp_Object string, Lisp_Object start, Lisp_Object end, Lisp_Object components, Lisp_Object modification_func)
1813 CHECK_STRING (string);
1814 CHECK_NUMBER (start);
1815 CHECK_NUMBER (end);
1817 if (XINT (start) < 0 ||
1818 XINT (start) > XINT (end)
1819 || XINT (end) > SCHARS (string))
1820 args_out_of_range (start, end);
1822 compose_text (XINT (start), XINT (end), components, modification_func, string);
1823 return string;
1826 DEFUN ("find-composition-internal", Ffind_composition_internal,
1827 Sfind_composition_internal, 4, 4, 0,
1828 doc: /* Internal use only.
1830 Return information about composition at or nearest to position POS.
1831 See `find-composition' for more details. */)
1832 (Lisp_Object pos, Lisp_Object limit, Lisp_Object string, Lisp_Object detail_p)
1834 Lisp_Object prop, tail, gstring;
1835 EMACS_INT start, end, from, to;
1836 int id;
1838 CHECK_NUMBER_COERCE_MARKER (pos);
1839 from = XINT (pos);
1840 if (!NILP (limit))
1842 CHECK_NUMBER_COERCE_MARKER (limit);
1843 to = XINT (limit);
1845 else
1846 to = -1;
1848 if (!NILP (string))
1850 CHECK_STRING (string);
1851 if (XINT (pos) < 0 || XINT (pos) > SCHARS (string))
1852 args_out_of_range (string, pos);
1854 else
1856 if (XINT (pos) < BEGV || XINT (pos) > ZV)
1857 args_out_of_range (Fcurrent_buffer (), pos);
1860 if (!find_composition (from, to, &start, &end, &prop, string))
1862 if (!NILP (current_buffer->enable_multibyte_characters)
1863 && ! NILP (Vauto_composition_mode)
1864 && find_automatic_composition (from, to, &start, &end, &gstring,
1865 string))
1866 return list3 (make_number (start), make_number (end), gstring);
1867 return Qnil;
1869 if ((end <= XINT (pos) || start > XINT (pos)))
1871 EMACS_INT s, e;
1873 if (find_automatic_composition (from, to, &s, &e, &gstring, string)
1874 && (e <= XINT (pos) ? e > end : s < start))
1875 return list3 (make_number (s), make_number (e), gstring);
1877 if (!COMPOSITION_VALID_P (start, end, prop))
1878 return Fcons (make_number (start), Fcons (make_number (end),
1879 Fcons (Qnil, Qnil)));
1880 if (NILP (detail_p))
1881 return Fcons (make_number (start), Fcons (make_number (end),
1882 Fcons (Qt, Qnil)));
1884 if (COMPOSITION_REGISTERD_P (prop))
1885 id = COMPOSITION_ID (prop);
1886 else
1888 EMACS_INT start_byte = (NILP (string)
1889 ? CHAR_TO_BYTE (start)
1890 : string_char_to_byte (string, start));
1891 id = get_composition_id (start, start_byte, end - start, prop, string);
1894 if (id >= 0)
1896 Lisp_Object components, relative_p, mod_func;
1897 enum composition_method method = COMPOSITION_METHOD (prop);
1898 int width = composition_table[id]->width;
1900 components = Fcopy_sequence (COMPOSITION_COMPONENTS (prop));
1901 relative_p = (method == COMPOSITION_WITH_RULE_ALTCHARS
1902 ? Qnil : Qt);
1903 mod_func = COMPOSITION_MODIFICATION_FUNC (prop);
1904 tail = Fcons (components,
1905 Fcons (relative_p,
1906 Fcons (mod_func,
1907 Fcons (make_number (width), Qnil))));
1909 else
1910 tail = Qnil;
1912 return Fcons (make_number (start), Fcons (make_number (end), tail));
1916 void
1917 syms_of_composite (void)
1919 int i;
1921 Qcomposition = intern_c_string ("composition");
1922 staticpro (&Qcomposition);
1924 /* Make a hash table for static composition. */
1926 Lisp_Object args[6];
1928 args[0] = QCtest;
1929 args[1] = Qequal;
1930 args[2] = QCweakness;
1931 /* We used to make the hash table weak so that unreferenced
1932 compositions can be garbage-collected. But, usually once
1933 created compositions are repeatedly used in an Emacs session,
1934 and thus it's not worth to save memory in such a way. So, we
1935 make the table not weak. */
1936 args[3] = Qnil;
1937 args[4] = QCsize;
1938 args[5] = make_number (311);
1939 composition_hash_table = Fmake_hash_table (6, args);
1940 staticpro (&composition_hash_table);
1943 /* Make a hash table for glyph-string. */
1945 Lisp_Object args[6];
1946 args[0] = QCtest;
1947 args[1] = Qequal;
1948 args[2] = QCweakness;
1949 args[3] = Qnil;
1950 args[4] = QCsize;
1951 args[5] = make_number (311);
1952 gstring_hash_table = Fmake_hash_table (6, args);
1953 staticpro (&gstring_hash_table);
1956 staticpro (&gstring_work_headers);
1957 gstring_work_headers = Fmake_vector (make_number (8), Qnil);
1958 for (i = 0; i < 8; i++)
1959 ASET (gstring_work_headers, i, Fmake_vector (make_number (i + 2), Qnil));
1960 staticpro (&gstring_work);
1961 gstring_work = Fmake_vector (make_number (10), Qnil);
1963 /* Text property `composition' should be nonsticky by default. */
1964 Vtext_property_default_nonsticky
1965 = Fcons (Fcons (Qcomposition, Qt), Vtext_property_default_nonsticky);
1967 DEFVAR_LISP ("compose-chars-after-function", &Vcompose_chars_after_function,
1968 doc: /* Function to adjust composition of buffer text.
1970 This function is called with three arguments: FROM, TO, and OBJECT.
1971 FROM and TO specify the range of text whose composition should be
1972 adjusted. OBJECT, if non-nil, is a string that contains the text.
1974 This function is called after a text with `composition' property is
1975 inserted or deleted to keep `composition' property of buffer text
1976 valid.
1978 The default value is the function `compose-chars-after'. */);
1979 Vcompose_chars_after_function = intern_c_string ("compose-chars-after");
1981 Qauto_composed = intern_c_string ("auto-composed");
1982 staticpro (&Qauto_composed);
1984 Qauto_composition_function = intern_c_string ("auto-composition-function");
1985 staticpro (&Qauto_composition_function);
1987 DEFVAR_LISP ("auto-composition-mode", &Vauto_composition_mode,
1988 doc: /* Non-nil if Auto-Composition mode is enabled.
1989 Use the command `auto-composition-mode' to change this variable. */);
1990 Vauto_composition_mode = Qt;
1992 DEFVAR_LISP ("auto-composition-function", &Vauto_composition_function,
1993 doc: /* Function to call to compose characters automatically.
1994 This function is called from the display routine with four arguments:
1995 FROM, TO, WINDOW, and STRING.
1997 If STRING is nil, the function must compose characters in the region
1998 between FROM and TO in the current buffer.
2000 Otherwise, STRING is a string, and FROM and TO are indices into the
2001 string. In this case, the function must compose characters in the
2002 string. */);
2003 Vauto_composition_function = Qnil;
2005 DEFVAR_LISP ("composition-function-table", &Vcomposition_function_table,
2006 doc: /* Char-table of functions for automatic character composition.
2007 For each character that has to be composed automatically with
2008 preceding and/or following characters, this char-table contains
2009 a function to call to compose that character.
2011 The element at index C in the table, if non-nil, is a list of
2012 composition rules of this form: ([PATTERN PREV-CHARS FUNC] ...)
2014 PATTERN is a regular expression which C and the surrounding
2015 characters must match.
2017 PREV-CHARS is a non-negative integer (less than 4) specifying how many
2018 characters before C to check the matching with PATTERN. If it is 0,
2019 PATTERN must match C and the following characters. If it is 1,
2020 PATTERN must match a character before C and the following characters.
2022 If PREV-CHARS is 0, PATTERN can be nil, which means that the
2023 single character C should be composed.
2025 FUNC is a function to return a glyph-string representing a
2026 composition of the characters that match PATTERN. It is
2027 called with one argument GSTRING.
2029 GSTRING is a template of a glyph-string to return. It is already
2030 filled with a proper header for the characters to compose, and
2031 glyphs corresponding to those characters one by one. The
2032 function must return a new glyph-string with the same header as
2033 GSTRING, or modify GSTRING itself and return it.
2035 See also the documentation of `auto-composition-mode'. */);
2036 Vcomposition_function_table = Fmake_char_table (Qnil, Qnil);
2038 defsubr (&Scompose_region_internal);
2039 defsubr (&Scompose_string_internal);
2040 defsubr (&Sfind_composition_internal);
2041 defsubr (&Scomposition_get_gstring);