[bpt/emacs.git] / src / composite.h

/* Header for composite sequence handler.
   Copyright (C) 2001, 2002, 2003, 2004, 2005,
                 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
   Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
     National Institute of Advanced Industrial Science and Technology (AIST)
     Registration Number H14PRO021
   Copyright (C) 2003, 2006
     National Institute of Advanced Industrial Science and Technology (AIST)
     Registration Number H13PRO009

This file is part of GNU Emacs.

GNU Emacs is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */

#ifndef EMACS_COMPOSITE_H
#define EMACS_COMPOSITE_H

/* Methods to display a sequence of components of a composition.  */
enum composition_method {
  /* Compose relatively without alternate characters.  */
  COMPOSITION_RELATIVE,
  /* Compose by specified composition rules.  This is not used in
     Emacs 21 but we need it to decode files saved in the older
     versions of Emacs.  */
  COMPOSITION_WITH_RULE,
  /* Compose relatively with alternate characters.  */
  COMPOSITION_WITH_ALTCHARS,
  /* Compose by specified composition rules with alternate characters.  */
  COMPOSITION_WITH_RULE_ALTCHARS,
  /* This is not a method.  */
  COMPOSITION_NO
};

/* Maximum number of compoments a single composition can have.  */
#define MAX_COMPOSITION_COMPONENTS 16

/* These macros access information about a composition that
   has `composition' property PROP.  PROP is:
	((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
   or
	(COMPOSITION-ID . (LENGTH COMPONENTS . MODIFICATION-FUNC))
   They don't check validity of PROP.  */

/* Temporary variable used only in the following macros.  */
extern Lisp_Object composition_temp;

/* Return 1 if the composition is already registered.  */
#define COMPOSITION_REGISTERD_P(prop) INTEGERP (XCAR (prop))

/* Return ID number of the already registered composition.  */
#define COMPOSITION_ID(prop) XINT (XCAR (prop))

/* Return length of the composition.  */
#define COMPOSITION_LENGTH(prop)	\
  (COMPOSITION_REGISTERD_P (prop)	\
   ? XINT (XCAR (XCDR (prop)))		\
   : XINT (XCAR (XCAR (prop))))

/* Return components of the composition.  */
#define COMPOSITION_COMPONENTS(prop)	\
  (COMPOSITION_REGISTERD_P (prop)	\
   ? XCAR (XCDR (XCDR (prop)))		\
   : XCDR (XCAR (prop)))

/* Return modification function of the composition.  */
#define COMPOSITION_MODIFICATION_FUNC(prop)	\
  (COMPOSITION_REGISTERD_P (prop)		\
   ? XCDR (XCDR (XCDR (prop)))			\
   : CONSP (prop) ? XCDR (prop) : Qnil)

/* Return the method of composition.  */
#define COMPOSITION_METHOD(prop)					\
  (COMPOSITION_REGISTERD_P (prop)					\
   ? composition_table[COMPOSITION_ID (prop)]->method			\
   : (composition_temp = XCDR (XCAR (prop)),				\
      (NILP (composition_temp)						\
       ? COMPOSITION_RELATIVE						\
       : (INTEGERP (composition_temp) || STRINGP (composition_temp))	\
       ? COMPOSITION_WITH_ALTCHARS					\
       : COMPOSITION_WITH_RULE_ALTCHARS)))

/* Return 1 if the composition is valid.  It is valid if length of
   the composition equals to (END - START).  */
#define COMPOSITION_VALID_P(start, end, prop)			\
  (CONSP (prop)							\
   && (COMPOSITION_REGISTERD_P (prop)				\
       ? (COMPOSITION_ID (prop) >= 0				\
	  && COMPOSITION_ID (prop) <= n_compositions		\
	  && CONSP (XCDR (prop)))				\
       : (composition_temp = XCAR (prop),			\
	  (CONSP (composition_temp)				\
	   && (composition_temp = XCDR (composition_temp),	\
	       (NILP (composition_temp)				\
		|| STRINGP (composition_temp)			\
		|| VECTORP (composition_temp)			\
		|| INTEGERP (composition_temp)			\
		|| CONSP (composition_temp))))))		\
   && (end - start) == COMPOSITION_LENGTH (prop))

/* Return the Nth glyph of composition specified by CMP.  CMP is a
   pointer to `struct composition'. */
