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/>. */
30 #include "character.h"
32 #include "intervals.h"
35 #include "dispextern.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
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
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
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. */
151 /* Hash table for compositions. The key is COMPONENTS-VEC of
152 `composition' property. The value is the corresponding
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
;
188 struct Lisp_Hash_Table
*hash_table
= XHASH_TABLE (composition_hash_table
);
191 struct composition
*cmp
;
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
;
206 /* PROP should be Form-B. */
207 if (XINT (id
) < 0 || XINT (id
) >= n_compositions
)
208 goto invalid_composition
;
212 /* PROP should be Form-A.
213 Thus, ID should be (LENGTH . COMPONENTS). */
215 goto invalid_composition
;
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
))
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
);
242 for (i
= 0; i
< nchars
; i
++)
244 FETCH_CHAR_ADVANCE (ch
, charpos
, bytepos
);
245 XVECTOR (key
)->contents
[i
] = make_number (ch
);
249 goto invalid_composition
;
251 hash_index
= hash_lookup (hash_table
, key
, &hash_code
);
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
);
261 XSETCDR (prop
, Fcons (make_number (nchars
), Fcons (key
, XCDR (prop
))));
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;
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;
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. */
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
);
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);
342 if (cmp
->method
!= COMPOSITION_WITH_RULE_ALTCHARS
)
344 /* Relative composition. */
346 for (i
= 0; i
< glyph_len
; i
++)
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
;
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
;
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
383 ---3---4---5--- baseline
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. */
404 composition_table
[n_compositions
] = cmp
;
406 return n_compositions
++;
409 /* Would it be better to remove this `composition' property? */
414 /* Find a static composition at or nearest to position POS of OBJECT
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
)
438 if (get_property_and_range (pos
, Qcomposition
, prop
, start
, end
, object
))
441 if (limit
< 0 || limit
== pos
)
444 if (limit
> pos
) /* search forward */
446 val
= Fnext_single_property_change (make_number (pos
), Qcomposition
,
447 object
, make_number (limit
));
452 else /* search backward */
454 if (get_property_and_range (pos
- 1, Qcomposition
, prop
, start
, end
,
457 val
= Fprevious_single_property_change (make_number (pos
), Qcomposition
,
458 object
, make_number (limit
));
464 get_property_and_range (pos
, Qcomposition
, prop
, start
, end
, object
);
468 /* Run a proper function to adjust the composition sitting between
469 FROM and TO with property PROP. */
472 run_composition_function (EMACS_INT from
, EMACS_INT to
, Lisp_Object prop
)
475 EMACS_INT start
, end
;
477 func
= COMPOSITION_MODIFICATION_FUNC (prop
);
478 /* If an invalid composition precedes or follows, try to make them
481 && find_composition (from
- 1, -1, &start
, &end
, &prop
, Qnil
)
482 && !COMPOSITION_VALID_P (start
, end
, prop
))
485 && find_composition (to
, -1, &start
, &end
, &prop
, Qnil
)
486 && !COMPOSITION_VALID_P (start
, end
, prop
))
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. */
504 update_compositions (EMACS_INT from
, EMACS_INT to
, int check_mask
)
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
)
515 /* If FROM and TO are not in a valid range, do nothing. */
516 if (! (BEGV
<= from
&& from
<= to
&& to
<= ZV
))
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. */
527 && find_composition (from
- 1, -1, &start
, &end
, &prop
, Qnil
)
528 && COMPOSITION_VALID_P (start
, end
, prop
))
534 Fput_text_property (make_number (from
), make_number (end
),
536 Fcons (XCAR (prop
), XCDR (prop
)), Qnil
);
537 run_composition_function (start
, end
, prop
);
541 && find_composition (from
, -1, &start
, &from
, &prop
, Qnil
)
542 && COMPOSITION_VALID_P (start
, from
, prop
))
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
556 && find_composition (from
, to
, &start
, &from
, &prop
, Qnil
)
557 && COMPOSITION_VALID_P (start
, from
, prop
)
559 run_composition_function (start
, from
, prop
);
562 if (check_mask
& CHECK_TAIL
)
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. */
575 Fput_text_property (make_number (start
), make_number (to
),
577 Fcons (XCAR (prop
), XCDR (prop
)), Qnil
);
580 run_composition_function (start
, end
, prop
);
583 && find_composition (to
, -1, &start
, &end
, &prop
, Qnil
)
584 && COMPOSITION_VALID_P (start
, end
, prop
))
586 run_composition_function (start
, end
, prop
);
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'. */
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. */
635 compose_text (EMACS_INT start
, EMACS_INT end
, Lisp_Object components
,
636 Lisp_Object modification_func
, Lisp_Object string
)
640 prop
= Fcons (Fcons (make_number (end
- start
), components
),
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
658 static Lisp_Object gstring_hash_table
;
660 static Lisp_Object
gstring_lookup_cache (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
);
672 composition_gstring_put_cache (Lisp_Object gstring
, int len
)
674 struct Lisp_Hash_Table
*h
= XHASH_TABLE (gstring_hash_table
);
676 Lisp_Object header
, copy
;
679 header
= LGSTRING_HEADER (gstring
);
680 hash
= h
->hashfn (h
, header
);
683 len
= LGSTRING_GLYPH_LEN (gstring
);
684 for (i
= 0; i
< len
; i
++)
685 if (NILP (LGSTRING_GLYPH (gstring
, 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
));
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
,
712 composition_gstring_p (Lisp_Object gstring
)
717 if (! VECTORP (gstring
) || ASIZE (gstring
) < 2)
719 header
= LGSTRING_HEADER (gstring
);
720 if (! VECTORP (header
) || ASIZE (header
) < 2)
722 if (! NILP (LGSTRING_FONT (gstring
))
723 && (! FONT_OBJECT_P (LGSTRING_FONT (gstring
))
724 && ! CODING_SYSTEM_P (LGSTRING_FONT (gstring
))))
726 for (i
= 1; i
< ASIZE (LGSTRING_HEADER (gstring
)); i
++)
727 if (! NATNUMP (AREF (LGSTRING_HEADER (gstring
), i
)))
729 if (! NILP (LGSTRING_ID (gstring
)) && ! NATNUMP (LGSTRING_ID (gstring
)))
731 for (i
= 0; i
< LGSTRING_GLYPH_LEN (gstring
); i
++)
733 Lisp_Object glyph
= LGSTRING_GLYPH (gstring
, i
);
736 if (! VECTORP (glyph
) || ASIZE (glyph
) != LGLYPH_SIZE
)
743 composition_gstring_width (Lisp_Object gstring
, EMACS_INT from
, EMACS_INT to
,
744 struct font_metrics
*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
;
763 metrics
->descent
= 0;
765 metrics
->width
= metrics
->lbearing
= metrics
->rbearing
= 0;
767 for (glyph
= &LGSTRING_GLYPH (gstring
, from
); from
< to
; from
++, glyph
++)
771 if (NILP (LGLYPH_ADJUSTMENT (*glyph
)))
772 width
+= LGLYPH_WIDTH (*glyph
);
774 width
+= LGLYPH_WADJUST (*glyph
);
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
)
787 x
= LGLYPH_DESCENT (*glyph
) + LGLYPH_YOFF (*glyph
);
788 if (metrics
->descent
< x
)
789 metrics
->descent
= x
;
796 static Lisp_Object gstring_work
;
797 static Lisp_Object gstring_work_headers
;
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
;
807 if (NILP (current_buffer
->enable_multibyte_characters
))
808 error ("Attempt to shape unibyte text");
809 validate_region (&start
, &end
);
810 from
= XFASTINT (start
);
812 from_byte
= CHAR_TO_BYTE (from
);
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. */
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
);
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));
838 header
= AREF (gstring_work_headers
, len
- 1);
840 header
= Fmake_vector (make_number (len
+ 1), Qnil
);
843 ASET (header
, 0, font_object
);
844 for (i
= 0; i
< len
; i
++)
849 FETCH_CHAR_ADVANCE_NO_CHECK (c
, from
, from_byte
);
851 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c
, string
, from
, from_byte
);
852 ASET (header
, i
+ 1, make_number (c
));
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
);
865 for (i
= 0; i
< len
; i
++)
867 Lisp_Object g
= LGSTRING_GLYPH (gstring
, i
);
868 EMACS_INT c
= XINT (AREF (header
, i
+ 1));
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
);
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. */
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
);
914 EMACS_INT pt
= PT
, pt_byte
= PT_BYTE
;
915 Lisp_Object re
, font_object
, lgstring
;
918 record_unwind_save_match_data ();
922 else if (! STRINGP (re
))
923 return unbind_to (count
, Qnil
);
924 else if ((len
= fast_looking_at (re
, charpos
, bytepos
, limit
, -1, string
))
928 len
= BYTE_TO_CHAR (bytepos
+ len
) - charpos
;
930 len
= string_byte_to_char (string
, bytepos
+ len
) - charpos
;
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
)
942 && (fast_looking_at (re
, charpos
, bytepos
, to
, -1, string
) <= 0)))
943 return unbind_to (count
, Qnil
);
946 #endif /* not HAVE_WINDOW_SYSTEM */
947 font_object
= win
->frame
;
948 lgstring
= Fcomposition_get_gstring (pos
, make_number (to
), font_object
,
950 if (NILP (LGSTRING_ID (lgstring
)))
954 /* Save point as marker before calling out to lisp. */
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);
965 args
[3] = make_number (to
);
966 args
[4] = font_object
;
968 lgstring
= safe_call (6, args
);
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
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. */
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). */
1027 cmp_it
->reversed_p
= 0;
1028 cmp_it
->stop_pos
= endpos
;
1029 if (charpos
== endpos
)
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
;
1039 if (NILP (current_buffer
->enable_multibyte_characters
)
1040 || NILP (Vauto_composition_mode
))
1045 bytepos
= CHAR_TO_BYTE (charpos
);
1047 bytepos
= string_char_to_byte (string
, 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
);
1059 FETCH_CHAR_ADVANCE (c
, charpos
, bytepos
);
1065 val
= CHAR_TABLE_REF (Vcomposition_function_table
, c
);
1071 for (ridx
= 0; CONSP (val
); val
= XCDR (val
), ridx
++)
1074 if (VECTORP (elt
) && ASIZE (elt
) == 3
1075 && NATNUMP (AREF (elt
, 1))
1076 && charpos
- 1 - XFASTINT (AREF (elt
, 1)) >= start
)
1081 cmp_it
->rule_idx
= ridx
;
1082 cmp_it
->lookback
= XFASTINT (AREF (elt
, 1));
1083 cmp_it
->stop_pos
= charpos
- 1 - cmp_it
->lookback
;
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
1095 charpos
= endpos
- MAX_AUTO_COMPOSITION_LOOKBACK
;
1096 if (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
1110 /* Limit byte position used in fast_looking_at. This is the
1111 byte position of the character after START. */
1115 p
= BYTE_POS_ADDR (bytepos
);
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
);
1126 int ridx
, back
, len
;
1128 for (ridx
= 0; CONSP (val
); val
= XCDR (val
), ridx
++)
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
;
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
);
1149 /* Make CPOS point to the last character of
1150 match. Note that LEN is byte-length. */
1155 cpos
= BYTE_TO_CHAR (bpos
) - 1;
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
;
1167 cmp_it
->lookback
= back
;
1168 cmp_it
->nchars
= back
+ 1;
1174 if (charpos
- 1 == endpos
)
1176 if (STRINGP (string
))
1179 while (! CHAR_HEAD_P (*p
))
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. */
1193 /* Skip all uncomposable characters. */
1196 while (charpos
- 1 > endpos
&& ! CHAR_COMPOSABLE_P (c
))
1198 DEC_BOTH (charpos
, bytepos
);
1199 c
= FETCH_MULTIBYTE_CHAR (bytepos
);
1204 while (charpos
- 1 > endpos
&& ! CHAR_COMPOSABLE_P (c
))
1207 while (! CHAR_HEAD_P (*p
))
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
)
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. */
1244 /* We are looking at a static composition. */
1245 EMACS_INT start
, end
;
1248 find_composition (charpos
, -1, &start
, &end
, &prop
, string
);
1249 cmp_it
->id
= get_composition_id (charpos
, bytepos
, end
- start
,
1252 goto no_composition
;
1253 cmp_it
->nchars
= end
- start
;
1254 cmp_it
->nglyphs
= composition_table
[cmp_it
->id
]->glyph_len
;
1258 Lisp_Object lgstring
= Qnil
;
1259 Lisp_Object val
, elt
, re
;
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
))
1269 if (! VECTORP (elt
) || ASIZE (elt
) != 3
1270 || ! INTEGERP (AREF (elt
, 1)))
1272 if (XFASTINT (AREF (elt
, 1)) != cmp_it
->lookback
)
1273 goto no_composition
;
1274 lgstring
= autocmp_chars (elt
, charpos
, bytepos
, endpos
,
1276 if (composition_gstring_p (lgstring
))
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;
1287 EMACS_INT cpos
= charpos
, bpos
= bytepos
;
1292 if (cmp_it
->lookback
> 0)
1294 cpos
= charpos
- cmp_it
->lookback
;
1295 if (STRINGP (string
))
1296 bpos
= string_char_to_byte (string
, cpos
);
1298 bpos
= CHAR_TO_BYTE (cpos
);
1300 lgstring
= autocmp_chars (elt
, cpos
, bpos
, charpos
+ 1, w
, face
,
1302 if (composition_gstring_p (lgstring
)
1303 && cpos
+ LGSTRING_CHAR_LEN (lgstring
) - 1 == charpos
)
1305 /* Composition failed or didn't cover the current
1307 if (cmp_it
->lookback
== 0)
1308 goto no_composition
;
1310 /* Try to find a shorter compostion that starts after CPOS. */
1311 composition_compute_stop_pos (cmp_it
, charpos
, bytepos
, cpos
,
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
)))
1328 cmp_it
->nglyphs
= i
;
1333 goto no_composition
;
1337 if (charpos
== endpos
)
1339 if (charpos
< endpos
)
1345 bytepos
+= BYTES_BY_CHAR_HEAD (*(SDATA (string
) + bytepos
));
1350 /* BYTEPOS is calculated in composition_compute_stop_pos */
1353 composition_compute_stop_pos (cmp_it
, charpos
, bytepos
, endpos
, string
);
1357 /* Update charpos, nchars, nbytes, and width of the current grapheme
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
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
)
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)
1388 for (i
= 0; i
< cmp
->glyph_len
; i
++)
1389 if ((c
= COMPOSITION_GLYPH (cmp
, i
)) != '\t')
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
;
1399 cmp_it
->nbytes
= CHAR_TO_BYTE (charpos
) - bytepos
;
1403 /* automatic composition */
1404 Lisp_Object gstring
= composition_gstring_from_id (cmp_it
->id
);
1408 if (cmp_it
->nglyphs
== 0)
1410 cmp_it
->nchars
= LGSTRING_CHAR_LEN (gstring
);
1412 cmp_it
->from
= cmp_it
->to
= 0;
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
;
1422 glyph
= LGSTRING_GLYPH (gstring
, cmp_it
->to
);
1423 if (LGLYPH_FROM (glyph
) != from
)
1426 cmp_it
->charpos
= charpos
;
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;
1436 glyph
= LGSTRING_GLYPH (gstring
, cmp_it
->from
- 1);
1437 if (LGLYPH_FROM (glyph
) != from
)
1441 glyph
= LGSTRING_GLYPH (gstring
, cmp_it
->from
);
1442 cmp_it
->nchars
= LGLYPH_TO (glyph
) + 1 - from
;
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
);
1456 struct position_record
1458 EMACS_INT pos
, pos_byte
;
1462 /* Update the members of POSITION to the next character boundary. */
1463 #define FORWARD_CHAR(POSITION, STOP) \
1466 if ((POSITION).pos == (STOP)) \
1468 (POSITION).p = GAP_END_ADDR; \
1469 (POSITION).pos_byte = GPT_BYTE; \
1473 (POSITION).pos_byte += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
1474 (POSITION).p += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
1478 /* Update the members of POSITION to the previous character boundary. */
1479 #define BACKWARD_CHAR(POSITION, STOP) \
1481 if ((POSITION).pos == STOP) \
1482 (POSITION).p = GPT_ADDR; \
1484 (POSITION).pos_byte--; \
1486 } while (! CHAR_HEAD_P (*((POSITION).p))); \
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. */
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
;
1507 window
= Fget_buffer_window (Fcurrent_buffer (), Qnil
);
1510 w
= XWINDOW (window
);
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
);
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
;
1526 fore_check_limit
= min (tail
, pos
+ MAX_AUTO_COMPOSITION_LOOKBACK
);
1528 fore_check_limit
= min (tail
, limit
+ MAX_AUTO_COMPOSITION_LOOKBACK
);
1533 /* At first, check if POS is composable. */
1534 c
= STRING_CHAR (cur
.p
);
1535 if (! CHAR_COMPOSABLE_P (c
))
1539 if (limit
>= cur
.pos
)
1540 goto search_forward
;
1544 val
= CHAR_TABLE_REF (Vcomposition_function_table
, c
);
1546 check_val
= val
, check
= cur
;
1548 while (cur
.pos
+ 1 < fore_check_limit
)
1552 FORWARD_CHAR (cur
, stop
);
1553 if (get_property_and_range (cur
.pos
, Qcomposition
, &val
, &b
, &e
,
1555 && COMPOSITION_VALID_P (b
, e
, val
))
1557 fore_check_limit
= cur
.pos
;
1560 c
= STRING_CHAR (cur
.p
);
1561 if (! CHAR_COMPOSABLE_P (c
))
1563 val
= CHAR_TABLE_REF (Vcomposition_function_table
, c
);
1566 check_val
= val
, check
= cur
;
1571 /* Rewind back to the position where we can safely search forward
1572 for compositions. */
1573 while (cur
.pos
> head
)
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
))
1581 c
= STRING_CHAR (cur
.p
);
1582 if (! CHAR_COMPOSABLE_P (c
))
1584 val
= CHAR_TABLE_REF (Vcomposition_function_table
, c
);
1586 check_val
= val
, check
= cur
;
1589 /* Now search forward. */
1592 if (! NILP (check_val
) || limit
>= orig
.pos
)
1594 if (NILP (check_val
))
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
;
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;
1625 *end
= check
.pos
+ LGSTRING_CHAR_LEN (*gstring
);
1626 if (*start
<= orig
.pos
? *end
> orig
.pos
1627 : limit
>= orig
.pos
)
1630 cur
.pos_byte
= CHAR_TO_BYTE (cur
.pos
);
1635 if (need_adjustment
)
1637 /* As we have called Lisp, there's a possibility that
1638 buffer/string is relocated. */
1640 cur
.p
= BYTE_POS_ADDR (cur
.pos_byte
);
1642 cur
.p
= SDATA (string
) + cur
.pos_byte
;
1644 if (! CONSP (check_val
))
1645 FORWARD_CHAR (cur
, stop
);
1649 if (! NILP (*gstring
))
1650 return (limit
>= 0 || (*start
<= orig
.pos
&& *end
> orig
.pos
));
1651 if (limit
>= 0 && limit
< orig
.pos
&& prev
.pos
> head
)
1654 BACKWARD_CHAR (cur
, stop
);
1656 fore_check_limit
= orig
.pos
;
1662 /* Return the adjusted point provided that point is moved from LAST_PT
1666 composition_adjust_point (EMACS_INT last_pt
, EMACS_INT new_pt
)
1668 EMACS_INT charpos
, bytepos
, startpos
, beg
, end
, pos
;
1672 if (new_pt
== BEGV
|| new_pt
== ZV
)
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
);
1685 if (NILP (current_buffer
->enable_multibyte_characters
)
1686 || NILP (Vauto_composition_mode
))
1689 /* Next check the automatic composition. */
1690 if (! find_automatic_composition (new_pt
, (EMACS_INT
) -1, &beg
, &end
, &val
,
1694 for (i
= 0; i
< LGSTRING_GLYPH_LEN (val
); i
++)
1696 Lisp_Object glyph
= LGSTRING_GLYPH (val
, i
);
1700 if (beg
+ LGLYPH_FROM (glyph
) == 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);
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 ...]
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
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] ]
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
);
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
))
1771 frompos
= XINT (from
);
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
);
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
);
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
);
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
;
1838 CHECK_NUMBER_COERCE_MARKER (pos
);
1842 CHECK_NUMBER_COERCE_MARKER (limit
);
1850 CHECK_STRING (string
);
1851 if (XINT (pos
) < 0 || XINT (pos
) > SCHARS (string
))
1852 args_out_of_range (string
, pos
);
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
,
1866 return list3 (make_number (start
), make_number (end
), gstring
);
1869 if ((end
<= XINT (pos
) || start
> XINT (pos
)))
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
),
1884 if (COMPOSITION_REGISTERD_P (prop
))
1885 id
= COMPOSITION_ID (prop
);
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
);
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
1903 mod_func
= COMPOSITION_MODIFICATION_FUNC (prop
);
1904 tail
= Fcons (components
,
1907 Fcons (make_number (width
), Qnil
))));
1912 return Fcons (make_number (start
), Fcons (make_number (end
), tail
));
1917 syms_of_composite (void)
1921 Qcomposition
= intern_c_string ("composition");
1922 staticpro (&Qcomposition
);
1924 /* Make a hash table for static composition. */
1926 Lisp_Object args
[6];
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. */
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];
1948 args
[2] = QCweakness
;
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
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
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
);