Mercurial > emacs
annotate src/fontset.h @ 18116:7839aa2f6765
(koi8-r): Use R for mode line.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Mon, 02 Jun 1997 04:56:33 +0000 |
parents | 9b98ddd07fe5 |
children | 33e78cc7f058 |
rev | line source |
---|---|
17052 | 1 /* Header for fontset handler. |
2 Ver.1.0 | |
3 Copyright (C) 1995 Free Software Foundation, Inc. | |
4 Copyright (C) 1995 Electrotechnical Laboratory, JAPAN. | |
5 | |
17071 | 6 This file is part of GNU Emacs. |
7 | |
8 GNU Emacs is free software; you can redistribute it and/or modify | |
9 it under the terms of the GNU General Public License as published by | |
10 the Free Software Foundation; either version 2, or (at your option) | |
11 any later version. | |
17052 | 12 |
17071 | 13 GNU Emacs is distributed in the hope that it will be useful, |
14 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 GNU General Public License for more details. | |
17052 | 17 |
17071 | 18 You should have received a copy of the GNU General Public License |
19 along with GNU Emacs; see the file COPYING. If not, write to | |
20 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
21 Boston, MA 02111-1307, USA. */ | |
17052 | 22 |
23 #ifndef _FONTSET_H | |
24 #define _FONTSET_H | |
25 | |
26 /* | |
27 | |
28 #define GENERIC_FONT_PTR void | |
29 | |
30 /* This data type is used for the font_table field of window system | |
31 depending data area (e.g. struct x_display_info on X window). */ | |
32 | |
33 struct font_info | |
34 { | |
35 /* Pointer to window system dependent font structure. On X window, | |
36 this value should be coerced to (XFontStruct *). */ | |
37 void *font; | |
38 | |
39 /* Index number of the font. */ | |
40 int font_idx; | |
41 | |
42 /* Name to be used to find the font. */ | |
43 char *name; | |
44 | |
45 /* Full name of the font given by a window system. */ | |
46 char *full_name; | |
47 | |
48 /* Charset of characters displayed by the font. */ | |
49 int charset; | |
50 | |
51 /* Maximum bound width over all existing characters of the font. On | |
52 X window, this is same as (font->max_bounds.width) */ | |
53 int size; | |
54 | |
55 /* Height of the font. On X window, this is same as (font->ascent | |
56 + font->descent). */ | |
57 int height; | |
58 | |
59 /* Encodings of the font indexed by CHARSET. The value an integer | |
60 0, 1, 2, or 3: | |
61 0: code points 0x20..0x7F or 0x2020..0x7F7F are used | |
62 1: code points 0xA0..0xFF or 0xA0A0..0xFFFF are used | |
63 2: code points 0x20A0..0x7FFF are used | |
64 3: code points 0xA020..0xFF7F are used | |
65 For instance, ASCII and Latin-1 characters may use the same font | |
66 but different code points (ASCII uses 0x20..0x7F and Latin-1 uses | |
67 0xA0..0xFF). | |
68 | |
69 If the value can't be decided from information of the font, we | |
70 consult `font-encoding-alist' to get of the corresponding charset | |
71 whose default value is defined in lisp/fontset.el. Since there's | |
72 no charset whose id is 1, we use encoding[1] to store the | |
73 encoding information decided by the font itself. */ | |
17883
8173865f80ce
Change the declaration o encoding
Kenichi Handa <handa@m17n.org>
parents:
17881
diff
changeset
|
74 unsigned char encoding[MAX_CHARSET + 1]; |
17052 | 75 |
76 /* The baseline position of a font is normally `ascent' value of the | |
77 font. However, there exists many fonts which don't set `ascent' | |
78 an appropriate value to be used as baseline position. This is | |
79 typical in such ASCII fonts which are designed to be used with | |
80 Chinese, Japanese, Korean characters. When we use mixture of | |
81 such fonts and normal fonts (having correct `ascent' value), a | |
82 display line gets very ugly. Since we have no way to fix it | |
83 automatically, it is users responsibility to supply well designed | |
84 fonts or correct `ascent' value of fonts. But, the latter | |
85 requires heavy work (modifying all bitmap data in BDF files). | |
86 So, Emacs accepts a private font property | |
87 `_MULE_BASELINE_OFFSET'. If a font has this property, we | |
88 calculate the baseline position by subtracting the value from | |
89 `ascent'. In other words, the value indicates how many bits | |
90 higher we should draw a character of the font than normal ASCII | |
91 text for a better looking. | |
92 | |
93 We also have to consider the fact that the concept of `baseline' | |
94 differs among languages to which each character belongs. For | |
95 instance, baseline should be at the bottom most position of all | |
96 glyphs for Chinese, Japanese, and Korean. But, many of existing | |
97 fonts for those characters doesn't have correct `ascent' values | |
98 because they are designed to be used with ASCII fonts. To | |
99 display characters of different language on the same line, the | |
100 best way will be to arrange them in the middle of the line. So, | |
101 in such a case, again, we utilize the font property | |
102 `_MULE_BASELINE_OFFSET'. If the value is larger than `ascent' we | |
103 calculate baseline so that a character is arranged in the middle | |
104 of a line. */ | |
105 | |
106 int baseline_offset; | |
107 | |
108 /* Non zero means a character should be composed at a position | |
109 relative to the height (or depth) of previous glyphs in the | |
110 following cases: | |
111 (1) The bottom of the character is higher than this value. In | |
112 this case, the character is drawn above the previous glyphs. | |
113 (2) The top of the character is lower than 0 (i.e. baseline | |
114 height). In this case, the character is drawn beneath the | |
115 previous glyphs. | |
116 | |
17190
6637001cdb4b
Adjusted for the change of MAX_CHARSET.
Kenichi Handa <handa@m17n.org>
parents:
17113
diff
changeset
|
117 This value is taken from a private font property |
17052 | 118 `_MULE_RELATIVE_COMPOSE' which is introduced by Emacs. */ |
119 int relative_compose; | |
120 | |
17113
5579b391ebbc
(Vuse_default_ascent): Extern.
Kenichi Handa <handa@m17n.org>
parents:
17071
diff
changeset
|
121 /* Non zero means an ascent value to be used for a character |
5579b391ebbc
(Vuse_default_ascent): Extern.
Kenichi Handa <handa@m17n.org>
parents:
17071
diff
changeset
|
122 registered in char-table `use-default-ascent'. */ |
5579b391ebbc
(Vuse_default_ascent): Extern.
Kenichi Handa <handa@m17n.org>
parents:
17071
diff
changeset
|
123 int default_ascent; |
5579b391ebbc
(Vuse_default_ascent): Extern.
Kenichi Handa <handa@m17n.org>
parents:
17071
diff
changeset
|
124 |
17052 | 125 /* CCL program to calculate code points of the font. */ |
126 struct ccl_program *font_encoder; | |
127 }; | |
128 | |
17998
9b98ddd07fe5
(FONT_ENCODING_NOT_DECIDED): New macro.
Kenichi Handa <handa@m17n.org>
parents:
17883
diff
changeset
|
129 /* A value which may appear in the member encoding of struch font_info |
9b98ddd07fe5
(FONT_ENCODING_NOT_DECIDED): New macro.
Kenichi Handa <handa@m17n.org>
parents:
17883
diff
changeset
|
130 indicating that a font itself doesn't tell which encoding to be |
9b98ddd07fe5
(FONT_ENCODING_NOT_DECIDED): New macro.
Kenichi Handa <handa@m17n.org>
parents:
17883
diff
changeset
|
131 used. */ |
9b98ddd07fe5
(FONT_ENCODING_NOT_DECIDED): New macro.
Kenichi Handa <handa@m17n.org>
parents:
17883
diff
changeset
|
132 #define FONT_ENCODING_NOT_DECIDED 4 |
9b98ddd07fe5
(FONT_ENCODING_NOT_DECIDED): New macro.
Kenichi Handa <handa@m17n.org>
parents:
17883
diff
changeset
|
133 |
17052 | 134 #define FONT_NOT_OPENED -1 |
135 #define FONT_NOT_FOUND -2 | |
136 | |
137 struct fontset_info | |
138 { | |
139 /* Name of the fontset. */ | |
140 char *name; | |
141 | |
142 /* Size of the fontset. This is the same as the size of ASCII font | |
143 of this fontset. */ | |
144 int size; | |
145 | |
146 /* Height of the tallest font in the fontset. */ | |
147 int height; | |
148 | |
149 /* Table of font name for each character set. */ | |
17190
6637001cdb4b
Adjusted for the change of MAX_CHARSET.
Kenichi Handa <handa@m17n.org>
parents:
17113
diff
changeset
|
150 char *fontname[MAX_CHARSET + 1]; |
17052 | 151 |
152 /* Table of index numbers of fonts indexed by charset. If a font is | |
153 not yet loaded, the value is -1 (FONT_NOT_OPENED). If font | |
154 loading is failed, the value is -2 (FONT_NOT_FOUND). */ | |
17190
6637001cdb4b
Adjusted for the change of MAX_CHARSET.
Kenichi Handa <handa@m17n.org>
parents:
17113
diff
changeset
|
155 int font_indexes[MAX_CHARSET + 1]; |
17052 | 156 }; |
157 | |
158 /* This data type is used for the fontset_data field of struct frame. */ | |
159 | |
160 struct fontset_data | |
161 { | |
162 /* A table of pointers to all the fontsets. */ | |
163 struct fontset_info **fontset_table; | |
164 | |
165 /* The current capacity of fontset_table. */ | |
166 int fontset_table_size; | |
167 | |
168 /* The number of fontsets actually stored in fontset_table. | |
169 fontset_table[n] is used and valid iff 0 <= n < n_fontsets. | |
170 0 <= n_fontsets <= fontset_table_size. */ | |
171 int n_fontsets; | |
172 }; | |
173 | |
174 /* The following six are window system dependent functions. | |
175 Initialization routine of each window system should set appropriate | |
176 functions to these variables. For instance, in case of X window, | |
177 x_term_init does this. */ | |
178 | |
179 /* Return a pointer to struct font_info of font FONT_IDX of frame F. */ | |
180 extern struct font_info *(*get_font_info_func) (/* FRAME_PTR f; | |
181 int font_idx */); | |
182 | |
183 /* Return a list of font names which matches PATTERN. See the document of | |
184 `x-list-fonts' for more detail. */ | |
185 extern Lisp_Object (*list_fonts_func) (/* Lisp_Object pattern, face, frame, | |
186 width */); | |
187 | |
188 /* Load a font named NAME for frame F and return a pointer to the | |
189 information of the loaded font. If loading is failed, return -1. */ | |
190 extern struct font_info *(*load_font_func) (/* FRAME_PTR f; char *name */); | |
191 | |
192 /* Return a pointer to struct font_info of a font named NAME for frame F. | |
193 If no such font is loaded, return NULL. */ | |
194 extern struct font_info *(*query_font_func) (/* FRAME_PTR f; char *name */); | |
195 | |
196 /* Additional function for setting fontset or changing fontset | |
197 contents of frame F. This function may change the coordinate of | |
198 the frame. */ | |
199 extern void (*set_frame_fontset_func) (/* FRAME_PTR f; Lisp_Object arg, oldval */); | |
200 | |
201 /* Check if any window system is used now. */ | |
202 extern void (*check_window_system_func) (); | |
203 | |
204 extern struct fontset_data *alloc_fontset_data (); | |
205 extern void free_fontset_data (); | |
206 extern struct font_info *fs_load_font (); | |
207 extern Lisp_Object list_fontsets (); | |
208 extern Lisp_Object Vglobal_fontset_alist; | |
209 | |
210 extern Lisp_Object Qfontset; | |
17113
5579b391ebbc
(Vuse_default_ascent): Extern.
Kenichi Handa <handa@m17n.org>
parents:
17071
diff
changeset
|
211 extern Lisp_Object Vuse_default_ascent; |
17192
ce9a6d97e157
(Valternative_fontname_alist): Extern it.
Kenichi Handa <handa@m17n.org>
parents:
17190
diff
changeset
|
212 extern Lisp_Object Valternative_fontname_alist; |
17330
35bd2f60d22a
(Vhighlight_wrong_size_font, Vclip_large_size_font): Extern them.
Kenichi Handa <handa@m17n.org>
parents:
17192
diff
changeset
|
213 extern Lisp_Object Vhighlight_wrong_size_font; |
35bd2f60d22a
(Vhighlight_wrong_size_font, Vclip_large_size_font): Extern them.
Kenichi Handa <handa@m17n.org>
parents:
17192
diff
changeset
|
214 extern Lisp_Object Vclip_large_size_font; |
17052 | 215 |
216 #endif /* _FONTSET_H */ |