#define COMPOSITION_GLYPH(cmp, n)					\
  XINT (XVECTOR (XVECTOR (XHASH_TABLE (composition_hash_table)		\
			  ->key_and_value)				\
		 ->contents[cmp->hash_index * 2])			\
	->contents[cmp->method == COMPOSITION_WITH_RULE_ALTCHARS	\
		  ? (n) * 2 : (n)])

/* Return the encoded composition rule to compose the Nth glyph of
   rule-base composition specified by CMP.  CMP is a pointer to
   `struct composition'. */
#define COMPOSITION_RULE(cmp, n)				\
  XINT (XVECTOR (XVECTOR (XHASH_TABLE (composition_hash_table)	\
			  ->key_and_value)			\
		 ->contents[cmp->hash_index * 2])		\
	->contents[(n) * 2 - 1])

/* Decode encoded composition rule RULE_CODE into GREF (global
   reference point code), NREF (new reference point code), XOFF
   (horizontal offset) YOFF (vertical offset).  Don't check RULE_CODE,
   always set GREF and NREF to valid values.  By side effect,
   RULE_CODE is modified.  */

#define COMPOSITION_DECODE_RULE(rule_code, gref, nref, xoff, yoff)	\
  do {									\
    xoff = (rule_code) >> 16;						\
    yoff = ((rule_code) >> 8) & 0xFF;					\
    rule_code &= 0xFF;							\
    gref = (rule_code) / 12;						\
    if (gref > 12) gref = 11;						\
    nref = (rule_code) % 12;						\
  } while (0)

/* Return encoded composition rule for the pair of global reference
   point GREF and new reference point NREF.  If arguments are invalid,
   return -1. */
#define COMPOSITION_ENCODE_RULE(gref, nref)		\
  ((unsigned) (gref) < 12 && (unsigned) (nref) < 12	\
   ? (gref) * 12 + (nref) : -1)

/* Data structure that records information about a composition
   currently used in some buffers or strings.

   When a composition is assigned an ID number (by
   get_composition_id), this structure is allocated for the
   composition and linked in composition_table[ID].

   Identical compositions appearing at different places have the same
   ID, and thus share the same instance of this structure.  */

struct composition {
  /* Number of glyphs of the composition components.  */
  unsigned glyph_len;

  /* Width, ascent, and descent pixels of the composition.  */
  short pixel_width, ascent, descent;

  short lbearing, rbearing;

  /* How many columns the overall glyphs occupy on the screen.  This
     gives an approximate value for column calculation in
     Fcurrent_column, and etc.  */
  unsigned short width;

  /* Method of the composition.  */
  enum composition_method method;

  /* Index to the composition hash table.  */
  int hash_index;

  /* For which font we have calculated the remaining members.  The
     actual type is device dependent.  */
  void *font;

  /* Pointer to an array of x-offset and y-offset (by pixels) of
     glyphs.  This points to a sufficient memory space (sizeof (int) *
     glyph_len * 2) that is allocated when the composition is
     registered in composition_table.  X-offset and Y-offset of Nth
     glyph are (2N)th and (2N+1)th elements respectively.  */
  short *offsets;
};

/* Table of pointers to the structure `composition' indexed by
   COMPOSITION-ID.  */
extern struct composition **composition_table;
/* Number of the currently registered compositions.  */
extern int n_compositions;

/* Mask bits for CHECK_MASK arg to update_compositions.
   For a change in the region FROM and TO, check compositions ... */
#define CHECK_HEAD	1	/* adjacent to FROM */
#define CHECK_TAIL	2	/* adjacent to TO */
#define CHECK_INSIDE	4	/* between FROM and TO */
#define CHECK_BORDER	(CHECK_HEAD | CHECK_TAIL)
#define CHECK_ALL	(CHECK_BORDER | CHECK_INSIDE)

extern Lisp_Object Qcomposition;
extern Lisp_Object composition_hash_table;
extern Lisp_Object Qauto_composed;
extern Lisp_Object Vauto_composition_function;
extern Lisp_Object Qauto_composition_function;
extern Lisp_Object Vcomposition_function_table;

extern int get_composition_id (EMACS_INT, EMACS_INT, EMACS_INT,
			       Lisp_Object, Lisp_Object);
extern int find_composition (EMACS_INT, EMACS_INT, EMACS_INT *, EMACS_INT *,
			     Lisp_Object *, Lisp_Object);
extern void update_compositions (EMACS_INT, EMACS_INT, int);
extern void make_composition_value_copy (Lisp_Object);
extern void compose_region (int, int, Lisp_Object, Lisp_Object,
                            Lisp_Object);
