* buffer.c (struct sortstr.size, record_overlay_string): Don't truncate size to int.
[bpt/emacs.git] / src / composite.c
CommitLineData
ca4c9455 1/* Composite sequence support.
73b0cd50 2 Copyright (C) 2001-2011 Free Software Foundation, Inc.
5df4f04c 3 Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
ce03bf76
KH
4 National Institute of Advanced Industrial Science and Technology (AIST)
5 Registration Number H14PRO021
f30d8d94 6 Copyright (C) 2003, 2006
1527c36e
KH
7 National Institute of Advanced Industrial Science and Technology (AIST)
8 Registration Number H13PRO009
ca4c9455
KH
9
10This file is part of GNU Emacs.
11
9ec0b715 12GNU Emacs is free software: you can redistribute it and/or modify
ca4c9455 13it under the terms of the GNU General Public License as published by
9ec0b715
GM
14the Free Software Foundation, either version 3 of the License, or
15(at your option) any later version.
ca4c9455
KH
16
17GNU Emacs is distributed in the hope that it will be useful,
18but WITHOUT ANY WARRANTY; without even the implied warranty of
19MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20GNU General Public License for more details.
21
22You should have received a copy of the GNU General Public License
9ec0b715 23along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
ca4c9455
KH
24
25#include <config.h>
d7306fe6 26#include <setjmp.h>
ca4c9455
KH
27#include "lisp.h"
28#include "buffer.h"
1527c36e 29#include "character.h"
f5199465 30#include "coding.h"
ca4c9455 31#include "intervals.h"
58753d74
KH
32#include "window.h"
33#include "frame.h"
34#include "dispextern.h"
35#include "font.h"
f5199465
KH
36#include "termhooks.h"
37
ca4c9455
KH
38
39/* Emacs uses special text property `composition' to support character
40 composition. A sequence of characters that have the same (i.e. eq)
41 `composition' property value is treated as a single composite
42 sequence (we call it just `composition' here after). Characters in
43 a composition are all composed somehow on the screen.
44
45 The property value has this form when the composition is made:
46 ((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
47 then turns to this form:
48 (COMPOSITION-ID . (LENGTH COMPONENTS-VEC . MODIFICATION-FUNC))
49 when the composition is registered in composition_hash_table and
50 composition_table. These rather peculiar structures were designed
51 to make it easy to distinguish them quickly (we can do that by
52 checking only the first element) and to extract LENGTH (from the
53 former form) and COMPOSITION-ID (from the latter form).
54
55 We register a composition when it is displayed, or when the width
56 is required (for instance, to calculate columns).
57
58 LENGTH -- Length of the composition. This information is used to
59 check the validity of the composition.
60
61 COMPONENTS -- Character, string, vector, list, or nil.
62
63 If it is nil, characters in the text are composed relatively
64 according to their metrics in font glyphs.
65
66 If it is a character or a string, the character or characters
67 in the string are composed relatively.
68
69 If it is a vector or list of integers, the element is a
70 character or an encoded composition rule. The characters are
71 composed according to the rules. (2N)th elements are
72 characters to be composed and (2N+1)th elements are
73 composition rules to tell how to compose (2N+2)th element with
74 the previously composed 2N glyphs.
75
763d7377
EZ
76 COMPONENTS-VEC -- Vector of integers. In a relative composition,
77 the elements are the characters to be composed. In a rule-base
ca4c9455
KH
78 composition, the elements are characters or encoded
79 composition rules.
80
81 MODIFICATION-FUNC -- If non nil, it is a function to call when the
82 composition gets invalid after a modification in a buffer. If
83 it is nil, a function in `composition-function-table' of the
84 first character in the sequence is called.
85
86 COMPOSITION-ID --Identification number of the composition. It is
87 used as an index to composition_table for the composition.
88
89 When Emacs has to display a composition or has to know its
90 displaying width, the function get_composition_id is called. It
91 returns COMPOSITION-ID so that the caller can access the
92 information about the composition through composition_table. If a
93 COMPOSITION-ID has not yet been assigned to the composition,
94 get_composition_id checks the validity of `composition' property,
95 and, if valid, assigns a new ID, registers the information in
96 composition_hash_table and composition_table, and changes the form
763d7377
EZ
97 of the property value. If the property is invalid,
98 get_composition_id returns -1 without changing the property value.
ca4c9455 99
763d7377 100 We use two tables to keep the information about composition;
ca4c9455
KH
101 composition_hash_table and composition_table.
102
763d7377 103 The former is a hash table whose keys are COMPONENTS-VECs and
ca4c9455 104 values are the corresponding COMPOSITION-IDs. This hash table is
4abc7470 105 weak, but as each key (COMPONENTS-VEC) is also kept as a value of the
ca4c9455 106 `composition' property, it won't be collected as garbage until all
4abc7470 107 bits of text that have the same COMPONENTS-VEC are deleted.
ca4c9455
KH
108
109 The latter is a table of pointers to `struct composition' indexed
4abc7470 110 by COMPOSITION-ID. This structure keeps the other information (see
ca4c9455
KH
111 composite.h).
112
113 In general, a text property holds information about individual
114 characters. But, a `composition' property holds information about
4abc7470 115 a sequence of characters (in this sense, it is like the `intangible'
ca4c9455 116 property). That means that we should not share the property value
4abc7470 117 in adjacent compositions -- we can't distinguish them if they have the
ca4c9455
KH
118 same property. So, after any changes, we call
119 `update_compositions' and change a property of one of adjacent
120 compositions to a copy of it. This function also runs a proper
121 composition modification function to make a composition that gets
122 invalid by the change valid again.
123
4abc7470 124 As the value of the `composition' property holds information about a
ca4c9455 125 specific range of text, the value gets invalid if we change the
4abc7470 126 text in the range. We treat the `composition' property as always
ca4c9455
KH
127 rear-nonsticky (currently by setting default-text-properties to
128 (rear-nonsticky (composition))) and we never make properties of
129 adjacent compositions identical. Thus, any such changes make the
4abc7470 130 range just shorter. So, we can check the validity of the `composition'
ca4c9455
KH
131 property by comparing LENGTH information with the actual length of
132 the composition.
133
134*/
135
136
137Lisp_Object Qcomposition;
138
139/* Table of pointers to the structure `composition' indexed by
140 COMPOSITION-ID. This structure is for storing information about
141 each composition except for COMPONENTS-VEC. */
142struct composition **composition_table;
143
144/* The current size of `composition_table'. */
145static int composition_table_size;
146
147/* Number of compositions currently made. */
148int n_compositions;
149
150/* Hash table for compositions. The key is COMPONENTS-VEC of
151 `composition' property. The value is the corresponding
152 COMPOSITION-ID. */
153Lisp_Object composition_hash_table;
154
955cbe7b
PE
155static Lisp_Object Qauto_composed;
156static Lisp_Object Qauto_composition_function;
763d7377
EZ
157/* Maximum number of characters to look back for
158 auto-compositions. */
895416e3
KH
159#define MAX_AUTO_COMPOSITION_LOOKBACK 3
160
cd64ea1d
PE
161static Lisp_Object Fcomposition_get_gstring (Lisp_Object, Lisp_Object,
162 Lisp_Object, Lisp_Object);
ea058d2c 163
ca4c9455
KH
164/* Temporary variable used in macros COMPOSITION_XXX. */
165Lisp_Object composition_temp;
f30d8d94 166
ca4c9455 167\f
ca4c9455
KH
168/* Return COMPOSITION-ID of a composition at buffer position
169 CHARPOS/BYTEPOS and length NCHARS. The `composition' property of
170 the sequence is PROP. STRING, if non-nil, is a string that
171 contains the composition instead of the current buffer.
172
173 If the composition is invalid, return -1. */
174
175int
579c18d0
EZ
176get_composition_id (EMACS_INT charpos, EMACS_INT bytepos, EMACS_INT nchars,
177 Lisp_Object prop, Lisp_Object string)
ca4c9455
KH
178{
179 Lisp_Object id, length, components, key, *key_contents;
180 int glyph_len;
181 struct Lisp_Hash_Table *hash_table = XHASH_TABLE (composition_hash_table);
0de4bb68
PE
182 EMACS_INT hash_index;
183 EMACS_UINT hash_code;
ca4c9455 184 struct composition *cmp;
579c18d0
EZ
185 EMACS_INT i;
186 int ch;
ca4c9455
KH
187
188 /* PROP should be
189 Form-A: ((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
190 or
191 Form-B: (COMPOSITION-ID . (LENGTH COMPONENTS-VEC . MODIFICATION-FUNC))
192 */
193 if (nchars == 0 || !CONSP (prop))
194 goto invalid_composition;
195
196 id = XCAR (prop);
197 if (INTEGERP (id))
198 {
199 /* PROP should be Form-B. */
200 if (XINT (id) < 0 || XINT (id) >= n_compositions)
201 goto invalid_composition;
202 return XINT (id);
203 }
204
205 /* PROP should be Form-A.
206 Thus, ID should be (LENGTH . COMPONENTS). */
207 if (!CONSP (id))
208 goto invalid_composition;
209 length = XCAR (id);
210 if (!INTEGERP (length) || XINT (length) != nchars)
211 goto invalid_composition;
212
213 components = XCDR (id);
214
215 /* Check if the same composition has already been registered or not
216 by consulting composition_hash_table. The key for this table is
217 COMPONENTS (converted to a vector COMPONENTS-VEC) or, if it is
218 nil, vector of characters in the composition range. */
219 if (INTEGERP (components))
220 key = Fmake_vector (make_number (1), components);
221 else if (STRINGP (components) || CONSP (components))
222 key = Fvconcat (1, &components);
223 else if (VECTORP (components))
224 key = components;
225 else if (NILP (components))
226 {
227 key = Fmake_vector (make_number (nchars), Qnil);
228 if (STRINGP (string))
229 for (i = 0; i < nchars; i++)
230 {
231 FETCH_STRING_CHAR_ADVANCE (ch, string, charpos, bytepos);
232 XVECTOR (key)->contents[i] = make_number (ch);
233 }
234 else
235 for (i = 0; i < nchars; i++)
236 {
237 FETCH_CHAR_ADVANCE (ch, charpos, bytepos);
238 XVECTOR (key)->contents[i] = make_number (ch);
239 }
240 }
241 else
242 goto invalid_composition;
243
244 hash_index = hash_lookup (hash_table, key, &hash_code);
245 if (hash_index >= 0)
246 {
247 /* We have already registered the same composition. Change PROP
248 from Form-A above to Form-B while replacing COMPONENTS with
249 COMPONENTS-VEC stored in the hash table. We can directly
250 modify the cons cell of PROP because it is not shared. */
251 key = HASH_KEY (hash_table, hash_index);
252 id = HASH_VALUE (hash_table, hash_index);
f3fbd155
KR
253 XSETCAR (prop, id);
254 XSETCDR (prop, Fcons (make_number (nchars), Fcons (key, XCDR (prop))));
ca4c9455
KH
255 return XINT (id);
256 }
257
258 /* This composition is a new one. We must register it. */
177c0ea7 259
ca4c9455
KH
260 /* Check if we have sufficient memory to store this information. */
261 if (composition_table_size == 0)
262 {
263 composition_table_size = 256;
264 composition_table
265 = (struct composition **) xmalloc (sizeof (composition_table[0])
266 * composition_table_size);
267 }
268 else if (composition_table_size <= n_compositions)
269 {
270 composition_table_size += 256;
271 composition_table
272 = (struct composition **) xrealloc (composition_table,
273 sizeof (composition_table[0])
274 * composition_table_size);
275 }
276
277 key_contents = XVECTOR (key)->contents;
278
279 /* Check if the contents of COMPONENTS are valid if COMPONENTS is a
280 vector or a list. It should be a sequence of:
281 char1 rule1 char2 rule2 char3 ... ruleN charN+1 */
f30d8d94 282
dd5e1ed4 283 if (VECTORP (components)
f30d8d94
KH
284 && ASIZE (components) >= 2
285 && VECTORP (AREF (components, 0)))
286 {
287 /* COMPONENTS is a glyph-string. */
579c18d0 288 EMACS_UINT len = ASIZE (key);
f30d8d94
KH
289
290 for (i = 1; i < len; i++)
291 if (! VECTORP (AREF (key, i)))
292 goto invalid_composition;
293 }
dd5e1ed4 294 else if (VECTORP (components) || CONSP (components))
ca4c9455 295 {
77b37c05 296 EMACS_UINT len = ASIZE (key);
ca4c9455
KH
297
298 /* The number of elements should be odd. */
299 if ((len % 2) == 0)
300 goto invalid_composition;
301 /* All elements should be integers (character or encoded
302 composition rule). */
303 for (i = 0; i < len; i++)
304 {
305 if (!INTEGERP (key_contents[i]))
306 goto invalid_composition;
307 }
308 }
309
310 /* Change PROP from Form-A above to Form-B. We can directly modify
311 the cons cell of PROP because it is not shared. */
312 XSETFASTINT (id, n_compositions);
f3fbd155
KR
313 XSETCAR (prop, id);
314 XSETCDR (prop, Fcons (make_number (nchars), Fcons (key, XCDR (prop))));
ca4c9455
KH
315
316 /* Register the composition in composition_hash_table. */
317 hash_index = hash_put (hash_table, key, id, hash_code);
318
319 /* Register the composition in composition_table. */
320 cmp = (struct composition *) xmalloc (sizeof (struct composition));
321
322 cmp->method = (NILP (components)
323 ? COMPOSITION_RELATIVE
324 : ((INTEGERP (components) || STRINGP (components))
325 ? COMPOSITION_WITH_ALTCHARS
326 : COMPOSITION_WITH_RULE_ALTCHARS));
327 cmp->hash_index = hash_index;
328 glyph_len = (cmp->method == COMPOSITION_WITH_RULE_ALTCHARS
77b37c05
PE
329 ? (ASIZE (key) + 1) / 2
330 : ASIZE (key));
ca4c9455
KH
331 cmp->glyph_len = glyph_len;
332 cmp->offsets = (short *) xmalloc (sizeof (short) * glyph_len * 2);
333 cmp->font = NULL;
334
58753d74 335 if (cmp->method != COMPOSITION_WITH_RULE_ALTCHARS)
ca4c9455
KH
336 {
337 /* Relative composition. */
338 cmp->width = 0;
339 for (i = 0; i < glyph_len; i++)
340 {
341 int this_width;
342 ch = XINT (key_contents[i]);
8e86803c 343 this_width = (ch == '\t' ? 1 : CHAR_WIDTH (ch));
ca4c9455
KH
344 if (cmp->width < this_width)
345 cmp->width = this_width;
346 }
347 }
348 else
349 {
350 /* Rule-base composition. */
351 float leftmost = 0.0, rightmost;
352
353 ch = XINT (key_contents[0]);
69df789a 354 rightmost = ch != '\t' ? CHAR_WIDTH (ch) : 1;
ca4c9455
KH
355
356 for (i = 1; i < glyph_len; i += 2)
357 {
b13a45c6 358 int rule, gref, nref;
ca4c9455
KH
359 int this_width;
360 float this_left;
361
362 rule = XINT (key_contents[i]);
363 ch = XINT (key_contents[i + 1]);
69df789a 364 this_width = ch != '\t' ? CHAR_WIDTH (ch) : 1;
ca4c9455
KH
365
366 /* A composition rule is specified by an integer value
367 that encodes global and new reference points (GREF and
368 NREF). GREF and NREF are specified by numbers as
369 below:
370 0---1---2 -- ascent
371 | |
372 | |
373 | |
374 9--10--11 -- center
375 | |
376 ---3---4---5--- baseline
377 | |
378 6---7---8 -- descent
379 */
b13a45c6 380 COMPOSITION_DECODE_REFS (rule, gref, nref);
ca4c9455
KH
381 this_left = (leftmost
382 + (gref % 3) * (rightmost - leftmost) / 2.0
383 - (nref % 3) * this_width / 2.0);
384
385 if (this_left < leftmost)
386 leftmost = this_left;
387 if (this_left + this_width > rightmost)
388 rightmost = this_left + this_width;
389 }
390
391 cmp->width = rightmost - leftmost;
392 if (cmp->width < (rightmost - leftmost))
393 /* To get a ceiling integer value. */
394 cmp->width++;
395 }
396
397 composition_table[n_compositions] = cmp;
398
399 return n_compositions++;
400
401 invalid_composition:
402 /* Would it be better to remove this `composition' property? */
403 return -1;
404}
405
406\f
90b3fe91
KH
407/* Find a static composition at or nearest to position POS of OBJECT
408 (buffer or string).
ca4c9455
KH
409
410 OBJECT defaults to the current buffer. If there's a composition at
411 POS, set *START and *END to the start and end of the sequence,
412 *PROP to the `composition' property, and return 1.
413
414 If there's no composition at POS and LIMIT is negative, return 0.
415
416 Otherwise, search for a composition forward (LIMIT > POS) or
417 backward (LIMIT < POS). In this case, LIMIT bounds the search.
418
419 If a composition is found, set *START, *END, and *PROP as above,
420 and return 1, else return 0.
421
422 This doesn't check the validity of composition. */
423
424int
579c18d0
EZ
425find_composition (EMACS_INT pos, EMACS_INT limit,
426 EMACS_INT *start, EMACS_INT *end,
427 Lisp_Object *prop, Lisp_Object object)
ca4c9455
KH
428{
429 Lisp_Object val;
430
431 if (get_property_and_range (pos, Qcomposition, prop, start, end, object))
432 return 1;
433
434 if (limit < 0 || limit == pos)
435 return 0;
436
437 if (limit > pos) /* search forward */
d279f620
KH
438 {
439 val = Fnext_single_property_change (make_number (pos), Qcomposition,
440 object, make_number (limit));
441 pos = XINT (val);
442 if (pos == limit)
443 return 0;
444 }
ca4c9455 445 else /* search backward */
d279f620
KH
446 {
447 if (get_property_and_range (pos - 1, Qcomposition, prop, start, end,
448 object))
449 return 1;
450 val = Fprevious_single_property_change (make_number (pos), Qcomposition,
451 object, make_number (limit));
452 pos = XINT (val);
453 if (pos == limit)
454 return 0;
455 pos--;
456 }
ca4c9455
KH
457 get_property_and_range (pos, Qcomposition, prop, start, end, object);
458 return 1;
459}
460
461/* Run a proper function to adjust the composition sitting between
462 FROM and TO with property PROP. */
463
464static void
579c18d0 465run_composition_function (EMACS_INT from, EMACS_INT to, Lisp_Object prop)
ca4c9455 466{
7d019510 467 Lisp_Object func;
aaefca97 468 EMACS_INT start, end;
ca4c9455
KH
469
470 func = COMPOSITION_MODIFICATION_FUNC (prop);
471 /* If an invalid composition precedes or follows, try to make them
472 valid too. */
473 if (from > BEGV
474 && find_composition (from - 1, -1, &start, &end, &prop, Qnil)
475 && !COMPOSITION_VALID_P (start, end, prop))
476 from = start;
477 if (to < ZV
478 && find_composition (to, -1, &start, &end, &prop, Qnil)
479 && !COMPOSITION_VALID_P (start, end, prop))
480 to = end;
775b3d2d 481 if (!NILP (Ffboundp (func)))
ca4c9455 482 call2 (func, make_number (from), make_number (to));
ca4c9455
KH
483}
484
485/* Make invalid compositions adjacent to or inside FROM and TO valid.
486 CHECK_MASK is bitwise `or' of mask bits defined by macros
487 CHECK_XXX (see the comment in composite.h).
488
b418f8a6 489 It also resets the text-property `auto-composed' to a proper region
f96ba4c1
KH
490 so that automatic character composition works correctly later while
491 displaying the region.
8f924df7 492
ca4c9455
KH
493 This function is called when a buffer text is changed. If the
494 change is deletion, FROM == TO. Otherwise, FROM < TO. */
495
496void
971de7fb 497update_compositions (EMACS_INT from, EMACS_INT to, int check_mask)
ca4c9455 498{
7d019510 499 Lisp_Object prop;
aaefca97 500 EMACS_INT start, end;
f96ba4c1
KH
501 /* The beginning and end of the region to set the property
502 `auto-composed' to nil. */
aaefca97 503 EMACS_INT min_pos = from, max_pos = to;
ca4c9455 504
6c1aa7f1
GM
505 if (inhibit_modification_hooks)
506 return;
177c0ea7 507
d3f40cbd
KH
508 /* If FROM and TO are not in a valid range, do nothing. */
509 if (! (BEGV <= from && from <= to && to <= ZV))
510 return;
511
ca4c9455
KH
512 if (check_mask & CHECK_HEAD)
513 {
514 /* FROM should be at composition boundary. But, insertion or
515 deletion will make two compositions adjacent and
516 indistinguishable when they have same (eq) property. To
517 avoid it, in such a case, we change the property of the
518 latter to the copy of it. */
519 if (from > BEGV
553d3164
KH
520 && find_composition (from - 1, -1, &start, &end, &prop, Qnil)
521 && COMPOSITION_VALID_P (start, end, prop))
ca4c9455 522 {
f96ba4c1
KH
523 min_pos = start;
524 if (end > to)
525 max_pos = end;
ca4c9455
KH
526 if (from < end)
527 Fput_text_property (make_number (from), make_number (end),
528 Qcomposition,
529 Fcons (XCAR (prop), XCDR (prop)), Qnil);
530 run_composition_function (start, end, prop);
531 from = end;
532 }
dd33cc56 533 else if (from < ZV
553d3164 534 && find_composition (from, -1, &start, &from, &prop, Qnil)
9657d668 535 && COMPOSITION_VALID_P (start, from, prop))
f96ba4c1
KH
536 {
537 if (from > to)
538 max_pos = from;
539 run_composition_function (start, from, prop);
540 }
ca4c9455
KH
541 }
542
543 if (check_mask & CHECK_INSIDE)
544 {
545 /* In this case, we are sure that (check & CHECK_TAIL) is also
546 nonzero. Thus, here we should check only compositions before
547 (to - 1). */
548 while (from < to - 1
549 && find_composition (from, to, &start, &from, &prop, Qnil)
9657d668 550 && COMPOSITION_VALID_P (start, from, prop)
ca4c9455
KH
551 && from < to - 1)
552 run_composition_function (start, from, prop);
553 }
554
555 if (check_mask & CHECK_TAIL)
556 {
557 if (from < to
553d3164
KH
558 && find_composition (to - 1, -1, &start, &end, &prop, Qnil)
559 && COMPOSITION_VALID_P (start, end, prop))
ca4c9455
KH
560 {
561 /* TO should be also at composition boundary. But,
562 insertion or deletion will make two compositions adjacent
563 and indistinguishable when they have same (eq) property.
564 To avoid it, in such a case, we change the property of
565 the former to the copy of it. */
566 if (to < end)
f96ba4c1
KH
567 {
568 Fput_text_property (make_number (start), make_number (to),
569 Qcomposition,
570 Fcons (XCAR (prop), XCDR (prop)), Qnil);
571 max_pos = end;
572 }
ca4c9455
KH
573 run_composition_function (start, end, prop);
574 }
575 else if (to < ZV
553d3164
KH
576 && find_composition (to, -1, &start, &end, &prop, Qnil)
577 && COMPOSITION_VALID_P (start, end, prop))
f96ba4c1
KH
578 {
579 run_composition_function (start, end, prop);
580 max_pos = end;
581 }
ca4c9455 582 }
f96ba4c1 583 if (min_pos < max_pos)
9d440521
KH
584 {
585 int count = SPECPDL_INDEX ();
586
587 specbind (Qinhibit_read_only, Qt);
588 specbind (Qinhibit_modification_hooks, Qt);
589 specbind (Qinhibit_point_motion_hooks, Qt);
590 Fremove_list_of_text_properties (make_number (min_pos),
591 make_number (max_pos),
592 Fcons (Qauto_composed, Qnil), Qnil);
593 unbind_to (count, Qnil);
594 }
ca4c9455
KH
595}
596
c1361885
KH
597
598/* Modify composition property values in LIST destructively. LIST is
599 a list as returned from text_property_list. Change values to the
600 top-level copies of them so that none of them are `eq'. */
601
602void
971de7fb 603make_composition_value_copy (Lisp_Object list)
c1361885
KH
604{
605 Lisp_Object plist, val;
606
607 for (; CONSP (list); list = XCDR (list))
608 {
609 plist = XCAR (XCDR (XCDR (XCAR (list))));
610 while (CONSP (plist) && CONSP (XCDR (plist)))
611 {
612 if (EQ (XCAR (plist), Qcomposition)
613 && (val = XCAR (XCDR (plist)), CONSP (val)))
f3fbd155 614 XSETCAR (XCDR (plist), Fcons (XCAR (val), XCDR (val)));
c1361885
KH
615 plist = XCDR (XCDR (plist));
616 }
617 }
618}
619
620
ca4c9455
KH
621/* Make text in the region between START and END a composition that
622 has COMPONENTS and MODIFICATION-FUNC.
623
624 If STRING is non-nil, then operate on characters contained between
625 indices START and END in STRING. */
626
627void
579c18d0
EZ
628compose_text (EMACS_INT start, EMACS_INT end, Lisp_Object components,
629 Lisp_Object modification_func, Lisp_Object string)
ca4c9455
KH
630{
631 Lisp_Object prop;
632
633 prop = Fcons (Fcons (make_number (end - start), components),
634 modification_func);
635 Fput_text_property (make_number (start), make_number (end),
636 Qcomposition, prop, string);
637}
58753d74
KH
638
639
f57e2426
J
640static Lisp_Object autocmp_chars (Lisp_Object, EMACS_INT, EMACS_INT,
641 EMACS_INT, struct window *,
642 struct face *, Lisp_Object);
58753d74
KH
643
644\f
645/* Lisp glyph-string handlers */
646
647/* Hash table for automatic composition. The key is a header of a
648 lgstring (Lispy glyph-string), and the value is a body of a
649 lgstring. */
650
651static Lisp_Object gstring_hash_table;
652
f57e2426 653static Lisp_Object gstring_lookup_cache (Lisp_Object);
58753d74
KH
654
655static Lisp_Object
971de7fb 656gstring_lookup_cache (Lisp_Object header)
58753d74
KH
657{
658 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
0de4bb68 659 EMACS_INT i = hash_lookup (h, header, NULL);
58753d74
KH
660
661 return (i >= 0 ? HASH_VALUE (h, i) : Qnil);
662}
663
664Lisp_Object
dcd5c89a 665composition_gstring_put_cache (Lisp_Object gstring, EMACS_INT len)
58753d74
KH
666{
667 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
0de4bb68 668 EMACS_UINT hash;
58753d74 669 Lisp_Object header, copy;
dcd5c89a 670 EMACS_INT i;
58753d74
KH
671
672 header = LGSTRING_HEADER (gstring);
673 hash = h->hashfn (h, header);
674 if (len < 0)
675 {
27ccc379
PE
676 EMACS_UINT j, glyph_len = LGSTRING_GLYPH_LEN (gstring);
677 for (j = 0; j < glyph_len; j++)
678 if (NILP (LGSTRING_GLYPH (gstring, j)))
58753d74 679 break;
27ccc379 680 len = j;
58753d74 681 }
087e2ea9 682
58753d74
KH
683 copy = Fmake_vector (make_number (len + 2), Qnil);
684 LGSTRING_SET_HEADER (copy, Fcopy_sequence (header));
685 for (i = 0; i < len; i++)
686 LGSTRING_SET_GLYPH (copy, i, Fcopy_sequence (LGSTRING_GLYPH (gstring, i)));
687 i = hash_put (h, LGSTRING_HEADER (copy), copy, hash);
688 LGSTRING_SET_ID (copy, make_number (i));
689 return copy;
690}
691
692Lisp_Object
971de7fb 693composition_gstring_from_id (int id)
58753d74
KH
694{
695 struct Lisp_Hash_Table *h = XHASH_TABLE (gstring_hash_table);
696
697 return HASH_VALUE (h, id);
698}
699
f57e2426
J
700static Lisp_Object fill_gstring_header (Lisp_Object, Lisp_Object,
701 Lisp_Object, Lisp_Object,
702 Lisp_Object);
58753d74
KH
703
704int
971de7fb 705composition_gstring_p (Lisp_Object gstring)
58753d74
KH
706{
707 Lisp_Object header;
708 int i;
709
710 if (! VECTORP (gstring) || ASIZE (gstring) < 2)
711 return 0;
712 header = LGSTRING_HEADER (gstring);
713 if (! VECTORP (header) || ASIZE (header) < 2)
714 return 0;
715 if (! NILP (LGSTRING_FONT (gstring))
f5199465
KH
716 && (! FONT_OBJECT_P (LGSTRING_FONT (gstring))
717 && ! CODING_SYSTEM_P (LGSTRING_FONT (gstring))))
58753d74
KH
718 return 0;
719 for (i = 1; i < ASIZE (LGSTRING_HEADER (gstring)); i++)
720 if (! NATNUMP (AREF (LGSTRING_HEADER (gstring), i)))
721 return 0;
722 if (! NILP (LGSTRING_ID (gstring)) && ! NATNUMP (LGSTRING_ID (gstring)))
723 return 0;
724 for (i = 0; i < LGSTRING_GLYPH_LEN (gstring); i++)
725 {
726 Lisp_Object glyph = LGSTRING_GLYPH (gstring, i);
727 if (NILP (glyph))
728 break;
729 if (! VECTORP (glyph) || ASIZE (glyph) != LGLYPH_SIZE)
730 return 0;
731 }
732 return 1;
733}
734
735int
579c18d0
EZ
736composition_gstring_width (Lisp_Object gstring, EMACS_INT from, EMACS_INT to,
737 struct font_metrics *metrics)
58753d74
KH
738{
739 Lisp_Object *glyph;
740 int width = 0;
741
742 if (metrics)
743 {
744 Lisp_Object font_object = LGSTRING_FONT (gstring);
58753d74 745
f5199465
KH
746 if (FONT_OBJECT_P (font_object))
747 {
748 struct font *font = XFONT_OBJECT (font_object);
749
750 metrics->ascent = font->ascent;
751 metrics->descent = font->descent;
752 }
753 else
754 {
755 metrics->ascent = 1;
756 metrics->descent = 0;
757 }
58753d74
KH
758 metrics->width = metrics->lbearing = metrics->rbearing = 0;
759 }
760 for (glyph = &LGSTRING_GLYPH (gstring, from); from < to; from++, glyph++)
761 {
762 int x;
763
764 if (NILP (LGLYPH_ADJUSTMENT (*glyph)))
765 width += LGLYPH_WIDTH (*glyph);
766 else
767 width += LGLYPH_WADJUST (*glyph);
768 if (metrics)
769 {
770 x = metrics->width + LGLYPH_LBEARING (*glyph) + LGLYPH_XOFF (*glyph);
771 if (metrics->lbearing > x)
772 metrics->lbearing = x;
773 x = metrics->width + LGLYPH_RBEARING (*glyph) + LGLYPH_XOFF (*glyph);
774 if (metrics->rbearing < x)
775 metrics->rbearing = x;
776 metrics->width = width;
777 x = LGLYPH_ASCENT (*glyph) - LGLYPH_YOFF (*glyph);
778 if (metrics->ascent < x)
779 metrics->ascent = x;
895416e3 780 x = LGLYPH_DESCENT (*glyph) + LGLYPH_YOFF (*glyph);
58753d74
KH
781 if (metrics->descent < x)
782 metrics->descent = x;
783 }
784 }
785 return width;
786}
787
788
789static Lisp_Object gstring_work;
790static Lisp_Object gstring_work_headers;
791
792static Lisp_Object
971de7fb 793fill_gstring_header (Lisp_Object header, Lisp_Object start, Lisp_Object end, Lisp_Object font_object, Lisp_Object string)
58753d74
KH
794{
795 EMACS_INT from, to, from_byte;
796 EMACS_INT len, i;
797
798 if (NILP (string))
799 {
4b4deea2 800 if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
58753d74
KH
801 error ("Attempt to shape unibyte text");
802 validate_region (&start, &end);
803 from = XFASTINT (start);
804 to = XFASTINT (end);
805 from_byte = CHAR_TO_BYTE (from);
806 }
807 else
808 {
809 CHECK_STRING (string);
793ffee8 810 if (! STRING_MULTIBYTE (string))
58753d74 811 error ("Attempt to shape unibyte text");
ea8ba975 812 /* FROM and TO are checked by the caller. */
58753d74 813 from = XINT (start);
58753d74
KH
814 to = XINT (end);
815 if (from < 0 || from > to || to > SCHARS (string))
816 args_out_of_range_3 (string, start, end);
817 from_byte = string_char_to_byte (string, from);
818 }
819
820 len = to - from;
821 if (len == 0)
822 error ("Attempt to shape zero-length text");
823 if (VECTORP (header))
824 {
825 if (ASIZE (header) != len + 1)
826 args_out_of_range (header, make_number (len + 1));
827 }
828 else
829 {
830 if (len <= 8)
831 header = AREF (gstring_work_headers, len - 1);
832 else
833 header = Fmake_vector (make_number (len + 1), Qnil);
834 }
835
836 ASET (header, 0, font_object);
837 for (i = 0; i < len; i++)
838 {
839 int c;
840
841 if (NILP (string))
842 FETCH_CHAR_ADVANCE_NO_CHECK (c, from, from_byte);
843 else
844 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, string, from, from_byte);
845 ASET (header, i + 1, make_number (c));
846 }
847 return header;
848}
849
58753d74 850static void
971de7fb 851fill_gstring_body (Lisp_Object gstring)
58753d74
KH
852{
853 Lisp_Object font_object = LGSTRING_FONT (gstring);
854 Lisp_Object header = AREF (gstring, 0);
855 EMACS_INT len = LGSTRING_CHAR_LEN (gstring);
856 EMACS_INT i;
857
858 for (i = 0; i < len; i++)
859 {
860 Lisp_Object g = LGSTRING_GLYPH (gstring, i);
f8c86b69 861 int c = XFASTINT (AREF (header, i + 1));
58753d74
KH
862
863 if (NILP (g))
864 {
865 g = LGLYPH_NEW ();
866 LGSTRING_SET_GLYPH (gstring, i, g);
867 }
868 LGLYPH_SET_FROM (g, i);
869 LGLYPH_SET_TO (g, i);
870 LGLYPH_SET_CHAR (g, c);
f5199465 871 if (FONT_OBJECT_P (font_object))
58753d74
KH
872 {
873 font_fill_lglyph_metrics (g, font_object);
874 }
875 else
876 {
877 int width = XFASTINT (CHAR_TABLE_REF (Vchar_width_table, c));
878
879 LGLYPH_SET_CODE (g, c);
880 LGLYPH_SET_LBEARING (g, 0);
881 LGLYPH_SET_RBEARING (g, width);
882 LGLYPH_SET_WIDTH (g, width);
883 LGLYPH_SET_ASCENT (g, 1);
884 LGLYPH_SET_DESCENT (g, 0);
885 }
886 LGLYPH_SET_ADJUSTMENT (g, Qnil);
887 }
888 if (i < LGSTRING_GLYPH_LEN (gstring))
889 LGSTRING_SET_GLYPH (gstring, i, Qnil);
890}
891
58753d74 892
10f72a37
KH
893/* Try to compose the characters at CHARPOS according to composition
894 rule RULE ([PATTERN PREV-CHARS FUNC]). LIMIT limits the characters
895 to compose. STRING, if not nil, is a target string. WIN is a
896 window where the characters are being displayed. If characters are
897 successfully composed, return the composition as a glyph-string
898 object. Otherwise return nil. */
58753d74
KH
899
900static Lisp_Object
971de7fb 901autocmp_chars (Lisp_Object rule, EMACS_INT charpos, EMACS_INT bytepos, EMACS_INT limit, struct window *win, struct face *face, Lisp_Object string)
58753d74
KH
902{
903 int count = SPECPDL_INDEX ();
904 FRAME_PTR f = XFRAME (win->frame);
905 Lisp_Object pos = make_number (charpos);
10f72a37 906 EMACS_INT to;
58753d74 907 EMACS_INT pt = PT, pt_byte = PT_BYTE;
10f72a37 908 Lisp_Object re, font_object, lgstring;
579c18d0 909 EMACS_INT len;
087e2ea9 910
58753d74 911 record_unwind_save_match_data ();
10f72a37
KH
912 re = AREF (rule, 0);
913 if (NILP (re))
914 len = 1;
915 else if (! STRINGP (re))
916 return unbind_to (count, Qnil);
917 else if ((len = fast_looking_at (re, charpos, bytepos, limit, -1, string))
918 > 0)
58753d74 919 {
10f72a37
KH
920 if (NILP (string))
921 len = BYTE_TO_CHAR (bytepos + len) - charpos;
922 else
923 len = string_byte_to_char (string, bytepos + len) - charpos;
924 }
925 if (len <= 0)
926 return unbind_to (count, Qnil);
927 to = limit = charpos + len;
58753d74 928#ifdef HAVE_WINDOW_SYSTEM
10f72a37
KH
929 if (FRAME_WINDOW_P (f))
930 {
931 font_object = font_range (charpos, &to, win, face, string);
932 if (! FONT_OBJECT_P (font_object)
933 || (! NILP (re)
934 && to < limit
935 && (fast_looking_at (re, charpos, bytepos, to, -1, string) <= 0)))
936 return unbind_to (count, Qnil);
937 }
938 else
58753d74 939#endif /* not HAVE_WINDOW_SYSTEM */
10f72a37
KH
940 font_object = win->frame;
941 lgstring = Fcomposition_get_gstring (pos, make_number (to), font_object,
942 string);
943 if (NILP (LGSTRING_ID (lgstring)))
944 {
945 Lisp_Object args[6];
5dcde606 946
10f72a37
KH
947 /* Save point as marker before calling out to lisp. */
948 if (NILP (string))
949 {
950 Lisp_Object m = Fmake_marker ();
951 set_marker_both (m, Qnil, pt, pt_byte);
952 record_unwind_protect (restore_point_unwind, m);
58753d74 953 }
10f72a37
KH
954
955 args[0] = Vauto_composition_function;
956 args[1] = AREF (rule, 2);
957 args[2] = pos;
958 args[3] = make_number (to);
959 args[4] = font_object;
960 args[5] = string;
961 lgstring = safe_call (6, args);
962 if (NILP (string))
963 TEMP_SET_PT_BOTH (pt, pt_byte);
58753d74 964 }
10f72a37 965 return unbind_to (count, lgstring);
58753d74
KH
966}
967
82ebc97b
KH
968static Lisp_Object _work_val;
969static int _work_char;
970
f6aa6ec6
KH
971/* 1 iff the character C is composable. Characters of general
972 category Z? or C? are not composable except for ZWNJ and ZWJ. */
973
82ebc97b 974#define CHAR_COMPOSABLE_P(C) \
a28d4396
KH
975 ((C) > ' ' \
976 && ((C) == 0x200C || (C) == 0x200D \
977 || (_work_val = CHAR_TABLE_REF (Vunicode_category_table, (C)), \
978 (SYMBOLP (_work_val) \
979 && (_work_char = SDATA (SYMBOL_NAME (_work_val))[0]) != 'C' \
980 && _work_char != 'Z'))))
58753d74
KH
981
982/* Update cmp_it->stop_pos to the next position after CHARPOS (and
983 BYTEPOS) where character composition may happen. If BYTEPOS is
82ebc97b
KH
984 negative, compute it. ENDPOS is a limit of searching. If it is
985 less than CHARPOS, search backward to ENDPOS+1 assuming that
986 set_iterator_to_next works in reverse order. In this case, if a
987 composition closest to CHARPOS is found, set cmp_it->stop_pos to
988 the last character of the composition.
989
990 If no composition is found, set cmp_it->ch to -2. If a static
991 composition is found, set cmp_it->ch to -1. Otherwise, set
992 cmp_it->ch to the character that triggers the automatic
993 composition. */
58753d74
KH
994
995void
971de7fb 996composition_compute_stop_pos (struct composition_it *cmp_it, EMACS_INT charpos, EMACS_INT bytepos, EMACS_INT endpos, Lisp_Object string)
58753d74 997{
f8c86b69
PE
998 EMACS_INT start, end;
999 int c;
58753d74 1000 Lisp_Object prop, val;
3ffdafce
KH
1001 /* This is from forward_to_next_line_start in xdisp.c. */
1002 const int MAX_NEWLINE_DISTANCE = 500;
58753d74 1003
82ebc97b
KH
1004 if (charpos < endpos)
1005 {
1006 if (endpos > charpos + MAX_NEWLINE_DISTANCE)
1007 endpos = charpos + MAX_NEWLINE_DISTANCE;
1008 }
1009 else if (endpos < charpos)
1010 {
1011 /* We search backward for a position to check composition. */
1012 if (endpos < 0)
1013 {
1014 /* But we don't know where to stop the searching. */
1015 endpos = NILP (string) ? BEGV - 1 : -1;
1016 /* Usually we don't reach ENDPOS because we stop searching
1017 at an uncomposable character (NL, LRE, etc). */
1018 }
1019 }
053ca52b 1020 cmp_it->id = -1;
44566dc7 1021 cmp_it->ch = -2;
82ebc97b
KH
1022 cmp_it->reversed_p = 0;
1023 cmp_it->stop_pos = endpos;
1024 if (charpos == endpos)
1025 return;
1026 /* FIXME: Bidi is not yet handled well in static composition. */
1027 if (charpos < endpos
1028 && find_composition (charpos, endpos, &start, &end, &prop, string)
58753d74
KH
1029 && COMPOSITION_VALID_P (start, end, prop))
1030 {
1031 cmp_it->stop_pos = endpos = start;
1032 cmp_it->ch = -1;
1033 }
4b4deea2 1034 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
d9a7c140 1035 || NILP (Vauto_composition_mode))
58753d74
KH
1036 return;
1037 if (bytepos < 0)
1038 {
82ebc97b 1039 if (NILP (string))
58753d74 1040 bytepos = CHAR_TO_BYTE (charpos);
82ebc97b
KH
1041 else
1042 bytepos = string_char_to_byte (string, charpos);
58753d74
KH
1043 }
1044
1045 start = charpos;
82ebc97b 1046 if (charpos < endpos)
58753d74 1047 {
82ebc97b
KH
1048 /* Forward search. */
1049 while (charpos < endpos)
ea8ba975 1050 {
82ebc97b
KH
1051 if (STRINGP (string))
1052 FETCH_STRING_CHAR_ADVANCE (c, string, charpos, bytepos);
1053 else
1054 FETCH_CHAR_ADVANCE (c, charpos, bytepos);
1055 if (c == '\n')
1056 {
1057 cmp_it->ch = -2;
1058 break;
1059 }
1060 val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1061 if (! NILP (val))
1062 {
1063 Lisp_Object elt;
10f72a37 1064 int ridx;
82ebc97b 1065
10f72a37 1066 for (ridx = 0; CONSP (val); val = XCDR (val), ridx++)
82ebc97b
KH
1067 {
1068 elt = XCAR (val);
1069 if (VECTORP (elt) && ASIZE (elt) == 3
1070 && NATNUMP (AREF (elt, 1))
1071 && charpos - 1 - XFASTINT (AREF (elt, 1)) >= start)
1072 break;
1073 }
1074 if (CONSP (val))
1075 {
10f72a37 1076 cmp_it->rule_idx = ridx;
82ebc97b
KH
1077 cmp_it->lookback = XFASTINT (AREF (elt, 1));
1078 cmp_it->stop_pos = charpos - 1 - cmp_it->lookback;
1079 cmp_it->ch = c;
1080 return;
1081 }
1082 }
ea8ba975 1083 }
ff94e32c
KH
1084 if (charpos == endpos)
1085 {
1086 /* We couldn't find a composition point before ENDPOS. But,
1087 some character after ENDPOS may be composed with
1088 characters before ENDPOS. So, we should stop at the safe
1089 point. */
1090 charpos = endpos - MAX_AUTO_COMPOSITION_LOOKBACK;
1091 if (charpos < start)
1092 charpos = start;
1093 }
82ebc97b 1094 }
b7050583 1095 else if (charpos > endpos)
82ebc97b
KH
1096 {
1097 /* Search backward for a pattern that may be composed and the
1098 position of (possibly) the last character of the match is
1099 closest to (but not after) START. The reason for the last
d07f018c
EZ
1100 character is that set_iterator_to_next works in reverse order,
1101 and thus we must stop at the last character for composition
82ebc97b
KH
1102 check. */
1103 unsigned char *p;
1104 int len;
d07f018c
EZ
1105 /* Limit byte position used in fast_looking_at. This is the
1106 byte position of the character after START. */
82ebc97b
KH
1107 EMACS_INT limit;
1108
1109 if (NILP (string))
1110 p = BYTE_POS_ADDR (bytepos);
1111 else
1112 p = SDATA (string) + bytepos;
1113 c = STRING_CHAR_AND_LENGTH (p, len);
1114 limit = bytepos + len;
1115 while (CHAR_COMPOSABLE_P (c))
58753d74 1116 {
10f72a37
KH
1117 val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1118 if (! NILP (val))
82ebc97b 1119 {
10f72a37 1120 Lisp_Object elt;
8f5201ae 1121 int ridx, back, blen;
58753d74 1122
10f72a37 1123 for (ridx = 0; CONSP (val); val = XCDR (val), ridx++)
82ebc97b 1124 {
10f72a37
KH
1125 elt = XCAR (val);
1126 if (VECTORP (elt) && ASIZE (elt) == 3
1127 && NATNUMP (AREF (elt, 1))
1128 && charpos - (back = XFASTINT (AREF (elt, 1))) > endpos)
82ebc97b 1129 {
10f72a37
KH
1130 EMACS_INT cpos = charpos - back, bpos;
1131
1132 if (back == 0)
1133 bpos = bytepos;
82ebc97b 1134 else
10f72a37
KH
1135 bpos = (NILP (string) ? CHAR_TO_BYTE (cpos)
1136 : string_char_to_byte (string, cpos));
1137 if (STRINGP (AREF (elt, 0)))
8f5201ae
PE
1138 blen = fast_looking_at (AREF (elt, 0), cpos, bpos,
1139 start + 1, limit, string);
10f72a37 1140 else
8f5201ae
PE
1141 blen = 1;
1142 if (blen > 0)
82ebc97b 1143 {
10f72a37 1144 /* Make CPOS point to the last character of
8f5201ae
PE
1145 match. Note that BLEN is byte-length. */
1146 if (blen > 1)
10f72a37 1147 {
8f5201ae 1148 bpos += blen;
10f72a37
KH
1149 if (NILP (string))
1150 cpos = BYTE_TO_CHAR (bpos) - 1;
1151 else
1152 cpos = string_byte_to_char (string, bpos) - 1;
1153 }
1154 back = cpos - (charpos - back);
1155 if (cmp_it->stop_pos < cpos
1156 || (cmp_it->stop_pos == cpos
1157 && cmp_it->lookback < back))
1158 {
1159 cmp_it->rule_idx = ridx;
1160 cmp_it->stop_pos = cpos;
1161 cmp_it->ch = c;
1162 cmp_it->lookback = back;
1163 cmp_it->nchars = back + 1;
1164 }
82ebc97b
KH
1165 }
1166 }
1167 }
1168 }
1169 if (charpos - 1 == endpos)
1170 break;
1171 if (STRINGP (string))
58753d74 1172 {
82ebc97b
KH
1173 p--, bytepos--;
1174 while (! CHAR_HEAD_P (*p))
1175 p--, bytepos--;
1176 charpos--;
1177 }
1178 else
1179 {
1180 DEC_BOTH (charpos, bytepos);
1181 p = BYTE_POS_ADDR (bytepos);
58753d74 1182 }
82ebc97b
KH
1183 c = STRING_CHAR (p);
1184 }
1185 if (cmp_it->ch >= 0)
1186 /* We found a position to check. */
1187 return;
1188 /* Skip all uncomposable characters. */
1189 if (NILP (string))
1190 {
1191 while (charpos - 1 > endpos && ! CHAR_COMPOSABLE_P (c))
58753d74 1192 {
82ebc97b
KH
1193 DEC_BOTH (charpos, bytepos);
1194 c = FETCH_MULTIBYTE_CHAR (bytepos);
1195 }
1196 }
1197 else
1198 {
1199 while (charpos - 1 > endpos && ! CHAR_COMPOSABLE_P (c))
1200 {
1201 p--;
1202 while (! CHAR_HEAD_P (*p))
1203 p--;
1204 charpos--;
1205 c = STRING_CHAR (p);
58753d74
KH
1206 }
1207 }
1208 }
44566dc7 1209 cmp_it->stop_pos = charpos;
58753d74
KH
1210}
1211
1212/* Check if the character at CHARPOS (and BYTEPOS) is composed
22e33406 1213 (possibly with the following characters) on window W. ENDPOS limits
58753d74
KH
1214 characters to be composed. FACE, in non-NULL, is a base face of
1215 the character. If STRING is not nil, it is a string containing the
1216 character to check, and CHARPOS and BYTEPOS are indices in the
1217 string. In that case, FACE must not be NULL.
1218
1219 If the character is composed, setup members of CMP_IT (id, nglyphs,
82ebc97b
KH
1220 from, to, reversed_p), and return 1. Otherwise, update
1221 CMP_IT->stop_pos, and return 0. */
58753d74
KH
1222
1223int
971de7fb 1224composition_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)
58753d74 1225{
f6aa6ec6
KH
1226 if (endpos < 0)
1227 endpos = NILP (string) ? BEGV : 0;
e614ea00 1228
3ffdafce
KH
1229 if (cmp_it->ch == -2)
1230 {
1231 composition_compute_stop_pos (cmp_it, charpos, bytepos, endpos, string);
10f72a37 1232 if (cmp_it->ch == -2 || cmp_it->stop_pos != charpos)
82ebc97b 1233 /* The current position is not composed. */
3ffdafce
KH
1234 return 0;
1235 }
1236
58753d74
KH
1237 if (cmp_it->ch < 0)
1238 {
1239 /* We are looking at a static composition. */
1240 EMACS_INT start, end;
1241 Lisp_Object prop;
1242
1243 find_composition (charpos, -1, &start, &end, &prop, string);
1244 cmp_it->id = get_composition_id (charpos, bytepos, end - start,
1245 prop, string);
1246 if (cmp_it->id < 0)
1247 goto no_composition;
1248 cmp_it->nchars = end - start;
1249 cmp_it->nglyphs = composition_table[cmp_it->id]->glyph_len;
1250 }
29fb7306 1251 else if (w)
58753d74 1252 {
10f72a37 1253 Lisp_Object lgstring = Qnil;
b246f932
PE
1254 Lisp_Object val, elt;
1255 int i;
58753d74
KH
1256
1257 val = CHAR_TABLE_REF (Vcomposition_function_table, cmp_it->ch);
10f72a37 1258 for (i = 0; i < cmp_it->rule_idx; i++, val = XCDR (val));
82ebc97b 1259 if (charpos < endpos)
90b3fe91 1260 {
82ebc97b
KH
1261 for (; CONSP (val); val = XCDR (val))
1262 {
1263 elt = XCAR (val);
10f72a37
KH
1264 if (! VECTORP (elt) || ASIZE (elt) != 3
1265 || ! INTEGERP (AREF (elt, 1)))
1266 continue;
1267 if (XFASTINT (AREF (elt, 1)) != cmp_it->lookback)
aa3830c4 1268 goto no_composition;
10f72a37
KH
1269 lgstring = autocmp_chars (elt, charpos, bytepos, endpos,
1270 w, face, string);
1271 if (composition_gstring_p (lgstring))
82ebc97b 1272 break;
10f72a37
KH
1273 lgstring = Qnil;
1274 /* Composition failed perhaps because the font doesn't
1275 support sufficient range of characters. Try the
1276 other composition rules if any. */
82ebc97b 1277 }
82ebc97b 1278 cmp_it->reversed_p = 0;
90b3fe91 1279 }
82ebc97b
KH
1280 else
1281 {
10f72a37 1282 EMACS_INT cpos = charpos, bpos = bytepos;
90b3fe91 1283
10f72a37 1284 while (1)
82ebc97b 1285 {
10f72a37
KH
1286 elt = XCAR (val);
1287 if (cmp_it->lookback > 0)
1288 {
f6aa6ec6 1289 cpos = charpos - cmp_it->lookback;
10f72a37
KH
1290 if (STRINGP (string))
1291 bpos = string_char_to_byte (string, cpos);
1292 else
1293 bpos = CHAR_TO_BYTE (cpos);
1294 }
1295 lgstring = autocmp_chars (elt, cpos, bpos, charpos + 1, w, face,
1296 string);
1297 if (composition_gstring_p (lgstring)
1298 && cpos + LGSTRING_CHAR_LEN (lgstring) - 1 == charpos)
1299 break;
1300 /* Composition failed or didn't cover the current
1301 character. */
1302 if (cmp_it->lookback == 0)
82ebc97b 1303 goto no_composition;
10f72a37
KH
1304 lgstring = Qnil;
1305 /* Try to find a shorter compostion that starts after CPOS. */
1306 composition_compute_stop_pos (cmp_it, charpos, bytepos, cpos,
1307 string);
1308 if (cmp_it->ch == -2 || cmp_it->stop_pos < charpos)
1309 goto no_composition;
1310 val = CHAR_TABLE_REF (Vcomposition_function_table, cmp_it->ch);
1311 for (i = 0; i < cmp_it->rule_idx; i++, val = XCDR (val));
82ebc97b
KH
1312 }
1313 cmp_it->reversed_p = 1;
1314 }
10f72a37
KH
1315 if (NILP (lgstring))
1316 goto no_composition;
1317 if (NILP (LGSTRING_ID (lgstring)))
1318 lgstring = composition_gstring_put_cache (lgstring, -1);
1319 cmp_it->id = XINT (LGSTRING_ID (lgstring));
1320 for (i = 0; i < LGSTRING_GLYPH_LEN (lgstring); i++)
1321 if (NILP (LGSTRING_GLYPH (lgstring, i)))
58753d74
KH
1322 break;
1323 cmp_it->nglyphs = i;
82ebc97b
KH
1324 cmp_it->from = 0;
1325 cmp_it->to = i;
58753d74 1326 }
29fb7306
KH
1327 else
1328 goto no_composition;
58753d74
KH
1329 return 1;
1330
1331 no_composition:
82ebc97b
KH
1332 if (charpos == endpos)
1333 return 0;
1334 if (charpos < endpos)
1335 {
1336 charpos++;
10f72a37 1337 if (NILP (string))
82ebc97b 1338 INC_POS (bytepos);
10f72a37 1339 else
aa3830c4 1340 bytepos += BYTES_BY_CHAR_HEAD (*(SDATA (string) + bytepos));
82ebc97b 1341 }
58753d74 1342 else
82ebc97b
KH
1343 {
1344 charpos--;
1345 /* BYTEPOS is calculated in composition_compute_stop_pos */
1346 bytepos = -1;
1347 }
58753d74
KH
1348 composition_compute_stop_pos (cmp_it, charpos, bytepos, endpos, string);
1349 return 0;
1350}
1351
10f72a37
KH
1352/* Update charpos, nchars, nbytes, and width of the current grapheme
1353 cluster.
1354
1355 If the composition is static or automatic in L2R context, the
1356 cluster is identified by CMP_IT->from, and CHARPOS is the position
1357 of the first character of the cluster. In this case, update
1358 CMP_IT->to too.
1359
1360 If the composition is automatic in R2L context, the cluster is
1361 identified by CMP_IT->to, and CHARPOS is the position of the last
1362 character of the cluster. In this case, update CMP_IT->from too.
1363
1364 The return value is the character code of the first character of
1365 the cluster, or -1 if the composition is somehow broken. */
82ebc97b 1366
58753d74 1367int
971de7fb 1368composition_update_it (struct composition_it *cmp_it, EMACS_INT charpos, EMACS_INT bytepos, Lisp_Object string)
58753d74 1369{
80e079b2 1370 int i, c IF_LINT (= 0);
58753d74
KH
1371
1372 if (cmp_it->ch < 0)
1373 {
10f72a37 1374 /* static composition */
58753d74
KH
1375 struct composition *cmp = composition_table[cmp_it->id];
1376
10f72a37 1377 cmp_it->charpos = charpos;
58753d74
KH
1378 cmp_it->to = cmp_it->nglyphs;
1379 if (cmp_it->nglyphs == 0)
1380 c = -1;
1381 else
1382 {
1383 for (i = 0; i < cmp->glyph_len; i++)
1384 if ((c = COMPOSITION_GLYPH (cmp, i)) != '\t')
1385 break;
1386 if (c == '\t')
1387 c = ' ';
1388 }
1389 cmp_it->width = cmp->width;
10f72a37
KH
1390 charpos += cmp_it->nchars;
1391 if (STRINGP (string))
1392 cmp_it->nbytes = string_char_to_byte (string, charpos) - bytepos;
1393 else
1394 cmp_it->nbytes = CHAR_TO_BYTE (charpos) - bytepos;
58753d74
KH
1395 }
1396 else
1397 {
10f72a37 1398 /* automatic composition */
58753d74 1399 Lisp_Object gstring = composition_gstring_from_id (cmp_it->id);
10f72a37 1400 Lisp_Object glyph;
579c18d0 1401 EMACS_INT from;
58753d74
KH
1402
1403 if (cmp_it->nglyphs == 0)
1404 {
58753d74
KH
1405 cmp_it->nchars = LGSTRING_CHAR_LEN (gstring);
1406 cmp_it->width = 0;
10f72a37
KH
1407 cmp_it->from = cmp_it->to = 0;
1408 return -1;
58753d74 1409 }
10f72a37 1410 if (! cmp_it->reversed_p)
58753d74 1411 {
10f72a37
KH
1412 glyph = LGSTRING_GLYPH (gstring, cmp_it->from);
1413 from = LGLYPH_FROM (glyph);
58753d74
KH
1414 for (cmp_it->to = cmp_it->from + 1; cmp_it->to < cmp_it->nglyphs;
1415 cmp_it->to++)
1416 {
1417 glyph = LGSTRING_GLYPH (gstring, cmp_it->to);
1418 if (LGLYPH_FROM (glyph) != from)
1419 break;
58753d74 1420 }
10f72a37 1421 cmp_it->charpos = charpos;
58753d74 1422 }
82ebc97b
KH
1423 else
1424 {
10f72a37
KH
1425 glyph = LGSTRING_GLYPH (gstring, cmp_it->to - 1);
1426 from = LGLYPH_FROM (glyph);
1427 cmp_it->charpos = charpos - (LGLYPH_TO (glyph) - from);
1428 for (cmp_it->from = cmp_it->to - 1; cmp_it->from > 0;
1429 cmp_it->from--)
82ebc97b 1430 {
10f72a37 1431 glyph = LGSTRING_GLYPH (gstring, cmp_it->from - 1);
82ebc97b
KH
1432 if (LGLYPH_FROM (glyph) != from)
1433 break;
82ebc97b 1434 }
10f72a37
KH
1435 }
1436 glyph = LGSTRING_GLYPH (gstring, cmp_it->from);
1437 cmp_it->nchars = LGLYPH_TO (glyph) + 1 - from;
1438 cmp_it->nbytes = 0;
1439 cmp_it->width = 0;
1440 for (i = cmp_it->nchars - 1; i >= 0; i--)
1441 {
1442 c = XINT (LGSTRING_CHAR (gstring, i));
1443 cmp_it->nbytes += CHAR_BYTES (c);
63257f6c 1444 cmp_it->width += CHAR_WIDTH (c);
82ebc97b 1445 }
58753d74 1446 }
58753d74
KH
1447 return c;
1448}
1449
1450
90b3fe91
KH
1451struct position_record
1452{
1453 EMACS_INT pos, pos_byte;
1454 unsigned char *p;
1455};
1456
763d7377 1457/* Update the members of POSITION to the next character boundary. */
90b3fe91
KH
1458#define FORWARD_CHAR(POSITION, STOP) \
1459 do { \
90b3fe91 1460 (POSITION).pos++; \
900c4486
KH
1461 if ((POSITION).pos == (STOP)) \
1462 { \
1463 (POSITION).p = GAP_END_ADDR; \
1464 (POSITION).pos_byte = GPT_BYTE; \
1465 } \
1466 else \
1467 { \
900c4486 1468 (POSITION).pos_byte += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
d45a49e3 1469 (POSITION).p += BYTES_BY_CHAR_HEAD (*((POSITION).p)); \
900c4486 1470 } \
90b3fe91
KH
1471 } while (0)
1472
763d7377 1473/* Update the members of POSITION to the previous character boundary. */
90b3fe91
KH
1474#define BACKWARD_CHAR(POSITION, STOP) \
1475 do { \
a28d4396 1476 if ((POSITION).pos == (STOP)) \
90b3fe91
KH
1477 (POSITION).p = GPT_ADDR; \
1478 do { \
1479 (POSITION).pos_byte--; \
1480 (POSITION).p--; \
1481 } while (! CHAR_HEAD_P (*((POSITION).p))); \
1482 (POSITION).pos--; \
1483 } while (0)
1484
90b3fe91 1485/* This is like find_composition, but find an automatic composition
a28d4396
KH
1486 instead. It is assured that POS is not within a static
1487 composition. If found, set *GSTRING to the glyph-string
1488 representing the composition, and return 1. Otherwise, *GSTRING to
1489 Qnil, and return 0. */
90b3fe91
KH
1490
1491static int
a28d4396
KH
1492find_automatic_composition (EMACS_INT pos, EMACS_INT limit,
1493 EMACS_INT *start, EMACS_INT *end,
1494 Lisp_Object *gstring, Lisp_Object string)
90b3fe91
KH
1495{
1496 EMACS_INT head, tail, stop;
a28d4396
KH
1497 /* Forward limit position of checking a composition taking a
1498 looking-back count into account. */
895416e3 1499 EMACS_INT fore_check_limit;
a28d4396 1500 struct position_record cur, prev;
90b3fe91 1501 int c;
29fb7306 1502 Lisp_Object window;
90b3fe91 1503 struct window *w;
a28d4396 1504 int need_adjustment = 0;
90b3fe91 1505
3eda4b19 1506 window = Fget_buffer_window (Fcurrent_buffer (), Qnil);
29fb7306
KH
1507 if (NILP (window))
1508 return 0;
1509 w = XWINDOW (window);
1510
a28d4396 1511 cur.pos = pos;
90b3fe91
KH
1512 if (NILP (string))
1513 {
1514 head = BEGV, tail = ZV, stop = GPT;
a28d4396
KH
1515 cur.pos_byte = CHAR_TO_BYTE (cur.pos);
1516 cur.p = BYTE_POS_ADDR (cur.pos_byte);
90b3fe91
KH
1517 }
1518 else
1519 {
1520 head = 0, tail = SCHARS (string), stop = -1;
a28d4396
KH
1521 cur.pos_byte = string_char_to_byte (string, cur.pos);
1522 cur.p = SDATA (string) + cur.pos_byte;
90b3fe91 1523 }
a28d4396
KH
1524 if (limit < 0)
1525 /* Finding a composition covering the character after POS is the
1526 same as setting LIMIT to POS. */
1527 limit = pos;
1528 if (limit <= pos)
1529 fore_check_limit = min (tail, pos + 1 + MAX_AUTO_COMPOSITION_LOOKBACK);
90b3fe91 1530 else
895416e3 1531 fore_check_limit = min (tail, limit + MAX_AUTO_COMPOSITION_LOOKBACK);
90b3fe91 1532
a28d4396 1533 /* Provided that we have these possible compositions now:
895416e3 1534
a28d4396
KH
1535 POS: 1 2 3 4 5 6 7 8 9
1536 |-A-|
1537 |-B-|-C-|--D--|
895416e3 1538
a28d4396
KH
1539 Here, it is known that characters after positions 1 and 9 can
1540 never be composed (i.e. ! CHAR_COMPOSABLE_P (CH)), and
1541 composition A is an invalid one because it's partially covered by
1542 the valid composition C. And to know whether a composition is
1543 valid or not, the only way is to start searching forward from a
1544 position that can not be a tail part of composition (it's 2 in
1545 the above case).
1546
1547 Now we have these cases (1 through 4):
1548
1549 -- character after POS is ... --
1550 not composable composable
1551 LIMIT <= POS (1) (3)
1552 POS < LIMIT (2) (4)
1553
1554 Among them, in case (2), we simply search forward from POS.
1555
1556 In the other cases, we at first rewind back to the position where
1557 the previous character is not composable or the beginning of
1558 buffer (string), then search compositions forward. In case (1)
1559 and (3) we repeat this process until a composition is found. */
1560
1561 while (1)
1562 {
62a6e103 1563 c = STRING_CHAR (cur.p);
90b3fe91 1564 if (! CHAR_COMPOSABLE_P (c))
90b3fe91 1565 {
a28d4396
KH
1566 if (limit <= pos) /* case (1) */
1567 {
1568 do {
31bfc35c 1569 if (cur.pos <= limit)
a28d4396
KH
1570 return 0;
1571 BACKWARD_CHAR (cur, stop);
1572 c = STRING_CHAR (cur.p);
1573 } while (! CHAR_COMPOSABLE_P (c));
1574 fore_check_limit = cur.pos + 1;
1575 }
1576 else /* case (2) */
1577 /* No need of rewinding back. */
1578 goto search_forward;
1579 }
90b3fe91 1580
a28d4396
KH
1581 /* Rewind back to the position where we can safely search
1582 forward for compositions. It is assured that the character
1583 at cur.pos is composable. */
1584 while (head < cur.pos)
1585 {
1586 prev = cur;
1587 BACKWARD_CHAR (cur, stop);
1588 c = STRING_CHAR (cur.p);
1589 if (! CHAR_COMPOSABLE_P (c))
90b3fe91 1590 {
a28d4396
KH
1591 cur = prev;
1592 break;
90b3fe91 1593 }
a28d4396
KH
1594 }
1595
1596 search_forward:
1597 /* Now search forward. */
1598 *gstring = Qnil;
1599 prev = cur; /* remember the start of searching position. */
1600 while (cur.pos < fore_check_limit)
1601 {
1602 Lisp_Object val;
1603
1604 c = STRING_CHAR (cur.p);
1605 for (val = CHAR_TABLE_REF (Vcomposition_function_table, c);
1606 CONSP (val); val = XCDR (val))
90b3fe91 1607 {
a28d4396
KH
1608 Lisp_Object elt = XCAR (val);
1609
1610 if (VECTORP (elt) && ASIZE (elt) == 3 && NATNUMP (AREF (elt, 1)))
90b3fe91 1611 {
a28d4396
KH
1612 EMACS_INT check_pos = cur.pos - XFASTINT (AREF (elt, 1));
1613 struct position_record check;
1614
1615 if (check_pos < head
1616 || (limit <= pos ? pos < check_pos
1617 : limit <= check_pos))
1618 continue;
1619 for (check = cur; check_pos < check.pos; )
1620 BACKWARD_CHAR (check, stop);
1621 *gstring = autocmp_chars (elt, check.pos, check.pos_byte,
1622 tail, w, NULL, string);
90b3fe91 1623 need_adjustment = 1;
a28d4396 1624 if (NILP (*gstring))
90b3fe91 1625 {
a28d4396
KH
1626 /* As we have called Lisp, there's a possibility
1627 that buffer/string is relocated. */
1628 if (NILP (string))
1629 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1630 else
1631 cur.p = SDATA (string) + cur.pos_byte;
1632 }
1633 else
1634 {
1635 /* We found a candidate of a target composition. */
90b3fe91
KH
1636 *start = check.pos;
1637 *end = check.pos + LGSTRING_CHAR_LEN (*gstring);
a28d4396
KH
1638 if (pos < limit
1639 ? pos < *end
1640 : *start <= pos && pos < *end)
1641 /* This is the target composition. */
90b3fe91
KH
1642 return 1;
1643 cur.pos = *end;
a28d4396
KH
1644 if (NILP (string))
1645 {
1646 cur.pos_byte = CHAR_TO_BYTE (cur.pos);
1647 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1648 }
1649 else
1650 {
1651 cur.pos_byte = string_char_to_byte (string, cur.pos);
1652 cur.p = SDATA (string) + cur.pos_byte;
1653 }
90b3fe91
KH
1654 break;
1655 }
1656 }
1657 }
a28d4396
KH
1658 if (! CONSP (val))
1659 /* We found no composition here. */
90b3fe91 1660 FORWARD_CHAR (cur, stop);
90b3fe91 1661 }
a28d4396
KH
1662
1663 if (pos < limit) /* case (2) and (4)*/
1664 return 0;
1665 if (! NILP (*gstring))
1666 return 1;
1667 if (prev.pos == head)
1668 return 0;
90b3fe91 1669 cur = prev;
a28d4396
KH
1670 if (need_adjustment)
1671 {
1672 if (NILP (string))
1673 cur.p = BYTE_POS_ADDR (cur.pos_byte);
1674 else
1675 cur.p = SDATA (string) + cur.pos_byte;
1676 }
90b3fe91 1677 BACKWARD_CHAR (cur, stop);
90b3fe91
KH
1678 }
1679 return 0;
1680}
1681
e614ea00
KH
1682/* Return the adjusted point provided that point is moved from LAST_PT
1683 to NEW_PT. */
1684
41118bd3 1685EMACS_INT
971de7fb 1686composition_adjust_point (EMACS_INT last_pt, EMACS_INT new_pt)
58753d74 1687{
b246f932 1688 EMACS_INT beg, end;
90b3fe91
KH
1689 Lisp_Object val;
1690 int i;
58753d74 1691
e614ea00
KH
1692 if (new_pt == BEGV || new_pt == ZV)
1693 return new_pt;
58753d74 1694
90b3fe91 1695 /* At first check the static composition. */
e614ea00 1696 if (get_property_and_range (new_pt, Qcomposition, &val, &beg, &end, Qnil)
895416e3
KH
1697 && COMPOSITION_VALID_P (beg, end, val))
1698 {
e614ea00 1699 if (beg < new_pt /* && end > new_pt <- It's always the case. */
895416e3 1700 && (last_pt <= beg || last_pt >= end))
e614ea00
KH
1701 return (new_pt < last_pt ? beg : end);
1702 return new_pt;
895416e3 1703 }
58753d74 1704
4b4deea2 1705 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
d9a7c140 1706 || NILP (Vauto_composition_mode))
e614ea00 1707 return new_pt;
58753d74 1708
90b3fe91 1709 /* Next check the automatic composition. */
e614ea00
KH
1710 if (! find_automatic_composition (new_pt, (EMACS_INT) -1, &beg, &end, &val,
1711 Qnil)
1712 || beg == new_pt)
1713 return new_pt;
90b3fe91 1714 for (i = 0; i < LGSTRING_GLYPH_LEN (val); i++)
58753d74 1715 {
90b3fe91 1716 Lisp_Object glyph = LGSTRING_GLYPH (val, i);
58753d74 1717
90b3fe91
KH
1718 if (NILP (glyph))
1719 break;
e614ea00
KH
1720 if (beg + LGLYPH_FROM (glyph) == new_pt)
1721 return new_pt;
1722 if (beg + LGLYPH_TO (glyph) >= new_pt)
1723 return (new_pt < last_pt
90b3fe91
KH
1724 ? beg + LGLYPH_FROM (glyph)
1725 : beg + LGLYPH_TO (glyph) + 1);
58753d74 1726 }
e614ea00 1727 return new_pt;
58753d74
KH
1728}
1729
1730DEFUN ("composition-get-gstring", Fcomposition_get_gstring,
1731 Scomposition_get_gstring, 4, 4, 0,
1732 doc: /* Return a glyph-string for characters between FROM and TO.
9d751859 1733If the glyph string is for graphic display, FONT-OBJECT must be
58753d74 1734a font-object to use for those characters.
f5199465
KH
1735Otherwise (for terminal display), FONT-OBJECT must be a terminal ID, a
1736frame, or nil for the selected frame's terminal device.
58753d74
KH
1737
1738If the optional 4th argument STRING is not nil, it is a string
1739containing the target characters between indices FROM and TO.
1740
9d751859
EZ
1741A glyph-string is a vector containing information about how to display
1742a specific character sequence. The format is:
58753d74
KH
1743 [HEADER ID GLYPH ...]
1744
1745HEADER is a vector of this form:
1746 [FONT-OBJECT CHAR ...]
1747where
1748 FONT-OBJECT is a font-object for all glyphs in the glyph-string,
f5199465 1749 or the terminal coding system of the specified terminal.
58753d74
KH
1750 CHARs are characters to be composed by GLYPHs.
1751
1752ID is an identification number of the glyph-string. It may be nil if
1753not yet shaped.
1754
9d751859 1755GLYPH is a vector whose elements have this form:
58753d74
KH
1756 [ FROM-IDX TO-IDX C CODE WIDTH LBEARING RBEARING ASCENT DESCENT
1757 [ [X-OFF Y-OFF WADJUST] | nil] ]
1758where
1759 FROM-IDX and TO-IDX are used internally and should not be touched.
1760 C is the character of the glyph.
1761 CODE is the glyph-code of C in FONT-OBJECT.
1762 WIDTH thru DESCENT are the metrics (in pixels) of the glyph.
9d751859 1763 X-OFF and Y-OFF are offsets to the base position for the glyph.
58753d74
KH
1764 WADJUST is the adjustment to the normal width of the glyph.
1765
9d751859
EZ
1766If GLYPH is nil, the remaining elements of the glyph-string vector
1767should be ignored. */)
5842a27b 1768 (Lisp_Object from, Lisp_Object to, Lisp_Object font_object, Lisp_Object string)
58753d74
KH
1769{
1770 Lisp_Object gstring, header;
46f905e1 1771 EMACS_INT frompos, topos;
58753d74 1772
ea8ba975
KH
1773 CHECK_NATNUM (from);
1774 CHECK_NATNUM (to);
f5199465
KH
1775 if (! FONT_OBJECT_P (font_object))
1776 {
1777 struct coding_system *coding;
1778 struct terminal *terminal = get_terminal (font_object, 1);
1779
1780 coding = ((TERMINAL_TERMINAL_CODING (terminal)->common_flags
1781 & CODING_REQUIRE_ENCODING_MASK)
1782 ? TERMINAL_TERMINAL_CODING (terminal) : &safe_terminal_coding);
1783 font_object = CODING_ID_NAME (coding->id);
1784 }
1785
58753d74
KH
1786 header = fill_gstring_header (Qnil, from, to, font_object, string);
1787 gstring = gstring_lookup_cache (header);
1788 if (! NILP (gstring))
1789 return gstring;
46f905e1 1790
ea8ba975
KH
1791 frompos = XINT (from);
1792 topos = XINT (to);
46f905e1
SM
1793 if (LGSTRING_GLYPH_LEN (gstring_work) < topos - frompos)
1794 gstring_work = Fmake_vector (make_number (topos - frompos + 2), Qnil);
58753d74
KH
1795 LGSTRING_SET_HEADER (gstring_work, header);
1796 LGSTRING_SET_ID (gstring_work, Qnil);
1797 fill_gstring_body (gstring_work);
1798 return gstring_work;
1799}
1800
ca4c9455
KH
1801\f
1802/* Emacs Lisp APIs. */
1803
1804DEFUN ("compose-region-internal", Fcompose_region_internal,
1805 Scompose_region_internal, 2, 4, 0,
335c5470
PJ
1806 doc: /* Internal use only.
1807
1808Compose text in the region between START and END.
1809Optional 3rd and 4th arguments are COMPONENTS and MODIFICATION-FUNC
9d751859 1810for the composition. See `compose-region' for more details. */)
5842a27b 1811 (Lisp_Object start, Lisp_Object end, Lisp_Object components, Lisp_Object modification_func)
ca4c9455
KH
1812{
1813 validate_region (&start, &end);
1814 if (!NILP (components)
1815 && !INTEGERP (components)
1816 && !CONSP (components)
1817 && !STRINGP (components))
b7826503 1818 CHECK_VECTOR (components);
ca4c9455 1819
d562f8ab 1820 compose_text (XINT (start), XINT (end), components, modification_func, Qnil);
ca4c9455
KH
1821 return Qnil;
1822}
1823
1824DEFUN ("compose-string-internal", Fcompose_string_internal,
1825 Scompose_string_internal, 3, 5, 0,
335c5470
PJ
1826 doc: /* Internal use only.
1827
1828Compose text between indices START and END of STRING.
1829Optional 4th and 5th arguments are COMPONENTS and MODIFICATION-FUNC
9d751859 1830for the composition. See `compose-string' for more details. */)
5842a27b 1831 (Lisp_Object string, Lisp_Object start, Lisp_Object end, Lisp_Object components, Lisp_Object modification_func)
ca4c9455 1832{
b7826503
PJ
1833 CHECK_STRING (string);
1834 CHECK_NUMBER (start);
1835 CHECK_NUMBER (end);
ca4c9455
KH
1836
1837 if (XINT (start) < 0 ||
1838 XINT (start) > XINT (end)
d5db4077 1839 || XINT (end) > SCHARS (string))
ca4c9455
KH
1840 args_out_of_range (start, end);
1841
d562f8ab 1842 compose_text (XINT (start), XINT (end), components, modification_func, string);
ca4c9455
KH
1843 return string;
1844}
1845
1846DEFUN ("find-composition-internal", Ffind_composition_internal,
177c0ea7 1847 Sfind_composition_internal, 4, 4, 0,
335c5470
PJ
1848 doc: /* Internal use only.
1849
1850Return information about composition at or nearest to position POS.
9d751859 1851See `find-composition' for more details. */)
5842a27b 1852 (Lisp_Object pos, Lisp_Object limit, Lisp_Object string, Lisp_Object detail_p)
ca4c9455 1853{
90b3fe91
KH
1854 Lisp_Object prop, tail, gstring;
1855 EMACS_INT start, end, from, to;
ca4c9455
KH
1856 int id;
1857
b7826503 1858 CHECK_NUMBER_COERCE_MARKER (pos);
90b3fe91 1859 from = XINT (pos);
ca4c9455
KH
1860 if (!NILP (limit))
1861 {
b7826503 1862 CHECK_NUMBER_COERCE_MARKER (limit);
90b3fe91 1863 to = XINT (limit);
ca4c9455
KH
1864 }
1865 else
90b3fe91 1866 to = -1;
177c0ea7 1867
ca4c9455 1868 if (!NILP (string))
e3b3e327 1869 {
b7826503 1870 CHECK_STRING (string);
d5db4077 1871 if (XINT (pos) < 0 || XINT (pos) > SCHARS (string))
e3b3e327
GM
1872 args_out_of_range (string, pos);
1873 }
1874 else
1875 {
fa9090b8 1876 if (XINT (pos) < BEGV || XINT (pos) > ZV)
e3b3e327
GM
1877 args_out_of_range (Fcurrent_buffer (), pos);
1878 }
ca4c9455 1879
90b3fe91
KH
1880 if (!find_composition (from, to, &start, &end, &prop, string))
1881 {
4b4deea2 1882 if (!NILP (BVAR (current_buffer, enable_multibyte_characters))
d9a7c140 1883 && ! NILP (Vauto_composition_mode)
90b3fe91
KH
1884 && find_automatic_composition (from, to, &start, &end, &gstring,
1885 string))
1886 return list3 (make_number (start), make_number (end), gstring);
1887 return Qnil;
1888 }
1889 if ((end <= XINT (pos) || start > XINT (pos)))
1890 {
1891 EMACS_INT s, e;
1892
1893 if (find_automatic_composition (from, to, &s, &e, &gstring, string)
1894 && (e <= XINT (pos) ? e > end : s < start))
fcebfc6a 1895 return list3 (make_number (s), make_number (e), gstring);
90b3fe91 1896 }
ca4c9455
KH
1897 if (!COMPOSITION_VALID_P (start, end, prop))
1898 return Fcons (make_number (start), Fcons (make_number (end),
1899 Fcons (Qnil, Qnil)));
1900 if (NILP (detail_p))
1901 return Fcons (make_number (start), Fcons (make_number (end),
1902 Fcons (Qt, Qnil)));
1903
1904 if (COMPOSITION_REGISTERD_P (prop))
1905 id = COMPOSITION_ID (prop);
1906 else
1907 {
579c18d0
EZ
1908 EMACS_INT start_byte = (NILP (string)
1909 ? CHAR_TO_BYTE (start)
1910 : string_char_to_byte (string, start));
ca4c9455
KH
1911 id = get_composition_id (start, start_byte, end - start, prop, string);
1912 }
1913
1914 if (id >= 0)
1915 {
1916 Lisp_Object components, relative_p, mod_func;
1917 enum composition_method method = COMPOSITION_METHOD (prop);
1918 int width = composition_table[id]->width;
1919
1920 components = Fcopy_sequence (COMPOSITION_COMPONENTS (prop));
1921 relative_p = (method == COMPOSITION_WITH_RULE_ALTCHARS
1922 ? Qnil : Qt);
1923 mod_func = COMPOSITION_MODIFICATION_FUNC (prop);
1924 tail = Fcons (components,
1925 Fcons (relative_p,
1926 Fcons (mod_func,
1927 Fcons (make_number (width), Qnil))));
1928 }
1929 else
1930 tail = Qnil;
1931
1932 return Fcons (make_number (start), Fcons (make_number (end), tail));
1933}
1934
1935\f
1936void
971de7fb 1937syms_of_composite (void)
ca4c9455 1938{
58753d74
KH
1939 int i;
1940
d67b4f80 1941 Qcomposition = intern_c_string ("composition");
ca4c9455
KH
1942 staticpro (&Qcomposition);
1943
58753d74 1944 /* Make a hash table for static composition. */
ca4c9455 1945 {
09654086 1946 Lisp_Object args[6];
177c0ea7 1947
ca4c9455
KH
1948 args[0] = QCtest;
1949 args[1] = Qequal;
1950 args[2] = QCweakness;
dc47eccc 1951 /* We used to make the hash table weak so that unreferenced
ca101cff 1952 compositions can be garbage-collected. But, usually once
dc47eccc
KH
1953 created compositions are repeatedly used in an Emacs session,
1954 and thus it's not worth to save memory in such a way. So, we
1955 make the table not weak. */
6a83ee8a 1956 args[3] = Qnil;
ca4c9455
KH
1957 args[4] = QCsize;
1958 args[5] = make_number (311);
09654086 1959 composition_hash_table = Fmake_hash_table (6, args);
ca4c9455
KH
1960 staticpro (&composition_hash_table);
1961 }
1962
58753d74
KH
1963 /* Make a hash table for glyph-string. */
1964 {
1965 Lisp_Object args[6];
58753d74
KH
1966 args[0] = QCtest;
1967 args[1] = Qequal;
1968 args[2] = QCweakness;
1969 args[3] = Qnil;
1970 args[4] = QCsize;
1971 args[5] = make_number (311);
1972 gstring_hash_table = Fmake_hash_table (6, args);
1973 staticpro (&gstring_hash_table);
1974 }
1975
1976 staticpro (&gstring_work_headers);
1977 gstring_work_headers = Fmake_vector (make_number (8), Qnil);
1978 for (i = 0; i < 8; i++)
1979 ASET (gstring_work_headers, i, Fmake_vector (make_number (i + 2), Qnil));
1980 staticpro (&gstring_work);
1981 gstring_work = Fmake_vector (make_number (10), Qnil);
1982
ca4c9455
KH
1983 /* Text property `composition' should be nonsticky by default. */
1984 Vtext_property_default_nonsticky
1985 = Fcons (Fcons (Qcomposition, Qt), Vtext_property_default_nonsticky);
1986
29208e82 1987 DEFVAR_LISP ("compose-chars-after-function", Vcompose_chars_after_function,
335c5470
PJ
1988 doc: /* Function to adjust composition of buffer text.
1989
9d751859
EZ
1990This function is called with three arguments: FROM, TO, and OBJECT.
1991FROM and TO specify the range of text whose composition should be
335c5470
PJ
1992adjusted. OBJECT, if non-nil, is a string that contains the text.
1993
1994This function is called after a text with `composition' property is
1995inserted or deleted to keep `composition' property of buffer text
1996valid.
1997
1998The default value is the function `compose-chars-after'. */);
d67b4f80 1999 Vcompose_chars_after_function = intern_c_string ("compose-chars-after");
ca4c9455 2000
d67b4f80 2001 Qauto_composed = intern_c_string ("auto-composed");
f96ba4c1 2002 staticpro (&Qauto_composed);
40add26d 2003
d67b4f80 2004 Qauto_composition_function = intern_c_string ("auto-composition-function");
f96ba4c1 2005 staticpro (&Qauto_composition_function);
40add26d 2006
29208e82 2007 DEFVAR_LISP ("auto-composition-mode", Vauto_composition_mode,
d9a7c140
KH
2008 doc: /* Non-nil if Auto-Composition mode is enabled.
2009Use the command `auto-composition-mode' to change this variable. */);
2010 Vauto_composition_mode = Qt;
2011
29208e82 2012 DEFVAR_LISP ("auto-composition-function", Vauto_composition_function,
f96ba4c1 2013 doc: /* Function to call to compose characters automatically.
9d751859 2014This function is called from the display routine with four arguments:
ddc872ba 2015FROM, TO, WINDOW, and STRING.
335c5470 2016
ddc872ba
KH
2017If STRING is nil, the function must compose characters in the region
2018between FROM and TO in the current buffer.
335c5470 2019
ddc872ba
KH
2020Otherwise, STRING is a string, and FROM and TO are indices into the
2021string. In this case, the function must compose characters in the
2022string. */);
f96ba4c1 2023 Vauto_composition_function = Qnil;
40add26d 2024
29208e82 2025 DEFVAR_LISP ("composition-function-table", Vcomposition_function_table,
9d751859 2026 doc: /* Char-table of functions for automatic character composition.
58753d74
KH
2027For each character that has to be composed automatically with
2028preceding and/or following characters, this char-table contains
2029a function to call to compose that character.
2030
2031The element at index C in the table, if non-nil, is a list of
10f72a37 2032composition rules of this form: ([PATTERN PREV-CHARS FUNC] ...)
58753d74 2033
9d751859 2034PATTERN is a regular expression which C and the surrounding
58753d74
KH
2035characters must match.
2036
895416e3
KH
2037PREV-CHARS is a non-negative integer (less than 4) specifying how many
2038characters before C to check the matching with PATTERN. If it is 0,
2039PATTERN must match C and the following characters. If it is 1,
2040PATTERN must match a character before C and the following characters.
58753d74
KH
2041
2042If PREV-CHARS is 0, PATTERN can be nil, which means that the
2043single character C should be composed.
2044
2045FUNC is a function to return a glyph-string representing a
9d751859 2046composition of the characters that match PATTERN. It is
58753d74
KH
2047called with one argument GSTRING.
2048
2049GSTRING is a template of a glyph-string to return. It is already
2050filled with a proper header for the characters to compose, and
2051glyphs corresponding to those characters one by one. The
9d751859 2052function must return a new glyph-string with the same header as
58753d74
KH
2053GSTRING, or modify GSTRING itself and return it.
2054
2055See also the documentation of `auto-composition-mode'. */);
2056 Vcomposition_function_table = Fmake_char_table (Qnil, Qnil);
2057
ca4c9455
KH
2058 defsubr (&Scompose_region_internal);
2059 defsubr (&Scompose_string_internal);
2060 defsubr (&Sfind_composition_internal);
58753d74 2061 defsubr (&Scomposition_get_gstring);
ca4c9455 2062}