1 /* m17n-gui.h -- header file for the GUI API of the m17n library.
2 Copyright (C) 2003, 2004
3 National Institute of Advanced Industrial Science and Technology (AIST)
4 Registration Number H15PRO112
6 This file is part of the m17n library.
8 The m17n library is free software; you can redistribute it and/or
9 modify it under the terms of the GNU Lesser General Public License
10 as published by the Free Software Foundation; either version 2.1 of
11 the License, or (at your option) any later version.
13 The m17n library 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 GNU
16 Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public
19 License along with the m17n library; if not, write to the Free
20 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
35 extern void m17n_init_win (void);
37 #define M17N_INIT() m17n_init_win ()
39 extern void m17n_fini_win (void);
41 #define M17N_FINI() m17n_fini_win ()
43 /***en @defgroup m17nGUI GUI API */
44 /***ja @defgroup m17nGUI GUI API */
47 /*** @ingroup m17nGUI */
48 /***en @defgroup m17nFrame Frame */
49 /***ja @defgroup m17nFrame ¥Õ¥ì¡¼¥à */
52 /*** @ingroup m17nFrame */
54 @brief Type of frames.
56 The type #MFrame is for a @e frame object. Each frame holds
57 various information about the corresponding physical display/input
60 The internal structure of the type #MFrame is concealed from an
61 application program, and its contents depend on the window system
62 in use. In the m17n-X library, it contains the information about
63 @e display and @e screen in the X Window System. */
66 @brief ¥Õ¥ì¡¼¥à¤Î·¿Àë¸À.
68 #MFrame ¤Ï¡¢@e ¥Õ¥ì¡¼¥à ¥ª¥Ö¥¸¥§¥¯¥ÈÍѤη¿¤Ç¤¢¤ë¡£¸Ä¡¹¤Î¥Õ¥ì¡¼¥à¤Ï¡¢
69 ¤½¤ì¤¬Âбþ¤¹¤ëʪÍýŪ¤Êɽ¼¨¡¿ÆþÎϥǥХ¤¥¹¤Î³Æ¼ï¾ðÊó¤òÊÝ»ý¤¹¤ë¡£
71 #MFrame ·¿¤ÎÆâÉô¹½Â¤¤Ï¡¢¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¥×¥í¥°¥é¥à¤«¤é¤Ï¸«¤¨¤Ê¤¤¡£
72 ¤Þ¤¿¤½¤ÎÆâÍƤϻÈÍѤ¹¤ë¥¦¥£¥ó¥É¥¦¥·¥¹¥Æ¥à¤Ë°Í¸¤¹¤ë¡£¤Þ¤¿m17n-X ¥é
73 ¥¤¥Ö¥é¥ê¤Ë¤ª¤±¤ë¥Õ¥ì¡¼¥à¤Ï¡¢X ¥¦¥£¥ó¥É¥¦¤Î @e display ¤È @e screen
77 typedef struct MFrame MFrame;
82 extern MSymbol Mfont_width;
83 extern MSymbol Mfont_ascent;
84 extern MSymbol Mfont_descent;
85 extern MFrame *mframe_default;
87 extern MFrame *mframe (MPlist *plist);
89 extern void *mframe_get_prop (MFrame *frame, MSymbol key);
91 /* end of frame module */
94 /*** @ingroup m17nGUI */
95 /***en @defgroup m17nFont Font */
96 /***ja @defgroup m17nFont ¥Õ¥©¥ó¥È */
99 /*** @ingroup m17nFont */
101 @brief Type of fonts.
103 The type #MFont is the structure defining fonts. It contains
104 information about the following properties of a font: foundry,
105 family, weight, style, stretch, adstyle, registry, size, and
108 This structure is used both for specifying a font in a fontset
109 and for storing information about available system fonts.
111 The internal structure is concealed from an application program. */
114 @brief ¥Õ¥©¥ó¥È¤Î·¿Àë¸À.
116 #MFont ·¿¤Ï¥Õ¥©¥ó¥È»ØÄêÍѤι½Â¤ÂΤǤ¢¤ê¡¢¥Õ¥©¥ó¥È¤Î¥×¥í¥Ñ¥Æ¥£¤Ç¤¢
117 ¤ë foundry, family, weight, style, stretch, adstyle, registry,
118 size, resolution ¤Ë´Ø¤¹¤ë¾ðÊó¤ò´Þ¤à¡£
120 ¤³¤Î¹½Â¤ÂΤϥե©¥ó¥È¥»¥Ã¥ÈÆâ¤Î¥Õ¥©¥ó¥È¤ò»ØÄꤹ¤ëºÝ¤È¡¢»ÈÍѲÄǽ¤Ê¥·
121 ¥¹¥Æ¥à¥Õ¥©¥ó¥È¤Î¾ðÊó¤ò³ÊǼ¤¹¤ëºÝ¤ÎξÊý¤ËÍѤ¤¤é¤ì¤ë¡£
123 ÆâÉô¹½Â¤¤Ï¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¥×¥í¥°¥é¥à¤«¤é¤Ï¸«¤¨¤Ê¤¤¡£ */
127 mfont (), mfont_from_name (), mfont_find (). */
129 typedef struct MFont MFont;
133 extern MSymbol Mfont;
135 extern MPlist *mfont_freetype_path;
137 extern MFont *mfont ();
139 extern MFont *mfont_from_name (char *name);
141 extern MFont *mfont_copy (MFont *font);
143 extern char *mfont_name (MFont *font);
145 extern MFont *mfont_from_spec (char *family, char *weight, char *slant,
146 char *swidth, char *adstyle, char *registry,
147 unsigned short point, unsigned short res);
149 extern MSymbol Mfoundry;
150 extern MSymbol Mfamily;
151 extern MSymbol Mweight;
152 extern MSymbol Mstyle;
153 extern MSymbol Mstretch;
154 extern MSymbol Madstyle;
155 extern MSymbol Mregistry;
156 extern MSymbol Msize;
157 extern MSymbol Mresolution;
159 extern void *mfont_get_prop (MFont *font, MSymbol key);
161 extern int mfont_put_prop (MFont *font, MSymbol key, void *val);
163 extern int mfont_set_encoding (MFont *font,
164 MSymbol encoding_name, MSymbol repertory_name);
172 The mfont_find () function returns a pointer to the available font
173 that matches best with the specification $SPEC in frame $FRAME.
175 $SCORE, if not NULL, must point to a place to store the score
176 value which indicates how well the found font matches $SPEC. The
177 smaller score means a better match.
179 $LIMITED_SIZE, if nonzero, forces the font selector to find a
180 font not greater than the #Msize property of $SPEC. */
183 @brief ¥Õ¥©¥ó¥È¤òõ¤¹.
185 ´Ø¿ô mfont_find () ¤Ï¡¢¥Õ¥ì¡¼¥à $FRAME ¾å¤Ç¥Õ¥©¥ó¥ÈÄêµÁ $SPEC ¤Ë¤â¤Ã
186 ¤È¤â¹çÃפ¹¤ë»ÈÍѲÄǽ¤Ê¥Õ¥©¥ó¥È¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
188 $SCORE ¤Ï NULL ¤Ç¤¢¤ë¤«¡¢¸«¤Ä¤«¤Ã¤¿¥Õ¥©¥ó¥È¤¬ $SPEC ¤Ë¤É¤ì¤Û¤É¹ç¤Ã
189 ¤Æ¤¤¤ë¤«¤ò¼¨¤¹¥¹¥³¥¢¤òÊݸ¤¹¤ë¾ì½ê¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£¥¹¥³¥¢¤¬¾®¤µ
190 ¤¤¤Û¤ÉÎɤ¯¹ç¤Ã¤Æ¤¤¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
192 $LIMITED_SIZE ¤¬ 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢$SPEC ¤Î¥×¥í¥Ñ¥Æ¥£ #Msize ¤è¤êÂç¤
193 ¤¯¤Ê¤¤¥Õ¥©¥ó¥È¤À¤±¤¬Ãµ¤µ¤ì¤ë¡£
196 extern MFont *mfont_find (MFrame *frame, MFont *spec,
197 int *score, int limited_size);
199 extern MSymbol *mfont_selection_priority ();
201 extern int mfont_set_selection_priority (MSymbol *keys);
203 /* end of font module */
206 /*** @ingroup m17nGUI */
207 /***en @defgroup m17nFontset Fontset */
208 /***ja @defgroup m17nFontset ¥Õ¥©¥ó¥È¥»¥Ã¥È */
211 typedef struct MFontset MFontset;
213 extern MFontset *mfontset (char *name);
215 extern MSymbol mfontset_name (MFontset *fontset);
217 extern MFontset *mfontset_copy (MFontset *fontset, char *name);
219 extern int mfontset_modify_entry (MFontset *fontset,
220 MSymbol language, MSymbol script,
222 MFont *spec, MSymbol layouter_name,
225 /* end of fontset module */
228 /*** @ingroup m17nGUI */
229 /***en @defgroup m17nFace Face */
230 /***ja @defgroup m17nFace ¥Õ¥§¡¼¥¹ */
233 /*** @ingroup m17nFace */
235 @brief Type of faces.
237 The type #MFace is the structure of face objects. The internal
238 structure is concealed from an application program. */
241 @brief ¥Õ¥§¡¼¥¹¤Î·¿Àë¸À.
243 #MFace ·¿¤Ï¥Õ¥§¡¼¥¹¥ª¥Ö¥¸¥§¥¯¥È¤Î¤¿¤á¤Î¹½Â¤ÂΤǤ¢¤ë¡£ÆâÉô¹½Â¤¤Ï
244 ¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¥×¥í¥°¥é¥à¤«¤é¤Ï¸«¤¨¤Ê¤¤¡£ */
246 typedef struct MFace MFace;
249 extern MSymbol Mforeground;
250 extern MSymbol Mbackground;
251 extern MSymbol Mvideomode;
252 extern MSymbol Mnormal;
253 extern MSymbol Mreverse;
254 extern MSymbol Mhline;
256 extern MSymbol Mfontset;
257 extern MSymbol Mratio;
258 extern MSymbol Mhook_func;
259 extern MSymbol Mhook_arg;
261 /* Predefined faces. */
262 extern MFace *mface_normal_video;
263 extern MFace *mface_reverse_video;
264 extern MFace *mface_underline;
265 extern MFace *mface_medium;
266 extern MFace *mface_bold;
267 extern MFace *mface_italic;
268 extern MFace *mface_bold_italic;
269 extern MFace *mface_xx_small;
270 extern MFace *mface_x_small;
271 extern MFace *mface_small;
272 extern MFace *mface_normalsize;
273 extern MFace *mface_large;
274 extern MFace *mface_x_large;
275 extern MFace *mface_xx_large;
276 extern MFace *mface_black;
277 extern MFace *mface_white;
278 extern MFace *mface_red;
279 extern MFace *mface_green;
280 extern MFace *mface_blue;
281 extern MFace *mface_cyan;
282 extern MFace *mface_yellow;
283 extern MFace *mface_magenta;
286 extern MSymbol Mface;
288 extern MFace *mface ();
290 extern MFace *mface_copy (MFace *face);
292 extern MFace *mface_merge (MFace *dst, MFace *src);
294 extern MFace *mface_from_font (MFont *font);
298 /*** @ingroup m17nFace */
300 @brief Type of horizontal line spec of face.
302 The type #MFaceHLineProp is to specify the detail of #Mhline
303 property of a face. The value of the property must be a pointer
304 to an object of this type. */
306 @brief ¥Õ¥§¡¼¥¹¤Î¿åÊ¿Àþ»ØÄêÍÑ·¿Àë¸À.
308 #MFaceHLineProp ¤Ï¥Õ¥§¡¼¥¹¤Î #Mhline ¥×¥í¥Ñ¥Æ¥£¤Î¾ÜºÙ¤ò»ØÄꤹ¤ë·¿
309 ¤Ç¤¢¤ë¡£¤³¤Î¥×¥í¥Ñ¥Æ¥£¤ÎÃͤϤ³¤Î·¿¤Î¥ª¥Ö¥¸¥§¥¯¥È¤Ç¤Ê¤¯¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
314 /***en Type of the horizontal line. */
315 /***ja ¿åÊ¿Àþ¤Î¥¿¥¤¥×. */
320 MFACE_HLINE_STRIKE_THROUGH,
325 /***en Width of the line in pixels. */
326 /***ja ÀþÉý¡Ê¥Ô¥¯¥»¥ëñ°Ì¡Ë. */
329 /***en Color of the line. If the value is Mnil, foreground color of
330 a merged face is used. */
331 /***ja Àþ¤Î¿§. Mnil ¤Ê¤é¤Ð¡¢Åý¹ç¤·¤¿¥Õ¥§¡¼¥¹¤ÎÁ°·Ê¿§¤¬»È¤ï¤ì¤ë¡£ */
337 /*** @ingroup m17nFace */
339 @brief Type of box spec of face.
341 The type #MFaceBoxProp is to specify the detail of #Mbox property
342 of a face. The value of the property must be a pointer to an
343 object of this type. */
345 @brief ¥Õ¥§¡¼¥¹¤Î°Ï¤ßÏÈ»ØÄêÍÑ·¿Àë¸À.
347 #MFaceBoxProp ¤Ï¥Õ¥§¡¼¥¹¤Î #Mbox ¥×¥í¥Ñ¥Æ¥£¤Î¾ÜºÙ¤ò»ØÄꤹ¤ë·¿¤Ç¤¢
348 ¤ë¡£¤³¤Î¥×¥í¥Ñ¥Æ¥£¤ÎÃͤϤ³¤Î·¿¤Î¥ª¥Ö¥¸¥§¥¯¥È¤Ç¤Ê¤¯¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
353 /***en Width of the box line in pixels. */
354 /***ja ÀþÉý¡Ê¥Ô¥¯¥»¥ëñ°Ì¡Ë. */
358 MSymbol color_bottom;
362 unsigned inner_hmargin;
363 unsigned inner_vmargin;
364 unsigned outer_hmargin;
365 unsigned outer_vmargin;
370 /*** @ingroup m17nFace */
372 @brief Type of hook function of face.
374 The type #MFaceHookFunc is to specify the #Mhook property of a
375 face. The value of the property must be function of this
378 @brief ¥Õ¥§¡¼¥¹¤Î¥Õ¥Ã¥¯´Ø¿ô¤Î·¿Àë¸À.
380 #MFaceHookFunc ¤Ï¥Õ¥§¡¼¥¹¤Î #Mhook ¥×¥í¥Ñ¥Æ¥£¤ò»ØÄꤹ¤ë·¿¤Ç¤¢¤ë¡£
381 ¤³¤Î¥×¥í¥Ñ¥Æ¥£¤ÎÃͤϡ¢¤³¤Î·¿¤Î´Ø¿ô¤Ç¤Ê¤¯¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
383 typedef void *(*MFaceHookFunc) (MFace *face, void *arg, void *info);
386 extern void *mface_get_prop (MFace *face, MSymbol key);
388 extern int mface_put_prop (MFace *face, MSymbol key, void *val);
390 extern void mface_update (MFrame *frame, MFace *face);
392 /* end of face module */
395 /*** @ingroup m17nGUI */
396 /***en @defgroup m17nDraw Drawing */
397 /***ja @defgroup m17nDraw ɽ¼¨ */
400 /*** @ingroup m17nDraw */
402 @brief Window system dependent type for a window.
404 The type #MDrawWindow is for a window; a rectangular area that
405 works in several ways like a miniature screen.
407 What it actually points depends on a window system. A program
408 that uses the m17n-X library must coerce the type @c Drawable to
411 @brief ¥¦¥£¥ó¥É¥¦¥·¥¹¥Æ¥à¤Ë°Í¸¤¹¤ë¡¢¥¦¥£¥ó¥É¥¦¤Î·¿Àë¸À.
413 #MDrawWindow ¤Ï¥¦¥£¥ó¥É¥¦¡¢¤¹¤Ê¤ï¤Á´ö¤Ä¤«¤ÎÅÀ¤Ç¥¹¥¯¥ê¡¼¥ó¤Î¥ß¥Ë¥Á¥å
414 ¥¢¤È¤·¤ÆƯ¤¯¶ë·ÁÎΰèÍѤη¿¤Ç¤¢¤ë¡£
416 ¼ÂºÝ¤Ë²¿¤ò»Ø¤¹¤«¤Ï¥¦¥£¥ó¥É¥¦¥·¥¹¥Æ¥à¤Ë°Í¸¤¹¤ë¡£ m17n X ¥é¥¤¥Ö¥é¥ê
417 ¤òÍøÍѤ¹¤ë¥×¥í¥°¥é¥à¤Ï @c Drawable ·¿¤ò¤³¤Î·¿¤ËÊÑ´¹¤·¤Ê¤¯¤Æ¤Ï¤Ê¤é
420 typedef void *MDrawWindow;
423 /*** @ingroup m17nDraw */
425 @brief Window system dependent type for a region.
427 The type #MDrawRegion is for a region; an arbitrary set of pixels
428 on the screen (typically a rectangular area).
430 What it actually points depends on a window system. A program
431 that uses the m17n-X library must coerce the type @c Region to
434 @brief ¥¦¥£¥ó¥É¥¦¥·¥¹¥Æ¥à¤Ë°Í¸¤¹¤ë¡¢Îΰè¤Î·¿Àë¸À.
436 #MDrawRegion ¤ÏÎΰ衢¤¹¤Ê¤ï¤Á¥¹¥¯¥ê¡¼¥ó¾å¤ÎǤ°Õ¤Î¥Ô¥¯¥»¥ë¤Î½¸¹ç
437 ¡Êŵ·¿Åª¤Ë¤Ï¶ë·ÁÎΰè¡ËÍѤη¿¤Ç¤¢¤ë¡£
439 ¼ÂºÝ¤Ë²¿¤ò»Ø¤¹¤«¤Ï¥¦¥£¥ó¥É¥¦¥·¥¹¥Æ¥à¤Ë°Í¸¤¹¤ë¡£ m17n X ¥é¥¤¥Ö¥é¥ê
440 ¤òÍøÍѤ¹¤ë¥×¥í¥°¥é¥à¤Ï @c Region ·¿¤ò¤³¤Î·¿¤ËÊÑ´¹¤·¤Ê¤¯¤Æ¤Ï¤Ê¤é
443 typedef void *MDrawRegion;
446 /*** @ingroup m17nDraw */
448 @brief Type of a text drawing control.
450 The type #MDrawControl is the structure that controls how to draw
453 @brief ¥Æ¥¥¹¥Èɽ¼¨À©¸æ¤Î·¿Àë¸À.
455 #MDrawControl ·¿¤Ï¡¢M-text ¤ò¤É¤¦É½¼¨¤¹¤ë¤«¤òÀ©¸æ¤¹¤ë¹½Â¤ÂΤǤ¢¤ë¡£
461 /***en If nonzero, draw an M-text as image, i.e. with background
462 filled with background colors of faces put on the M-text.
463 Otherwise, the background is not changed. */
464 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢ M-text ¤ò²èÁü¤È¤·¤Æ¡¢¤¹¤Ê¤ï¤ÁÇطʤò M-text ¤Î
465 ¥Õ¥§¡¼¥¹¤Ç»ØÄꤵ¤ì¤Æ¤¤¤ëÇØ·Ê¿§¤ÇËä¤á¤Æɽ¼¨¤¹¤ë¡£¤½¤¦¤Ç¤Ê¤±¤ì¤ÐÇØ
467 unsigned as_image : 1;
469 /***en If nonzero and the first glyph of each line has negative
470 lbearing, shift glyphs horizontally to right so that no pixel is
471 drawn to the left of the specified position. */
472 /***ja 0 ¤Ç¤Ê¤¯¡¢³Æ¹Ô¤ÎºÇ½é¤Î¥°¥ê¥Õ¤Îlbearing ¤¬Éé¤Ê¤é¤Ð¡¢¥°¥ê¥Õ¤ò¿å
473 Ê¿¤Ë±¦¤Ë¤º¤é¤·¤Æ¡¢»ØÄꤷ¤¿°ÌÃÖ¤è¤êº¸¤Ë¥Ô¥¯¥»¥ë¤¬ÉÁ¤«¤ì¤Ê¤¤¤è¤¦¤Ë
475 unsigned align_head : 1;
477 /***en If nonzero, draw an M-text two-dimensionally, i.e., newlines
478 in M-text breaks lines and the following characters are drawn in
479 the next line. If <format> is non-NULL, and the function
480 returns nonzero line width, a line longer than that width is
482 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢M-text ¤ò£²¼¡¸µÅª¤Ë¡¢¤¹¤Ê¤ï¤ÁM-text Ãæ¤Î
483 newline ¤Ç²þ¹Ô¤·¡¢Â³¤¯Ê¸»ú¤Ï¼¡¤®¤Î¹Ô¤Ëɽ¼¨¤¹¤ë¡£¤â¤· <format> ¤¬
484 NULL ¤Ç¤Ê¤¯¡¢¤½¤Î´Ø¿ô¤¬ 0 ¤Ç¤Ê¤¤¹ÔÉý¤òÊÖ¤»¤Ð¡¢¤½¤ÎÉý¤è¤êŤ¤¹Ô¤â
486 unsigned two_dimensional : 1;
488 /***en If nonzero, draw an M-text to the right of a specified
490 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢M-text ¤ò»ØÄꤷ¤¿°ÌÃ֤ᦤËɽ¼¨¤¹¤ë¡£ */
491 unsigned orientation_reversed : 1;
493 /***en If nonzero, reorder glyphs correctly for bidi text. */
494 /***ja 0 ¤Ê¤±¤ì¤Ð¡¢bidi ¥Æ¥¥¹¥ÈÍѤ˥°¥ê¥Õ¤òÀµ¤·¤¯À°Î󤹤롣 */
495 unsigned enable_bidi : 1;
497 /***en If nonzero, don't draw characters whose general category (in
498 Unicode) is Cf (Other, format). */
499 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢¥æ¥Ë¥³¡¼¥É¤ËÃÖ¤±¤ë°ìÈÌ¥«¥Æ¥´¥ê¤¬ Cf (Other,
500 format) ¤Ç¤¢¤ëʸ»ú¤òɽ¼¨¤·¤Ê¤¤¡£ */
501 unsigned ignore_formatting_char : 1;
503 /***en If nonzero, draw glyphs suitable for a terminal. Not yet
505 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢Ã¼ËöÍѤΥ°¥ê¥Õ¤òɽ¼¨¤¹¤ë¡£¡Ê̤¼ÂÁõ¡£¡Ë */
506 unsigned fixed_width : 1;
508 /***en If nonzero, draw glyphs with anti-aliasing if a backend font
509 driver supports it. */
510 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢¥¢¥ó¥Á¥¨¡¼¥ê¥¢¥¹¤Ç¥°¥ê¥Õ¤òɽ¼¨¤¹¤ë¡£¡Ê¥Ð¥Ã¥¯¥¨
511 ¥ó¥É¤Î¥Õ¥©¥ó¥È¥É¥é¥¤¥Ð¤¬¥¢¥ó¥Á¥¨¡¼¥ê¥¢¥¹µ¡Ç½¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¾ì
513 unsigned anti_alias : 1;
515 /***en If nonzero, the values are minimum line ascent and descent
517 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢ÃͤϹԤΠascent ¤È descent ¤ÎºÇ¾®Ãͤò¼¨¤¹¡£ */
518 unsigned int min_line_ascent;
519 unsigned int min_line_descent;
521 /***en If nonzero, the values are maximum line ascent and descent
523 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢ÃͤϹԤΠascent ¤È descent ¤ÎºÇÂçÃͤò¼¨¤¹¡£ */
524 unsigned int max_line_ascent;
525 unsigned int max_line_descent;
527 /***en If nonzero, the value specifies how many pixels each line can
528 occupy on the display. The value zero means that there is no
529 limit. It is ignored if <format> is non-NULL. */
530 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢ÃͤϤ³¤Î¥Ç¥£¥¹¥×¥ì¥¤¾å¤Ç³Æ¹Ô¤¬Àê¤á¤ë¤³¤È¤Î¤Ç¤
531 ¤ë¥Ô¥¯¥»¥ë¿ô¤ò¼¨¤¹¡£ 0 ¤Ï¸ÂÄꤵ¤ì¤Ê¤¤¤³¤È¤ò°ÕÌ£¤¹¤ë¡£<format> ¤¬
532 NULL ¤Ç¤Ê¤±¤ì¤Ð̵»ë¤µ¤ì¤ë¡£ */
533 unsigned int max_line_width;
535 /***en If nonzero, the value specifies the distance between tab
536 stops in columns (the width of one column is the width of a
537 space in the default font of the frame). The value zero means
539 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢Ãͤϥ¿¥Ö¥¹¥È¥Ã¥×´Ö¤Îµ÷Î¥¤ò¥³¥é¥àñ°Ì¡Ê¥³¥é¥à¤Ï
540 ¥Õ¥ì¡¼¥à¤Î¥Ç¥Õ¥©¥ë¥È¥Õ¥©¥ó¥È¤Ë¤ª¤±¤ë¶õÇòʸ»ú¤ÎÉý¤Ç¤¢¤ë¡Ë¤Ç¼¨¤¹¡£
541 0 ¤Ï 8 ¤ò°ÕÌ£¤¹¤ë¡£ */
542 unsigned int tab_width;
544 /***en If non-NULL, the value is a function that calculates the
545 indentation and width limit of each line based on the line
546 number LINE and the coordinate Y. The function store the
547 indentation and width limit at the place pointed by INDENT and
550 The indentation specifies how many pixels the first glyph of
551 each line is shifted to the right (if the member
552 <orientation_reversed> is zero) or to the left (otherwise). If
553 the value is negative, each line is shifted to the reverse
556 The width limit specifies how many pixels each line can occupy
557 on the display. The value 0 means that there is no limit.
559 LINE and Y are reset to 0 when a line is broken by a newline
560 character, and incremented each time when a long line is broken
561 because of the width limit.
563 This has an effect only when <two_dimensional> is nonzero. */
564 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢Ãͤϴؿô¤Ç¤¢¤ê¡¢¤½¤Î´Ø¿ô¤Ï¹ÔÈÖ¹æ LINE ¤ÈºÂɸ Y
565 ¤Ë´ð¤Å¤¤¤Æ³Æ¹Ô¤Î¥¤¥ó¥Ç¥ó¥È¤ÈºÇÂçÉý¤ò·×»»¤·¡¢¤½¤ì¤¾¤ì¤òINDENT ¤È
566 WIDTH ¤Ç»Ø¤µ¤ì¤ë¾ì½ê¤ËÊݸ¤¹¤ë¡£
568 ¥¤¥ó¥Ç¥ó¥È¤Ï¡¢³Æ¹Ô¤ÎºÇ½é¤Î¥°¥ê¥Õ¤¬±¦¡Ê¥á¥ó¥Ð
569 <orientation_reversed> ¤¬ 0 ¤Î»þ¡Ë¤¢¤ë¤¤¤Ïº¸¡Ê¤½¤ì°Ê³°¤Î»þ¡Ë¤Ë²¿
570 ¥Ô¥¯¥»¥ë¤º¤é¤¹¤ò»ØÄꤹ¤ë¡£Ãͤ¬Éé¤Ê¤é¤ÐµÕÊý¸þ¤Ë¤º¤é¤¹¡£
572 ºÇÂçÉý¤Ï¡¢³Æ¹Ô¤¬¥Ç¥£¥¹¥×¥ì¥¤¾å¤ÇÀê¤á¤ë¤³¤È¤Î¤Ç¤¤ë¥Ô¥¯¥»¥ë¿ô¤ÎºÇ
573 ÂçÃͤǤ¢¤ë¡£Ãͤ¬ 0 ¤Î¾ì¹ç¤ÏÀ©¸Â¤ò¼õ¤±¤Ê¤¤¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
575 LINE ¤È Y ¤Ï²þ¹Ôʸ»ú¤Ë¤è¤Ã¤Æ¹Ô¤¬²þ¤Þ¤Ã¤¿ºÝ¤Ë¤Ï 0 ¤Ë¥ê¥»¥Ã¥È¤µ¤ì¡¢
576 ºÇÂçÉý¤Ë¤è¤Ã¤Æ¹Ô¤¬²þ¤Þ¤Ã¤¿¾ì¹ç¤Ë¤Ï 1 ¤Å¤ÄÁý¤ä¤µ¤ì¤ë¡£
578 ¤³¤ì¤Ï <two_dimensional> ¤¬ 0 ¤Ç¤Ê¤¤¾ì¹ç¤Ë¤Î¤ß͸ú¤Ç¤¢¤ë¡£ */
579 void (*format) (int line, int y, int *indent, int *width);
581 /***en If non-NULL, the value is a function that calculates a line
582 breaking position when a line is too long to fit within the
583 width limit. POS is the position of the character next to the
584 last one that fits within the limit. FROM is the position of the
585 first character of the line, and TO is the position of the last
586 character displayed on the line if there were not width limit.
587 LINE and Y are the same as the arguments to <format>.
589 The function must return a character position to break the
592 The function should not modify MT.
594 The mdraw_default_line_break () function is useful for such a
595 script that uses SPACE as a word separator. */
596 /***ja NULL ¤Ç¤Ê¤±¤ì¤Ð¡¢ÃͤϹԤ¬ºÇÂçÉýÃæ¤Ë¼ý¤Þ¤é¤Ê¤¤¾ì¹ç¤Ë¹Ô¤ò²þ¤á¤ë
597 °ÌÃÖ¤ò·×»»¤¹¤ë´Ø¿ô¤Ç¤¢¤ë¡£POS ¤ÏºÇÂçÉý¤Ë¼ý¤Þ¤ëºÇ¸å¤Îʸ»ú¤Î¼¡¤Îʸ
598 »ú¤Î°ÌÃ֤Ǥ¢¤ë¡£FROM ¤Ï¹Ô¤ÎºÇ½é¤Îʸ»ú¤Î°ÌÃÖ¡¢TO ¤ÏºÇÂçÉý¤¬»ØÄꤵ
599 ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¤½¤Î¹Ô¤Ëɽ¼¨¤µ¤ì¤ëºÇ¸å¤Îʸ»ú¤Î°ÌÃ֤Ǥ¢¤ë¡£LINE ¤È
600 Y ¤Ï <format> ¤Î°ú¿ô¤ÈƱ¤¸¤Ç¤¢¤ë¡£
602 ¤³¤Î´Ø¿ô¤Ï¹Ô¤ò²þ¤á¤ëʸ»ú°ÌÃÖ¤òÊÖ¤µ¤Ê¤¯¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£¤Þ¤¿MT ¤ò
605 ´Ø¿ô mdraw_default_line_break () ¤Ï¡¢¶õÇò¤ò¸ì¤Î¶èÀÚ¤ê¤È¤·¤ÆÍѤ¤
606 ¤ë¥¹¥¯¥ê¥×¥ÈÍѤȤ·¤ÆÍѤ¤¤ë¤³¤È¤¬¤Ç¤¤ë¡£ */
607 int (*line_break) (MText *mt, int pos, int from, int to, int line, int y);
611 /***en Specifies the character position to display a cursor. If it
612 is greater than the maximum character position, the cursor is
613 displayed next to the last character of an M-text. If the value
614 is negative, even if <cursor_width> is nonzero, cursor is not
616 /***ja ¥«¡¼¥½¥ë¤òɽ¼¨¤¹¤ëʸ»ú°ÌÃÖ¤ò¼¨¤¹¡£ºÇÂç¤Îʸ»ú°ÌÃÖ¤è¤êÂ礤±¤ì
617 ¤Ð¡¢¥«¡¼¥½¥ë¤ÏM-text ¤ÎºÇ¸å¤Îʸ»ú¤ÎÎÙ¤Ëɽ¼¨¤µ¤ì¤ë¡£Éé¤Ê¤é¤Ð¡¢
618 <cursor_width> ¤¬ 0 ¤Ç¤Ê¤¯¤Æ¤â¥«¡¼¥½¥ë¤Ïɽ¼¨¤µ¤ì¤Ê¤¤¡£
622 /***en If nonzero, display a cursor at the character position
623 <cursor_pos>. If the value is positive, it is the pixel width
624 of the cursor. If the value is negative, the cursor width is
625 the same as the underlining glyph(s). */
626 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢<cursor_pos> ¤Ë¥«¡¼¥½¥ë¤òɽ¼¨¤¹¤ë¡£Ãͤ¬Àµ¤Ê¤é¤Ð¡¢
627 ¥«¡¼¥½¥ë¤ÎÉý¤Ï¤½¤ÎÃÍ¡Ê¥Ô¥¯¥»¥ëñ°Ì¡Ë¤Ç¤¢¤ë¡£Éé¤Ê¤é¤Ð¡¢¥«¡¼¥½¥ë¤Î
628 ¤¢¤ë¥°¥ê¥Õ¤ÈƱ¤¸Éý¤Ç¤¢¤ë¡£ */
631 /***en If nonzero and <cursor_width> is also nonzero, display double
632 bar cursors; at the character position <cursor_pos> and at the
633 logically previous character. Both cursors have one pixel width
634 with horizontal fringes at upper or lower positions. */
635 /***ja If 0 ¤Ç¤Ê¤¯¡¢¤«¤Ä <cursor_width> ¤â 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢¥Ð¡¼¥«¡¼¥½
636 ¥ë¤òʸ»ú°ÌÃÖ<cursor_pos> ¤ÈÏÀÍýŪ¤Ë¤½¤ì¤ÎÁ°¤Ë¤¢¤ëʸ»ú¤Î£²¥ö½êɽ
637 ¼¨¤¹¤ë¡£ÁÐÊý¤È¤â£±¥Ô¥¯¥»¥ëÉý¤Ç¡¢¾å²¼¤Ë¿åÊ¿¤Î¾þ¤ê¤¬¤Ä¤¯¡£*/
640 /***en If nonzero, on drawing partial text, pixels of surrounding
641 texts that intrude into the drawing area are also drawn. For
642 instance, some CVC sequence of Thai text (C is consonant, V is
643 upper vowel) is drawn so that V is placed over the middle of two
644 Cs. If this CVC sequence is already drawn and only the last C
645 is drawn again (for instance by updating cursor position), the
646 right half of V is erased if this member is zero. By setting
647 this member to nonzero, even with such a drawing, we can keep
648 this CVC sequence correctly displayed. */
649 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢¥Æ¥¥¹¥È¤Î°ìÉôʬ¤òɽ¼¨¤¹¤ëºÝ¤Ë¡¢Á°¸å¤Î¥Æ¥¥¹¥È
650 ¤Î¤¦¤Á¤½¤Îɽ¼¨Îΰè¤Ë¿¯Æþ¤¹¤ëÉôʬ¤âɽ¼¨¤¹¤ë¡£¤¿¤È¤¨¤Ð¡¢¥¿¥¤¸ìʸ½ñ
651 ¤Î»Ò²»-Êì²»-»Ò²»¤È¤¤¤¦¥·¡¼¥¯¥¨¥ó¥¹¤Î¤¤¤¯¤Ä¤«¤Ï¡¢Êì²»¤¬Æó¤Ä¤Î»Ò²»
652 ¤Î´Ö¤Ë¾å¤Ë¤Î¤ë¤è¤¦¤ËÉÁ¤«¤ì¤ë¡£¤³¤Î¤è¤¦¤Ê¥·¡¼¥¯¥¨¥ó¥¹¤¬¤¹¤Ç¤ËÉÁ¤«
653 ¤ì¤Æ¤ª¤ê¡¢ºÇ¸å¤Î»Ò²»¤À¤±¤òÉÁ¤Ä¾¤¹¾ì¹ç¡Ê¤¿¤È¤¨¤Ð¡¢¥«¡¼¥½¥ë°ÌÃÖ¤ò
654 ¹¹¿·¤¹¤ëºÝ¤Ê¤É¡Ë¤³¤Î¥á¥ó¥Ð¤¬ 0 ¤Ç¤¢¤ì¤Ð¡¢Êì²»¤Î±¦È¾Ê¬¤¬¾Ã¤µ¤ì¤Æ
655 ¤·¤Þ¤¦¡£¤³¤ì¤ò 0 °Ê³°¤Ë¤¹¤ë¤³¤È¤Ë¤è¤Ã¤Æ¡¢¤½¤Î¤è¤¦¤ÊºÝ¤Ë¤â»Ò²»-Êì
656 ²»-»Ò²»¥·¡¼¥¯¥¨¥ó¥¹¤òÀµ¤·¤¯É½¼¨¤·Â³¤±¤ë¤³¤È¤¬¤Ç¤¤ë¡£ */
659 /***en If nonzero, don't cache the result of any drawing information
661 /***ja 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢M-text ¤Îɽ¼¨¤Ë´Ø¤¹¤ë¾ðÊó¤ò¥¥ã¥Ã¥·¥å¤·¤Ê¤¤¡£
665 /* If non-NULL, limit the drawing effect to the specified region. */
666 MDrawRegion clip_region;
672 /*** @ingroup m17nDraw */
674 @brief Type of metric for gylphs and texts.
676 The type #MDrawMetric is for a metric of a glyph and a drawn text.
677 It is also used to represent a rectangle area of a graphic
680 @brief ¥°¥ê¥Õ¤È¥Æ¥¥¹¥È¤ÎÀ£Ë¡¤Î·¿Àë¸À.
682 #MDrawMetric ¤Ï¥°¥ê¥Õ¤Èɽ¼¨¤µ¤ì¤¿¥Æ¥¥¹¥È¤ÎÀ£Ë¡ÍѤη¿¤Ç¤¢¤ë¡£¤Þ¤¿¡¢
683 ɽ¼¨¥Ç¥Ð¥¤¥¹¤Î¶ë·ÁÎΰè¤òɽ¤¹¤Î¤Ë¤âÍѤ¤¤é¤ì¤ë¡£ */
687 unsigned int width, height;
692 /*** @ingroup m17nDraw */
694 @brief Type of information about a glyph.
696 The type #MDrawGlyphInfo is the structure that contains
697 information about a glyph. It is used by mdraw_glyph_info (). */
699 @brief ¥°¥ê¥Õ¤Ë´Ø¤¹¤ë¾ðÊó¤Î·¿Àë¸À.
701 #MDrawGlyphInfo ·¿¤Ï¥°¥ê¥Õ¤Ë´Ø¤¹¤ë¾ðÊó¤ò´Þ¤à¹½Â¤ÂΤǤ¢¤ë¡£
702 mdraw_glyph_info () ¤Ï¤³¤ì¤òÍѤ¤¤ë¡£ */
706 /***en Character range corresponding to the glyph. */
707 /***ja ¥°¥ê¥Õ¤ËÂбþ¤¹¤ëʸ»ú¤ÎÈÏ°Ï. */
710 /***en Character ranges corresponding to the line of the glyph. */
711 /***ja ¥°¥ê¥Õ¤ÎÎó¤ËÂбþ¤¹¤ëʸ»ú¤ÎÈÏ°Ï. */
712 int line_from, line_to;
714 /***en X/Y coordinates of the glyph. */
715 /***ja ¥°¥ê¥Õ¤Î X/Y ºÂɸ. */
718 /***en Metric of the glyph. */
719 /***ja ¥°¥ê¥Õ¤ÎÀ£Ë¡. */
722 /***en Font used for the glyph. Set to NULL if no font is found for
724 /***ja ¤½¤Î¥°¥ê¥ÕÍѤ˻Ȥï¤ì¤ë¥Õ¥©¥ó¥È¡£¸«¤Ä¤«¤é¤Ê¤±¤ì¤Ð NULL¡£
728 /***en Character ranges corresponding to logically previous and next
729 glyphs. Note that we do not need the members prev_to and
730 next_from because they must be the same as the members from and
732 /***ja ÏÀÍýŪ¤ÊÁ°¸å¤Î¥°¥ê¥Õ¤ËÂбþ¤¹¤ëʸ»ú¤ÎÈÏ°Ï¡£¥á¥ó¥Ð prev_to ¤È
733 next_from ¤Ï¡¢¤½¤ì¤¾¤ì¥á¥ó¥Ð from ¤Èto ¤ÈƱ¤¸¤Ç¤Ê¤¯¤Æ¤Ï¤Ê¤é¤Ê¤¤
734 ¤¿¤áÉÔÍפǤ¢¤ë¤³¤È¤ËÃí°Õ¡£ */
735 int prev_from, next_to;
737 /***en Character ranges corresponding to visually left and right
739 /***ja »ë³ÐŪ¤Êº¸±¦¤Î¥°¥ê¥Õ¤ËÂбþ¤¹¤ëʸ»ú¤ÎÈÏ°Ï¡£ */
740 int left_from, left_to;
741 int right_from, right_to;
748 @brief Type of text items.
750 The type #MDrawTextItem is for @e textitem objects.
751 Each textitem contains an M-text and some other information to
752 control the drawing of the M-text. */
755 @brief textitem ¤Î·¿Àë¸À.
757 #MDrawTextItem ¤Ï @e ¥Æ¥¥¹¥È¥¢¥¤¥Æ¥à ¥ª¥Ö¥¸¥§¥¯¥ÈÍѤη¿¤Ç¤¢¤ë¡£³Æ
758 ¥Æ¥¥¹¥È¥¢¥¤¥Æ¥à¤Ï¡¢1¸Ä¤Î M-text ¤È¡¢¤½¤Îɽ¼¨¤òÀ©¸æ¤¹¤ë¤¿¤á¤Î³Æ¼ï
761 @latexonly \IPAlabel{MTextItem} @endlatexonly */
769 /***en Optional change in the position (in the unit of pixel) along
770 the X-axis before the M-text is drawn. */
771 /***ja M-text ɽ¼¨Á°¤Ë¹Ô¤Ê¤¦X¼´Êý¸þ¤Î°ÌÃÖÄ´À° (¥Ô¥¯¥»¥ëñ°Ì) */
774 /***en Pointer to a face object. Each property of the face, if not
775 Mnil, overrides the same property of face(s) specified as a text
777 /***ja ¥Õ¥§¡¼¥¹¥ª¥Ö¥¸¥§¥¯¥È¤Ø¤Î¥Ý¥¤¥ó¥¿¡£¥Õ¥§¡¼¥¹¤Î³Æ¥×¥í¥Ñ¥Æ¥£¤Ï
778 Mnil ¤Ç¤Ê¤±¤ì¤Ð <mt> ¤Ç»ØÄꤵ¤ì¤¿¥Õ¥§¡¼¥¹¤ÎƱ¤¸¥×¥í¥Ñ¥Æ¥£¤ËÍ¥Àè
782 /***en Pointer to a draw control object. The M-text <mt> is drawn
783 by mdraw_text_with_control () with this control object. */
784 /***ja ɽ¼¨À©¸æ¥ª¥Ö¥¸¥§¥¯¥È¤Ø¤Î¥Ý¥¤¥ó¥¿¡£ mdraw_text_with_control ()
785 ¤Ï¤³¤Î¥ª¥Ö¥¸¥§¥¯¥È¤òÍѤ¤¤Æ M-text <mt> ¤òɽ¼¨¤¹¤ë¡£ */
786 MDrawControl *control;
792 extern int mdraw_text (MFrame *frame, MDrawWindow win, int x, int y,
793 MText *mt, int from, int to);
795 extern int mdraw_image_text (MFrame *frame, MDrawWindow win, int x, int y,
796 MText *mt, int from, int to);
798 extern int mdraw_text_with_control (MFrame *frame, MDrawWindow win,
799 int x, int y, MText *mt, int from, int to,
800 MDrawControl *control);
802 extern int mdraw_coordinates_position (MFrame *frame,
803 MText *mt, int from, int to,
804 int x, int y, MDrawControl *control);
806 extern int mdraw_text_extents (MFrame *frame,
807 MText *mt, int from, int to,
808 MDrawControl *control,
809 MDrawMetric *overall_ink_return,
810 MDrawMetric *overall_logical_return,
811 MDrawMetric *overall_line_return);
813 extern int mdraw_text_per_char_extents (MFrame *frame,
814 MText *mt, int from, int to,
815 MDrawControl *control,
816 MDrawMetric *ink_array_return,
817 MDrawMetric *logical_array_return,
819 int *num_chars_return,
820 MDrawMetric *overall_ink_return,
821 MDrawMetric *overall_logical_return);
823 extern int mdraw_glyph_info (MFrame *frame, MText *mt, int from, int pos,
824 MDrawControl *control, MDrawGlyphInfo *info);
826 extern void mdraw_text_items (MFrame *frame, MDrawWindow win, int x, int y,
827 MDrawTextItem *items, int nitems);
829 extern void mdraw_per_char_extents (MFrame *frame, MText *mt,
830 MDrawMetric *array_return,
831 MDrawMetric *overall_return);
833 extern int mdraw_default_line_break (MText *mt, int pos,
834 int from, int to, int line, int y);
836 extern void mdraw_clear_cache (MText *mt);
838 /* end of drawing module */
841 /*** @ingroup m17nGUI */
842 /***en @defgroup m17nInputMethodWin Input Method (GUI) */
843 /***ja @defgroup m17nInputMethodWin ÆþÎϥ᥽¥Ã¥É (GUI) */
846 extern MInputDriver minput_gui_driver;
849 /*** @ingroup m17nInputMethodWin */
851 @brief Type of the argument to the function minput_create_ic ().
853 The type #MInputGUIArgIC is for the argument $ARG of the function
854 minput_create_ic () to create an input context of an internal
858 @brief ´Ø¿ô minput_create_ic () ¤Î°ú¿ô¤Î·¿Àë¸À.
860 #MInputGUIArgIC ¤Ï¡¢´Ø¿ô minput_create_ic () ¤¬ÆâÉôÆþÎϥ᥽¥Ã¥É¤Î
861 ÆþÎÏ¥³¥ó¥Æ¥¯¥¹¥È¤òÀ¸À®¤¹¤ëºÝ¤Î¡¢°ú¿ô $ARG ÍѤη¿¤Ç¤¢¤ë¡£ */
865 /***en Frame of the client. */
866 /***ja ¥¯¥é¥¤¥¢¥ó¥È¤Î¥Õ¥ì¡¼¥à */
869 /***en Window on which to display the preedit and status text. */
870 /***ja preedit ¥Æ¥¥¹¥È¤È status ¥Æ¥¥¹¥È¤òɽ¼¨¤¹¤ë¥¦¥£¥ó¥É¥¦ */
873 /***en Window that the input context has a focus on. */
874 /***ja ÆþÎÏ¥³¥ó¥Æ¥¯¥¹¥È¤¬¥Õ¥©¡¼¥«¥¹¤ò¤ª¤¤¤Æ¤¤¤ë¥¦¥£¥ó¥É¥¦ */
880 extern MSymbol minput_event_to_key (MFrame *frame, void *event);
882 /* end of input module */
884 /* end of window modules */
887 extern MFace *mdebug_dump_face (MFace *face, int indent);
888 extern MFont *mdebug_dump_font (MFont *font);
889 extern MFontset *mdebug_dump_fontset (MFontset *fontset, int indent);
895 #endif /* _M17N_GUI_H_ */