extern void syms_of_composite (void);
extern void compose_text (EMACS_INT, EMACS_INT, Lisp_Object, Lisp_Object,
                          Lisp_Object);

/* Macros for lispy glyph-string.  This is completely different from
   struct glyph_string.  */

#define LGSTRING_HEADER(lgs) AREF (lgs, 0)
#define LGSTRING_SET_HEADER(lgs, header) ASET (lgs, 0, header)

#define LGSTRING_FONT(lgs) AREF (LGSTRING_HEADER (lgs), 0)
#define LGSTRING_CHAR(lgs, i) AREF (LGSTRING_HEADER (lgs), (i) + 1)
#define LGSTRING_CHAR_LEN(lgs) (ASIZE (LGSTRING_HEADER (lgs)) - 1)

#define LGSTRING_SET_FONT(lgs, val) ASET (LGSTRING_HEADER (lgs), 0, (val))
#define LGSTRING_SET_CHAR(lgs, i, c) ASET (LGSTRING_HEADER (lgs), (i) + 1, (c))

#define LGSTRING_ID(lgs) AREF (lgs, 1)
#define LGSTRING_SET_ID(lgs, id) ASET (lgs, 1, id)

#define LGSTRING_GLYPH_LEN(lgs) (ASIZE ((lgs)) - 2)
#define LGSTRING_GLYPH(lgs, idx) AREF ((lgs), (idx) + 2)
#define LGSTRING_SET_GLYPH(lgs, idx, val) ASET ((lgs), (idx) + 2, (val))

/* Vector size of Lispy glyph.  */
enum lglyph_indices
  {
    LGLYPH_IX_FROM, LGLYPH_IX_TO,  LGLYPH_IX_CHAR, LGLYPH_IX_CODE,
    LGLYPH_IX_WIDTH, LGLYPH_IX_LBEARING, LGLYPH_IX_RBEARING,
    LGLYPH_IX_ASCENT, LGLYPH_IX_DESCENT, LGLYPH_IX_ADJUSTMENT,
    /* Not an index.  */
    LGLYPH_SIZE
  };

#define LGLYPH_NEW() Fmake_vector (make_number (LGLYPH_SIZE), Qnil)
#define LGLYPH_FROM(g) XINT (AREF ((g), LGLYPH_IX_FROM))
#define LGLYPH_TO(g) XINT (AREF ((g), LGLYPH_IX_TO))
#define LGLYPH_CHAR(g) XINT (AREF ((g), LGLYPH_IX_CHAR))
#define LGLYPH_CODE(g)						\
  (NILP (AREF ((g), LGLYPH_IX_CODE))				\
   ? FONT_INVALID_CODE						\
   : CONSP (AREF ((g), LGLYPH_IX_CODE))				\
   ? ((XFASTINT (XCAR (AREF ((g), LGLYPH_IX_CODE))) << 16)	\
      | (XFASTINT (XCDR (AREF ((g), LGLYPH_IX_CODE)))))		\
   : XFASTINT (AREF ((g), LGLYPH_IX_CODE)))
#define LGLYPH_WIDTH(g) XINT (AREF ((g), LGLYPH_IX_WIDTH))
#define LGLYPH_LBEARING(g) XINT (AREF ((g), LGLYPH_IX_LBEARING))
#define LGLYPH_RBEARING(g) XINT (AREF ((g), LGLYPH_IX_RBEARING))
#define LGLYPH_ASCENT(g) XINT (AREF ((g), LGLYPH_IX_ASCENT))
#define LGLYPH_DESCENT(g) XINT (AREF ((g), LGLYPH_IX_DESCENT))
#define LGLYPH_ADJUSTMENT(g) AREF ((g), LGLYPH_IX_ADJUSTMENT)
#define LGLYPH_SET_FROM(g, val) ASET ((g), LGLYPH_IX_FROM, make_number (val))
#define LGLYPH_SET_TO(g, val) ASET ((g), LGLYPH_IX_TO, make_number (val))
#define LGLYPH_SET_CHAR(g, val) ASET ((g), LGLYPH_IX_CHAR, make_number (val))
/* Callers must assure that VAL is not negative!  */
#define LGLYPH_SET_CODE(g, val)						\
  do {									\
    if (val == FONT_INVALID_CODE)					\
      ASET ((g), LGLYPH_IX_CODE, Qnil);					\
    else if ((EMACS_INT)val > MOST_POSITIVE_FIXNUM)			\
      ASET ((g), LGLYPH_IX_CODE, Fcons (make_number ((val) >> 16),	\
					make_number ((val) & 0xFFFF)));	\
    else								\
      ASET ((g), LGLYPH_IX_CODE, make_number (val));			\
  } while (0)
      
