1 /* Header for composite sequence handler.
2 Copyright (C) 2001, 2002, 2003, 2004, 2005,
3 2006 Free Software Foundation, Inc.
5 National Institute of Advanced Industrial Science and Technology (AIST)
6 Registration Number H14PRO021
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 2, or (at your option)
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; see the file COPYING. If not, write to
25 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
26 Boston, MA 02110-1301, USA. */
28 #ifndef EMACS_COMPOSITE_H
29 #define EMACS_COMPOSITE_H
31 /* Methods to display a sequence of components a composition. */
32 enum composition_method
{
33 /* Compose relatively without alternate characters. */
35 /* Compose by specified composition rules. This is not used in
36 Emacs 21 but we need it to decode files saved in the older
38 COMPOSITION_WITH_RULE
,
39 /* Compose relatively with alternate characters. */
40 COMPOSITION_WITH_ALTCHARS
,
41 /* Compose by specified composition rules with alternate characters. */
42 COMPOSITION_WITH_RULE_ALTCHARS
,
43 /* This is not a method. */
47 /* Maximum number of compoments a single composition can have. */
48 #define MAX_COMPOSITION_COMPONENTS 16
50 /* These macros access information about a composition that
51 has `composition' property PROP. PROP is:
52 ((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
54 (COMPOSITION-ID . (LENGTH COMPONENTS . MODIFICATION-FUNC))
55 They don't check validity of PROP. */
57 /* Temporary variable used only in the following macros. */
58 extern Lisp_Object composition_temp
;
60 /* Return 1 iff the composition is already registered. */
61 #define COMPOSITION_REGISTERD_P(prop) INTEGERP (XCAR (prop))
63 /* Return ID number of the already registered composition. */
64 #define COMPOSITION_ID(prop) XINT (XCAR (prop))
66 /* Return length of the composition. */
67 #define COMPOSITION_LENGTH(prop) \
68 (COMPOSITION_REGISTERD_P (prop) \
69 ? XINT (XCAR (XCDR (prop))) \
70 : XINT (XCAR (XCAR (prop))))
72 /* Return components of the composition. */
73 #define COMPOSITION_COMPONENTS(prop) \
74 (COMPOSITION_REGISTERD_P (prop) \
75 ? XCAR (XCDR (XCDR (prop))) \
78 /* Return modification function of the composition. */
79 #define COMPOSITION_MODIFICATION_FUNC(prop) \
80 (COMPOSITION_REGISTERD_P (prop) \
81 ? XCDR (XCDR (XCDR (prop))) \
82 : CONSP (prop) ? XCDR (prop) : Qnil)
84 /* Return the method of composition. */
85 #define COMPOSITION_METHOD(prop) \
86 (COMPOSITION_REGISTERD_P (prop) \
87 ? composition_table[COMPOSITION_ID (prop)]->method \
88 : (composition_temp = XCDR (XCAR (prop)), \
89 (NILP (composition_temp) \
90 ? COMPOSITION_RELATIVE \
91 : ((INTEGERP (composition_temp) || STRINGP (composition_temp)) \
92 ? COMPOSITION_WITH_ALTCHARS \
93 : COMPOSITION_WITH_RULE_ALTCHARS))))
95 /* Return 1 iff the composition is valid. It is valid if length of
96 the composition equals to (END - START). */
97 #define COMPOSITION_VALID_P(start, end, prop) \
99 && (COMPOSITION_REGISTERD_P (prop) \
100 ? (COMPOSITION_ID (prop) >= 0 \
101 && COMPOSITION_ID (prop) <= n_compositions \
102 && CONSP (XCDR (prop))) \
103 : (composition_temp = XCAR (prop), \
104 (CONSP (composition_temp) \
105 && (composition_temp = XCDR (composition_temp), \
106 (NILP (composition_temp) \
107 || STRINGP (composition_temp) \
108 || VECTORP (composition_temp) \
109 || INTEGERP (composition_temp) \
110 || CONSP (composition_temp)))))) \
111 && (end - start) == COMPOSITION_LENGTH (prop))
113 /* Return the Nth glyph of composition specified by CMP. CMP is a
114 pointer to `struct composition'. */
115 #define COMPOSITION_GLYPH(cmp, n) \
116 XINT (XVECTOR (XVECTOR (XHASH_TABLE (composition_hash_table) \
118 ->contents[cmp->hash_index * 2]) \
119 ->contents[cmp->method == COMPOSITION_WITH_RULE_ALTCHARS \
122 /* Return the encoded composition rule to compose the Nth glyph of
123 rule-base composition specified by CMP. CMP is a pointer to
124 `struct composition'. */
125 #define COMPOSITION_RULE(cmp, n) \
126 XINT (XVECTOR (XVECTOR (XHASH_TABLE (composition_hash_table) \
128 ->contents[cmp->hash_index * 2]) \
129 ->contents[(n) * 2 - 1])
131 /* Decode encoded composition rule RULE_CODE into GREF (global
132 reference point code), NREF (new reference point code), XOFF
133 (horizontal offset) YOFF (vertical offset). Don't check RULE_CODE,
134 always set GREF and NREF to valid values. By side effect,
135 RULE_CODE is modified. */
137 #define COMPOSITION_DECODE_RULE(rule_code, gref, nref, xoff, yoff) \
139 xoff = (rule_code) >> 16; \
140 yoff = ((rule_code) >> 8) & 0xFF; \
142 gref = (rule_code) / 12; \
143 if (gref > 12) gref = 11; \
144 nref = (rule_code) % 12; \
147 /* Return encoded composition rule for the pair of global reference
148 point GREF and new reference point NREF. If arguments are invalid,
150 #define COMPOSITION_ENCODE_RULE(gref, nref) \
151 ((unsigned) (gref) < 12 && (unsigned) (nref) < 12 \
152 ? (gref) * 12 + (nref) : -1)
154 /* Data structure that records information about a composition
155 currently used in some buffers or strings.
157 When a composition is assigned an ID number (by
158 get_composition_id), this structure is allocated for the
159 composition and linked in composition_table[ID].
161 Identical compositions appearing at different places have the same
162 ID, and thus share the same instance of this structure. */
165 /* Number of glyphs of the composition components. */
168 /* Width, ascent, and descent pixels of the composition. */
169 short pixel_width
, ascent
, descent
;
171 short lbearing
, rbearing
;
173 /* How many columns the overall glyphs occupy on the screen. This
174 gives an approximate value for column calculation in
175 Fcurrent_column, and etc. */
176 unsigned short width
;
178 /* Method of the composition. */
179 enum composition_method method
;
181 /* Index to the composition hash table. */
184 /* For which font we have calculated the remaining members. The
185 actual type is device dependent. */
188 /* Pointer to an array of x-offset and y-offset (by pixels) of
189 glyphs. This points to a sufficient memory space (sizeof (int) *
190 glyph_len * 2) that is allocated when the composition is
191 registered in composition_table. X-offset and Y-offset of Nth
192 glyph are (2N)th and (2N+1)th elements respectively. */
196 /* Table of pointers to the structure `composition' indexed by
198 extern struct composition
**composition_table
;
199 /* Number of the currently registered compositions. */
200 extern int n_compositions
;
202 /* Mask bits for CHECK_MASK arg to update_compositions.
203 For a change in the region FROM and TO, check compositions ... */
204 #define CHECK_HEAD 1 /* adjacent to FROM */
205 #define CHECK_TAIL 2 /* adjacent to TO */
206 #define CHECK_INSIDE 4 /* between FROM and TO */
207 #define CHECK_BORDER (CHECK_HEAD | CHECK_TAIL)
208 #define CHECK_ALL (CHECK_BORDER | CHECK_INSIDE)
210 extern Lisp_Object Qcomposition
;
211 extern Lisp_Object composition_hash_table
;
212 extern Lisp_Object Qauto_composed
;
213 extern Lisp_Object Vauto_composition_function
;
214 extern Lisp_Object Qauto_composition_function
;
216 extern int get_composition_id
P_ ((int, int, int, Lisp_Object
, Lisp_Object
));
217 extern int find_composition
P_ ((int, int, EMACS_INT
*, EMACS_INT
*, Lisp_Object
*,
219 extern void update_compositions
P_ ((EMACS_INT
, EMACS_INT
, int));
220 extern void make_composition_value_copy
P_ ((Lisp_Object
));
221 extern void compose_region
P_ ((int, int, Lisp_Object
, Lisp_Object
,
223 extern void syms_of_composite
P_ ((void));
224 extern void compose_text
P_ ((int, int, Lisp_Object
, Lisp_Object
,
227 #endif /* not EMACS_COMPOSITE_H */
229 /* arch-tag: 59524d89-c645-47bd-b5e6-65e861690118
230 (do not change this comment) */