#define LGLYPH_SET_WIDTH(g, val) ASET ((g), LGLYPH_IX_WIDTH, make_number (val))
#define LGLYPH_SET_LBEARING(g, val) ASET ((g), LGLYPH_IX_LBEARING, make_number (val))
#define LGLYPH_SET_RBEARING(g, val) ASET ((g), LGLYPH_IX_RBEARING, make_number (val))
#define LGLYPH_SET_ASCENT(g, val) ASET ((g), LGLYPH_IX_ASCENT, make_number (val))
#define LGLYPH_SET_DESCENT(g, val) ASET ((g), LGLYPH_IX_DESCENT, make_number (val))
#define LGLYPH_SET_ADJUSTMENT(g, val) ASET ((g), LGLYPH_IX_ADJUSTMENT, (val))

#define LGLYPH_XOFF(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
			? XINT (AREF (LGLYPH_ADJUSTMENT (g), 0)) : 0)
#define LGLYPH_YOFF(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
			? XINT (AREF (LGLYPH_ADJUSTMENT (g), 1)) : 0)
#define LGLYPH_WADJUST(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
			   ? XINT (AREF (LGLYPH_ADJUSTMENT (g), 2)) : 0)

struct composition_it;
struct face;
struct font_metrics;

extern Lisp_Object composition_gstring_put_cache (Lisp_Object, int);
extern Lisp_Object composition_gstring_from_id (int);
extern int composition_gstring_p (Lisp_Object);
extern int composition_gstring_width (Lisp_Object, EMACS_INT, EMACS_INT,
                                      struct font_metrics *);

extern void composition_compute_stop_pos (struct composition_it *,
                                          EMACS_INT, EMACS_INT, EMACS_INT,
                                          Lisp_Object);
extern int composition_reseat_it (struct composition_it *,
                                  EMACS_INT, EMACS_INT, EMACS_INT,
                                  struct window *, struct face *,
                                  Lisp_Object);
extern int composition_update_it (struct composition_it *,
                                  EMACS_INT, EMACS_INT, Lisp_Object);

extern EMACS_INT composition_adjust_point (EMACS_INT, EMACS_INT);

EXFUN (Fcomposition_get_gstring, 4);

#endif /* not EMACS_COMPOSITE_H */

/* arch-tag: 59524d89-c645-47bd-b5e6-65e861690118
   (do not change this comment) */
Commit	Line	Data
ca4c9455	1	/* Header for composite sequence handler.
aaef169d	2	Copyright (C) 2001, 2002, 2003, 2004, 2005,
5df4f04c GM	3	2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
5df4f04c GM	4	Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
ce03bf76 KH	5	National Institute of Advanced Industrial Science and Technology (AIST)
ce03bf76 KH	6	Registration Number H14PRO021
028b54a0	7	Copyright (C) 2003, 2006
9f504898 KH	8	National Institute of Advanced Industrial Science and Technology (AIST)
9f504898 KH	9	Registration Number H13PRO009
ca4c9455 KH	10
	11	This file is part of GNU Emacs.
	12
b9b1cc14	13	GNU Emacs is free software: you can redistribute it and/or modify
ca4c9455	14	it under the terms of the GNU General Public License as published by
b9b1cc14 GM	15	the Free Software Foundation, either version 3 of the License, or
b9b1cc14 GM	16	(at your option) any later version.
ca4c9455 KH	17
	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.
	22
	23	You should have received a copy of the GNU General Public License
b9b1cc14	24	along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
ca4c9455	25
15a10ef1 KH	26	#ifndef EMACS_COMPOSITE_H
15a10ef1 KH	27	#define EMACS_COMPOSITE_H
ca4c9455	28
028b54a0	29	/* Methods to display a sequence of components of a composition. */
ca4c9455	30	enum composition_method {
ca4c9455 KH	31	/* Compose relatively without alternate characters. */
ca4c9455 KH	32	COMPOSITION_RELATIVE,
9f504898 KH	33	/* Compose by specified composition rules. This is not used in
	34	Emacs 21 but we need it to decode files saved in the older
	35	versions of Emacs. */
ca4c9455 KH	36	COMPOSITION_WITH_RULE,
	37	/* Compose relatively with alternate characters. */
	38	COMPOSITION_WITH_ALTCHARS,
9f504898 KH	39	/* Compose by specified composition rules with alternate characters. */
	40	COMPOSITION_WITH_RULE_ALTCHARS,
	41	/* This is not a method. */
	42	COMPOSITION_NO
ca4c9455 KH	43	};
	44
	45	/* Maximum number of compoments a single composition can have. */
	46	#define MAX_COMPOSITION_COMPONENTS 16
	47
	48	/* These macros access information about a composition that
	49	has `composition' property PROP. PROP is:
	50	((LENGTH . COMPONENTS) . MODIFICATION-FUNC)
	51	or
	52	(COMPOSITION-ID . (LENGTH COMPONENTS . MODIFICATION-FUNC))
	53	They don't check validity of PROP. */
	54
	55	/* Temporary variable used only in the following macros. */
	56	extern Lisp_Object composition_temp;
	57
e0f24100	58	/* Return 1 if the composition is already registered. */
ca4c9455 KH	59	#define COMPOSITION_REGISTERD_P(prop) INTEGERP (XCAR (prop))
	60
	61	/* Return ID number of the already registered composition. */
	62	#define COMPOSITION_ID(prop) XINT (XCAR (prop))
	63
	64	/* Return length of the composition. */
	65	#define COMPOSITION_LENGTH(prop) \
	66	(COMPOSITION_REGISTERD_P (prop) \
	67	? XINT (XCAR (XCDR (prop))) \
	68	: XINT (XCAR (XCAR (prop))))
	69
	70	/* Return components of the composition. */
	71	#define COMPOSITION_COMPONENTS(prop) \
	72	(COMPOSITION_REGISTERD_P (prop) \
	73	? XCAR (XCDR (XCDR (prop))) \
	74	: XCDR (XCAR (prop)))
	75
	76	/* Return modification function of the composition. */
	77	#define COMPOSITION_MODIFICATION_FUNC(prop) \
	78	(COMPOSITION_REGISTERD_P (prop) \
	79	? XCDR (XCDR (XCDR (prop))) \
c1de6316	80	: CONSP (prop) ? XCDR (prop) : Qnil)
ca4c9455 KH	81
	82	/* Return the method of composition. */
	83	#define COMPOSITION_METHOD(prop) \
	84	(COMPOSITION_REGISTERD_P (prop) \
	85	? composition_table[COMPOSITION_ID (prop)]->method \
	86	: (composition_temp = XCDR (XCAR (prop)), \
	87	(NILP (composition_temp) \
	88	? COMPOSITION_RELATIVE \
48bb1088 KH	89	: (INTEGERP (composition_temp) \|\| STRINGP (composition_temp)) \
48bb1088 KH	90	? COMPOSITION_WITH_ALTCHARS \
48bb1088	91	: COMPOSITION_WITH_RULE_ALTCHARS)))
ca4c9455	92
e0f24100	93	/* Return 1 if the composition is valid. It is valid if length of
ca4c9455	94	the composition equals to (END - START). */
1f36b2fc GM	95	#define COMPOSITION_VALID_P(start, end, prop) \
	96	(CONSP (prop) \
	97	&& (COMPOSITION_REGISTERD_P (prop) \
	98	? (COMPOSITION_ID (prop) >= 0 \
	99	&& COMPOSITION_ID (prop) <= n_compositions \
	100	&& CONSP (XCDR (prop))) \
	101	: (composition_temp = XCAR (prop), \
	102	(CONSP (composition_temp) \
	103	&& (composition_temp = XCDR (composition_temp), \
	104	(NILP (composition_temp) \
	105	\|\| STRINGP (composition_temp) \
	106	\|\| VECTORP (composition_temp) \
	107	\|\| INTEGERP (composition_temp) \
	108	\|\| CONSP (composition_temp)))))) \
ca4c9455 KH	109	&& (end - start) == COMPOSITION_LENGTH (prop))
	110
	111	/* Return the Nth glyph of composition specified by CMP. CMP is a
	112	pointer to `struct composition'. */
	113	#define COMPOSITION_GLYPH(cmp, n) \
	114	XINT (XVECTOR (XVECTOR (XHASH_TABLE (composition_hash_table) \
	115	->key_and_value) \
	116	->contents[cmp->hash_index * 2]) \
	117	->contents[cmp->method == COMPOSITION_WITH_RULE_ALTCHARS \
	118	? (n) * 2 : (n)])
	119
	120	/* Return the encoded composition rule to compose the Nth glyph of
	121	rule-base composition specified by CMP. CMP is a pointer to
	122	`struct composition'. */
	123	#define COMPOSITION_RULE(cmp, n) \
	124	XINT (XVECTOR (XVECTOR (XHASH_TABLE (composition_hash_table) \
	125	->key_and_value) \
	126	->contents[cmp->hash_index * 2]) \
	127	->contents[(n) * 2 - 1])
	128
	129	/* Decode encoded composition rule RULE_CODE into GREF (global
28d0edc7 KH	130	reference point code), NREF (new reference point code), XOFF
	131	(horizontal offset) YOFF (vertical offset). Don't check RULE_CODE,
	132	always set GREF and NREF to valid values. By side effect,
	133	RULE_CODE is modified. */
	134
	135	#define COMPOSITION_DECODE_RULE(rule_code, gref, nref, xoff, yoff) \
	136	do { \
	137	xoff = (rule_code) >> 16; \
	138	yoff = ((rule_code) >> 8) & 0xFF; \
	139	rule_code &= 0xFF; \
	140	gref = (rule_code) / 12; \
	141	if (gref > 12) gref = 11; \
	142	nref = (rule_code) % 12; \
ca4c9455 KH	143	} while (0)
	144
	145	/* Return encoded composition rule for the pair of global reference
	146	point GREF and new reference point NREF. If arguments are invalid,
	147	return -1. */
	148	#define COMPOSITION_ENCODE_RULE(gref, nref) \
	149	((unsigned) (gref) < 12 && (unsigned) (nref) < 12 \
	150	? (gref) * 12 + (nref) : -1)
	151
	152	/* Data structure that records information about a composition
	153	currently used in some buffers or strings.
	154
	155	When a composition is assigned an ID number (by
	156	get_composition_id), this structure is allocated for the
177c0ea7	157	composition and linked in composition_table[ID].
ca4c9455 KH	158
	159	Identical compositions appearing at different places have the same
	160	ID, and thus share the same instance of this structure. */
	161
	162	struct composition {
ca4c9455	163	/* Number of glyphs of the composition components. */
28cd4910	164	unsigned glyph_len;
ca4c9455	165
51e31f7a KH	166	/* Width, ascent, and descent pixels of the composition. */
	167	short pixel_width, ascent, descent;
	168
28d0edc7 KH	169	short lbearing, rbearing;
28d0edc7 KH	170
28cd4910 KH	171	/* How many columns the overall glyphs occupy on the screen. This
	172	gives an approximate value for column calculation in
	173	Fcurrent_column, and etc. */
	174	unsigned short width;
	175
ca4c9455 KH	176	/* Method of the composition. */
	177	enum composition_method method;
	178
	179	/* Index to the composition hash table. */
	180	int hash_index;
	181
	182	/* For which font we have calculated the remaining members. The
	183	actual type is device dependent. */
	184	void *font;
	185
	186	/* Pointer to an array of x-offset and y-offset (by pixels) of
	187	glyphs. This points to a sufficient memory space (sizeof (int) *
	188	glyph_len * 2) that is allocated when the composition is
	189	registered in composition_table. X-offset and Y-offset of Nth
	190	glyph are (2N)th and (2N+1)th elements respectively. */
	191	short *offsets;
ca4c9455 KH	192	};
	193
	194	/* Table of pointers to the structure `composition' indexed by
	195	COMPOSITION-ID. */
	196	extern struct composition **composition_table;
	197	/* Number of the currently registered compositions. */
	198	extern int n_compositions;
	199
	200	/* Mask bits for CHECK_MASK arg to update_compositions.
	201	For a change in the region FROM and TO, check compositions ... */
	202	#define CHECK_HEAD 1 /* adjacent to FROM */
	203	#define CHECK_TAIL 2 /* adjacent to TO */
	204	#define CHECK_INSIDE 4 /* between FROM and TO */
	205	#define CHECK_BORDER (CHECK_HEAD \| CHECK_TAIL)
	206	#define CHECK_ALL (CHECK_BORDER \| CHECK_INSIDE)
	207
	208	extern Lisp_Object Qcomposition;
	209	extern Lisp_Object composition_hash_table;
382a2913 KH	210	extern Lisp_Object Qauto_composed;
	211	extern Lisp_Object Vauto_composition_function;
	212	extern Lisp_Object Qauto_composition_function;
6e8b8329	213	extern Lisp_Object Vcomposition_function_table;
ca4c9455	214
579c18d0 EZ	215	extern int get_composition_id (EMACS_INT, EMACS_INT, EMACS_INT,
	216	Lisp_Object, Lisp_Object);
	217	extern int find_composition (EMACS_INT, EMACS_INT, EMACS_INT , EMACS_INT ,
	218	Lisp_Object *, Lisp_Object);
383e0970 J	219	extern void update_compositions (EMACS_INT, EMACS_INT, int);
	220	extern void make_composition_value_copy (Lisp_Object);
	221	extern void compose_region (int, int, Lisp_Object, Lisp_Object,
	222	Lisp_Object);
	223	extern void syms_of_composite (void);
579c18d0	224	extern void compose_text (EMACS_INT, EMACS_INT, Lisp_Object, Lisp_Object,
383e0970	225	Lisp_Object);
ca4c9455	226
6e8b8329 KH	227	/* Macros for lispy glyph-string. This is completely different from
	228	struct glyph_string. */
	229
	230	#define LGSTRING_HEADER(lgs) AREF (lgs, 0)
	231	#define LGSTRING_SET_HEADER(lgs, header) ASET (lgs, 0, header)
	232
	233	#define LGSTRING_FONT(lgs) AREF (LGSTRING_HEADER (lgs), 0)
	234	#define LGSTRING_CHAR(lgs, i) AREF (LGSTRING_HEADER (lgs), (i) + 1)
	235	#define LGSTRING_CHAR_LEN(lgs) (ASIZE (LGSTRING_HEADER (lgs)) - 1)
	236
	237	#define LGSTRING_SET_FONT(lgs, val) ASET (LGSTRING_HEADER (lgs), 0, (val))
	238	#define LGSTRING_SET_CHAR(lgs, i, c) ASET (LGSTRING_HEADER (lgs), (i) + 1, (c))
	239
	240	#define LGSTRING_ID(lgs) AREF (lgs, 1)
	241	#define LGSTRING_SET_ID(lgs, id) ASET (lgs, 1, id)
	242
	243	#define LGSTRING_GLYPH_LEN(lgs) (ASIZE ((lgs)) - 2)
	244	#define LGSTRING_GLYPH(lgs, idx) AREF ((lgs), (idx) + 2)
	245	#define LGSTRING_SET_GLYPH(lgs, idx, val) ASET ((lgs), (idx) + 2, (val))
	246
	247	/* Vector size of Lispy glyph. */
	248	enum lglyph_indices
	249	{
	250	LGLYPH_IX_FROM, LGLYPH_IX_TO, LGLYPH_IX_CHAR, LGLYPH_IX_CODE,
	251	LGLYPH_IX_WIDTH, LGLYPH_IX_LBEARING, LGLYPH_IX_RBEARING,
	252	LGLYPH_IX_ASCENT, LGLYPH_IX_DESCENT, LGLYPH_IX_ADJUSTMENT,
	253	/* Not an index. */
	254	LGLYPH_SIZE
	255	};
	256
	257	#define LGLYPH_NEW() Fmake_vector (make_number (LGLYPH_SIZE), Qnil)
	258	#define LGLYPH_FROM(g) XINT (AREF ((g), LGLYPH_IX_FROM))
	259	#define LGLYPH_TO(g) XINT (AREF ((g), LGLYPH_IX_TO))
	260	#define LGLYPH_CHAR(g) XINT (AREF ((g), LGLYPH_IX_CHAR))
	261	#define LGLYPH_CODE(g) \
	262	(NILP (AREF ((g), LGLYPH_IX_CODE)) \
	263	? FONT_INVALID_CODE \
	264	: CONSP (AREF ((g), LGLYPH_IX_CODE)) \
	265	? ((XFASTINT (XCAR (AREF ((g), LGLYPH_IX_CODE))) << 16) \
	266	\| (XFASTINT (XCDR (AREF ((g), LGLYPH_IX_CODE))))) \
	267	: XFASTINT (AREF ((g), LGLYPH_IX_CODE)))
	268	#define LGLYPH_WIDTH(g) XINT (AREF ((g), LGLYPH_IX_WIDTH))
	269	#define LGLYPH_LBEARING(g) XINT (AREF ((g), LGLYPH_IX_LBEARING))
	270	#define LGLYPH_RBEARING(g) XINT (AREF ((g), LGLYPH_IX_RBEARING))
	271	#define LGLYPH_ASCENT(g) XINT (AREF ((g), LGLYPH_IX_ASCENT))
	272	#define LGLYPH_DESCENT(g) XINT (AREF ((g), LGLYPH_IX_DESCENT))
	273	#define LGLYPH_ADJUSTMENT(g) AREF ((g), LGLYPH_IX_ADJUSTMENT)
	274	#define LGLYPH_SET_FROM(g, val) ASET ((g), LGLYPH_IX_FROM, make_number (val))
	275	#define LGLYPH_SET_TO(g, val) ASET ((g), LGLYPH_IX_TO, make_number (val))
	276	#define LGLYPH_SET_CHAR(g, val) ASET ((g), LGLYPH_IX_CHAR, make_number (val))
fdcb19ca	277	/* Callers must assure that VAL is not negative! */
6e8b8329 KH	278	#define LGLYPH_SET_CODE(g, val) \
	279	do { \
	280	if (val == FONT_INVALID_CODE) \
	281	ASET ((g), LGLYPH_IX_CODE, Qnil); \
19ac2034	282	else if ((EMACS_INT)val > MOST_POSITIVE_FIXNUM) \
6e8b8329 KH	283	ASET ((g), LGLYPH_IX_CODE, Fcons (make_number ((val) >> 16), \
	284	make_number ((val) & 0xFFFF))); \
	285	else \
	286	ASET ((g), LGLYPH_IX_CODE, make_number (val)); \
	287	} while (0)
	288
	289	#define LGLYPH_SET_WIDTH(g, val) ASET ((g), LGLYPH_IX_WIDTH, make_number (val))
	290	#define LGLYPH_SET_LBEARING(g, val) ASET ((g), LGLYPH_IX_LBEARING, make_number (val))
	291	#define LGLYPH_SET_RBEARING(g, val) ASET ((g), LGLYPH_IX_RBEARING, make_number (val))
	292	#define LGLYPH_SET_ASCENT(g, val) ASET ((g), LGLYPH_IX_ASCENT, make_number (val))
	293	#define LGLYPH_SET_DESCENT(g, val) ASET ((g), LGLYPH_IX_DESCENT, make_number (val))
	294	#define LGLYPH_SET_ADJUSTMENT(g, val) ASET ((g), LGLYPH_IX_ADJUSTMENT, (val))
	295
	296	#define LGLYPH_XOFF(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
	297	? XINT (AREF (LGLYPH_ADJUSTMENT (g), 0)) : 0)
	298	#define LGLYPH_YOFF(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
	299	? XINT (AREF (LGLYPH_ADJUSTMENT (g), 1)) : 0)
	300	#define LGLYPH_WADJUST(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
	301	? XINT (AREF (LGLYPH_ADJUSTMENT (g), 2)) : 0)
	302
	303	struct composition_it;
	304	struct face;
	305	struct font_metrics;
	306
383e0970 J	307	extern Lisp_Object composition_gstring_put_cache (Lisp_Object, int);
	308	extern Lisp_Object composition_gstring_from_id (int);
	309	extern int composition_gstring_p (Lisp_Object);
579c18d0	310	extern int composition_gstring_width (Lisp_Object, EMACS_INT, EMACS_INT,
383e0970 J	311	struct font_metrics *);
	312
	313	extern void composition_compute_stop_pos (struct composition_it *,
	314	EMACS_INT, EMACS_INT, EMACS_INT,
	315	Lisp_Object);
	316	extern int composition_reseat_it (struct composition_it *,
	317	EMACS_INT, EMACS_INT, EMACS_INT,
	318	struct window , struct face ,
	319	Lisp_Object);
	320	extern int composition_update_it (struct composition_it *,
	321	EMACS_INT, EMACS_INT, Lisp_Object);
	322
41118bd3	323	extern EMACS_INT composition_adjust_point (EMACS_INT, EMACS_INT);
6e8b8329	324
6e8b8329	325	EXFUN (Fcomposition_get_gstring, 4);
15139d67	326
15a10ef1	327	#endif /* not EMACS_COMPOSITE_H */
6b61353c KH	328
	329	/* arch-tag: 59524d89-c645-47bd-b5e6-65e861690118
	330	(do not change this comment) */