1 /* fontset.c -- fontset module.
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
24 @addtogroup m17nFontset
25 @brief A fontset is an object that maps a character to fonts.
27 A @e fontset is an object of the type @c MFontset. When drawing an
28 M-text, a fontset provides rules to select a font for each
29 character in the M-text according to the following information.
31 @li The script character property of a character.
32 @li The language text property of a character.
33 @li The charset text property of a character.
35 The documentation of mdraw_text () describes how that information is
38 /***ja @addtogroup m17nFontset
40 @brief ¥Õ¥©¥ó¥È¥»¥Ã¥È¤Ïʸ»ú¤«¤é¥Õ¥©¥ó¥È¤Ø¤ÎÂбþÉÕ¤±¤ò¹Ô¤¦¥ª¥Ö¥¸¥§¥¯¥È¤Ç¤¢¤ë.
42 @e ¥Õ¥©¥ó¥È¥»¥Ã¥È ¤Ï @c MFontset ·¿¤Î¥ª¥Ö¥¸¥§¥¯¥È¤Ç¤¢¤ë¡£M-text ¤ò
43 ɽ¼¨¤¹¤ëºÝ¡¢¥Õ¥©¥ó¥È¥»¥Ã¥È¤Ï M-text Ãæ¤Î¸Ä¡¹¤Îʸ»ú¤ËÂФ·¤Æ¤É¤Î¥Õ¥©
44 ¥ó¥È¤òÍѤ¤¤ë¤«¤Îµ¬Â§¤ò¡¢°Ê²¼¤Î¾ðÊó¤Ë½¾¤Ã¤ÆÍ¿¤¨¤ë¡£
46 @li ʸ»ú¤Îʸ»ú¥×¥í¥Ñ¥Æ¥£ "¥¹¥¯¥ê¥×¥È"
47 @li ʸ»ú¤Î¥Æ¥¥¹¥È¥×¥í¥Ñ¥Æ¥£ "¸À¸ì"
48 @li ʸ»ú¤Î¥Æ¥¥¹¥È¥×¥í¥Ñ¥Æ¥£ "ʸ»ú¥»¥Ã¥È"
50 ¤³¤ì¤é¤Î¾ðÊ󤬤ɤΤ褦¤ËÍѤ¤¤é¤ì¤ë¤«¤Ï mdraw_text () ¤ÎÀâÌÀ¤ò»²¾È
57 #if !defined (FOR_DOXYGEN) || defined (DOXYGEN_INTERNAL_MODULE)
58 /*** @addtogroup m17nInternal
67 #include "m17n-misc.h"
71 #include "character.h"
73 #include "internal-gui.h"
81 /* Name of the fontset. */
84 /* Initialized to 0, and incremented by one each time the fontset is
88 /* Database from which to load the contents of the fontset. Once
89 loaded, this member is set to NULL. */
92 /* SCRIPT vs PER-LANGUAGE (which is a plist LANGUAGE vs FONT-GROUP) */
95 /* CHARSET vs FONT-GROUP */
101 /* Plist of Mt vs font specs. */
102 MPlist *font_spec_list;
105 static MFontset *default_fontset;
107 static MPlist *fontset_list;
109 struct MRealizedFontset
111 /* Fontset from which the realized fontset is realized. */
114 /* Initialized to <fontset>->tick. */
117 /* Font spec extracted from a face. */
120 /* The frame on which the realized fontset is realized. */
132 load_font_group (MPlist *plist, MPlist *elt, MPlist *spec_list)
136 /* ELT ::= ( FONT-SPEC-LIST [ LAYOUTER ] ) ... */
138 MFont font, *spec = NULL;
139 MSymbol layouter_name;
141 if (! MPLIST_PLIST_P (elt))
142 MWARNING (MERROR_FONTSET);
143 elt2 = MPLIST_PLIST (elt);
144 if (! MPLIST_PLIST_P (elt2))
145 MWARNING (MERROR_FONTSET);
146 mfont__set_spec_from_plist (&font, MPLIST_PLIST (elt2));
147 MPLIST_DO (p, spec_list)
149 if (! memcmp (MPLIST_VAL (p), &font, sizeof (MFont)))
151 spec = MPLIST_VAL (p);
157 MSTRUCT_MALLOC (spec, MERROR_FONTSET);
159 mplist_add (spec_list, Mt, spec);
161 elt2 = MPLIST_NEXT (elt2);
163 if (MPLIST_SYMBOL_P (elt2))
164 layouter_name = MPLIST_SYMBOL (elt2);
165 if (layouter_name == Mnil)
167 plist = mplist_add (plist, layouter_name, spec);
170 /* ANSI-C requires some statement after a label. */
176 /* Load FONTSET->per_script from the data in FONTSET->mdb. */
179 load_fontset_contents (MFontset *fontset)
181 MPlist *per_script, *per_charset, *fallback, *spec_list, *font_group;
182 MSymbol script, lang;
183 MPlist *fontset_def, *plist;
185 fontset->per_script = per_script = mplist ();
186 fontset->per_charset = per_charset = mplist ();
187 fontset->fallback = fallback = mplist ();
188 fontset->font_spec_list = spec_list = mplist ();
189 if (! (fontset_def = (MPlist *) mdatabase_load (fontset->mdb)))
192 MPLIST_DO (plist, fontset_def)
194 /* PLIST ::= ( SCRIPT ( LANGUAGE FONT-SPEC-ELT ... ) ... )
195 | (CHARSET FONT-SPEC-ELT ...)
199 if (! MPLIST_PLIST_P (plist))
200 MWARNING (MERROR_FONTSET);
201 elt = MPLIST_PLIST (plist);
202 if (! MPLIST_SYMBOL_P (elt))
203 MWARNING (MERROR_FONTSET);
204 script = MPLIST_SYMBOL (elt);
205 elt = MPLIST_NEXT (elt);
206 if (! MPLIST_PLIST_P (elt))
207 MWARNING (MERROR_FONTSET);
209 fallback = load_font_group (fallback, elt, spec_list);
210 else if (MPLIST_PLIST_P (MPLIST_PLIST (elt)))
212 font_group = mplist_find_by_key (fontset->per_charset, script);
215 font_group = mplist ();
216 per_charset = mplist_add (per_charset, script, font_group);
218 load_font_group (font_group, elt, spec_list);
222 MPlist *per_lang = mplist_find_by_key (fontset->per_script, script);
226 per_lang = mplist ();
227 per_script = mplist_add (per_script, script, per_lang);
232 /* ELT ::= ( LANGUAGE FONT-DEF ...) ... */
235 if (! MPLIST_PLIST_P (elt))
236 MWARNING (MERROR_FONTSET);
237 elt2 = MPLIST_PLIST (elt);
238 if (! MPLIST_SYMBOL_P (elt2))
239 MWARNING (MERROR_FONTSET);
240 lang = MPLIST_SYMBOL (elt2);
243 font_group = mplist_find_by_key (per_lang, lang);
246 font_group = mplist ();
247 mplist_add (per_lang, lang, font_group);
249 elt2 = MPLIST_NEXT (elt2);
250 load_font_group (font_group, elt2, spec_list);
256 /* ANSI-C requires some statement after a label. */
260 M17N_OBJECT_UNREF (fontset_def);
265 free_fontset (void *object)
267 MFontset *fontset = (MFontset *) object;
268 MPlist *plist, *pl, *p;
270 if (fontset->per_script)
272 MPLIST_DO (plist, fontset->per_script)
274 MPLIST_DO (pl, MPLIST_PLIST (plist))
276 p = MPLIST_PLIST (pl);
277 M17N_OBJECT_UNREF (p);
279 pl = MPLIST_PLIST (plist);
280 M17N_OBJECT_UNREF (pl);
282 M17N_OBJECT_UNREF (fontset->per_script);
284 if (fontset->per_charset)
286 MPLIST_DO (plist, fontset->per_charset)
288 pl = MPLIST_PLIST (plist);
289 M17N_OBJECT_UNREF (pl);
291 M17N_OBJECT_UNREF (fontset->per_charset);
293 if (fontset->fallback)
294 M17N_OBJECT_UNREF (fontset->fallback);
295 plist = mplist_find_by_key (fontset_list, fontset->name);
299 if (fontset->font_spec_list)
301 if (((M17NObject *) (fontset->font_spec_list))->ref_count == 1)
302 MPLIST_DO (plist, fontset->font_spec_list)
303 free (MPLIST_VAL (plist));
304 M17N_OBJECT_UNREF (fontset->font_spec_list);
310 realize_font_group (MFrame *frame, MFont *request, MPlist *font_group,
313 MPlist *plist = MPLIST_VAL (font_group), *pl, *p;
315 mplist_set (font_group, Mnil, NULL);
316 MPLIST_DO (pl, plist)
318 MSymbol layouter = MPLIST_KEY (pl);
319 MFont this_request = *request;
320 MRealizedFont *rfont;
322 mfont__resize (MPLIST_VAL (pl), &this_request);
323 rfont = mfont__select (frame, MPLIST_VAL (pl), &this_request,
324 size, layouter == Mt ? Mnil : layouter);
328 MPLIST_DO (p, font_group)
329 if (((MRealizedFont *) (MPLIST_VAL (p)))->score > rfont->score)
331 mplist_push (p, Mt, rfont);
337 realize_fontset_elements (MFrame *frame, MRealizedFontset *realized,
338 MFontset *fontset, MFont *request)
340 MPlist *per_script, *per_lang, *per_charset, *font_group;
343 realized->fontset = fontset;
344 realized->tick = fontset->tick;
345 realized->spec = *request;
346 realized->frame = frame;
347 realized->per_script = per_script = mplist ();
348 MPLIST_DO (plist, fontset->per_script)
350 per_lang = mplist ();
351 per_script = mplist_add (per_script, MPLIST_KEY (plist), per_lang);
352 MPLIST_DO (pl, MPLIST_PLIST (plist))
354 font_group = mplist ();
355 mplist_add (font_group, Mplist, MPLIST_VAL (pl));
356 per_lang = mplist_add (per_lang, MPLIST_KEY (pl), font_group);
360 realized->per_charset = per_charset = mplist ();
361 MPLIST_DO (plist, fontset->per_charset)
363 font_group = mplist ();
364 mplist_add (font_group, Mplist, MPLIST_VAL (plist));
365 per_charset = mplist_add (per_charset, MPLIST_KEY (plist), font_group);
368 realized->fallback = mplist ();
369 mplist_add (realized->fallback, Mplist, fontset->fallback);
374 free_realized_fontset_elements (MRealizedFontset *realized)
376 MPlist *plist, *pl, *p;
377 MRealizedFont *rfont;
379 if (realized->per_script)
381 MPLIST_DO (plist, realized->per_script)
383 MPLIST_DO (pl, MPLIST_PLIST (plist))
385 MPLIST_DO (p, MPLIST_PLIST (pl))
386 if ((rfont = MPLIST_VAL (p)) && ! rfont->frame)
388 p = MPLIST_PLIST (pl);
389 M17N_OBJECT_UNREF (p);
391 pl = MPLIST_PLIST (plist);
392 M17N_OBJECT_UNREF (pl);
394 M17N_OBJECT_UNREF (realized->per_script);
396 if (realized->per_charset)
398 MPLIST_DO (plist, realized->per_charset)
400 MPLIST_DO (pl, MPLIST_PLIST (plist))
401 if ((rfont = MPLIST_VAL (pl)) && ! rfont->frame)
403 pl = MPLIST_PLIST (plist);
404 M17N_OBJECT_UNREF (pl);
406 M17N_OBJECT_UNREF (realized->per_charset);
408 if (realized->fallback)
410 MPLIST_DO (plist, realized->fallback)
411 if ((rfont = MPLIST_VAL (plist)) && ! rfont->frame)
413 M17N_OBJECT_UNREF (realized->fallback);
418 update_fontset_elements (MRealizedFontset *realized)
420 free_realized_fontset_elements (realized);
421 realize_fontset_elements (realized->frame, realized, realized->fontset,
431 mfont__fontset_init ()
433 Mfontset = msymbol ("fontset");
434 Mfontset->managing_key = 1;
435 fontset_list = mplist ();
436 default_fontset = mfontset ("default");
437 if (! default_fontset->mdb)
442 mfont_put_prop (&font, Mregistry, msymbol ("iso8859-1"));
443 mfontset_modify_entry (default_fontset, Mnil, Mnil, Mnil,
445 mfont_put_prop (&font, Mregistry, msymbol ("iso10646-1"));
446 mfontset_modify_entry (default_fontset, Mnil, Mnil, Mnil,
454 mfont__fontset_fini ()
456 while (! MPLIST_TAIL_P (fontset_list))
457 free_fontset ((MFontset *) MPLIST_VAL (fontset_list));
458 M17N_OBJECT_UNREF (fontset_list);
464 mfont__realize_fontset (MFrame *frame, MFontset *fontset, MFace *face)
466 MRealizedFontset *realized;
471 load_fontset_contents (fontset);
473 mfont__set_spec_from_face (&request, face);
474 if (request.property[MFONT_SIZE] <= 0)
477 request.property[MFONT_SIZE] = 120;
479 MPLIST_DO (plist, frame->realized_fontset_list)
481 realized = (MRealizedFontset *) MPLIST_VAL (plist);
482 if (fontset->name == MPLIST_KEY (plist)
483 && ! memcmp (&request, &realized->spec, sizeof (request)))
487 MSTRUCT_MALLOC (realized, MERROR_FONTSET);
488 realize_fontset_elements (frame, realized, fontset, &request);
489 mplist_add (frame->realized_fontset_list, fontset->name, realized);
495 mfont__free_realized_fontset (MRealizedFontset *realized)
497 free_realized_fontset_elements (realized);
503 mfont__lookup_fontset (MRealizedFontset *realized, MGlyph *g, int *num,
504 MSymbol script, MSymbol language, MSymbol charset,
507 MFrame *frame = realized->frame;
508 MCharset *preferred_charset = (charset == Mnil ? NULL : MCHARSET (charset));
509 MPlist *per_charset, *per_script, *per_lang;
510 MPlist *font_groups[256], *plist;
511 int n_font_group = 0;
512 MRealizedFont *rfont;
515 if (realized->tick != realized->fontset->tick)
516 update_fontset_elements (realized);
518 if (preferred_charset
519 && (per_charset = mplist_get (realized->per_charset, charset)) != NULL)
520 font_groups[n_font_group++] = per_charset;
522 && ((per_script = mplist_find_by_key (realized->per_script, script))
525 /* We prefer font groups in this order:
526 (1) group matching LANGUAGE
527 (2) group for generic LANGUAGE
528 (3) group non-matching LANGUAGE */
529 if (language == Mnil)
531 per_lang = mplist_find_by_key (MPLIST_PLIST (per_script), language);
534 font_groups[n_font_group++] = MPLIST_PLIST (per_lang);
537 MPLIST_DO (per_lang, MPLIST_PLIST (per_script))
538 if (MPLIST_KEY (per_lang) != language)
539 font_groups[n_font_group++] = MPLIST_PLIST (per_lang);
544 plist = mplist_get (MPLIST_PLIST (per_script), Mt);
546 font_groups[n_font_group++] = plist;
548 MPLIST_DO (per_lang, MPLIST_PLIST (per_script))
549 if (MPLIST_KEY (per_lang) != language
550 && MPLIST_KEY (per_lang) != Mt)
551 font_groups[n_font_group++] = MPLIST_PLIST (per_lang);
553 font_groups[n_font_group++] = realized->fallback;
555 if (n_font_group == 1)
557 /* As we only have a fallback font group, try all the other
559 MPLIST_DO (per_script, realized->per_script)
560 MPLIST_DO (per_lang, MPLIST_PLIST (per_script))
561 font_groups[n_font_group++] = MPLIST_PLIST (per_lang);
562 MPLIST_DO (per_charset, realized->per_charset)
563 font_groups[n_font_group++] = MPLIST_PLIST (per_charset);
566 for (i = 0; i < n_font_group; i++)
570 if (MPLIST_PLIST_P (font_groups[i]))
571 realize_font_group (frame, &realized->spec, font_groups[i], size);
573 MPLIST_DO (plist, font_groups[i])
575 rfont = (MRealizedFont *) MPLIST_VAL (plist);
576 if (rfont->status < 0)
578 /* Check if this font can display all glyphs. */
579 for (j = 0; j < *num; j++)
581 g[j].code = mfont__encode_char (rfont, g[j].c);
582 if (g[j].code == MCHAR_INVALID_CODE)
587 if (rfont->status > 0
588 || mfont__open (rfont) == 0)
589 /* We found a font that can display all glyphs. */
593 if (! MPLIST_TAIL_P (plist))
597 if (i < n_font_group)
600 /* We couldn't find a font that can display all glyphs. Find one
601 that can display at least the first glyph. */
602 for (i = 0; i < n_font_group; i++)
604 MPLIST_DO (plist, font_groups[i])
606 rfont = (MRealizedFont *) MPLIST_VAL (plist);
607 if (rfont->status < 0)
609 g->code = mfont__encode_char (rfont, g->c);
610 if (g->code != MCHAR_INVALID_CODE)
612 if (rfont->status > 0
613 || mfont__open (rfont) == 0)
617 if (! MPLIST_TAIL_P (plist))
620 return (i < n_font_group ? rfont : NULL);
624 #endif /* !FOR_DOXYGEN || DOXYGEN_INTERNAL_MODULE */
629 /*** @addtogroup m17nFontset */
634 @brief Return a fontset.
636 The mfontset () function returns a pointer to a fontset object of
637 name $NAME. If $NAME is @c NULL, it returns a pointer to the
640 If no fontset has the name $NAME, a new one is created. At that
641 time, if there exists a data \<@c fontset, $NAME\> in the m17n
642 database, the fontset contents are initialized according to the
643 data. If no such data exists, the fontset contents are left
646 The macro M17N_INIT () creates the default fontset. An
647 application program can modify it before the first call of
651 This function returns a pointer to the found or newly created
654 @brief ¥Õ¥©¥ó¥È¥»¥Ã¥È¤òÊÖ¤¹.
656 ´Ø¿ô mfontset () ¤Ï̾Á° $NAME ¤ò»ý¤Ä¥Õ¥©¥ó¥È¥»¥Ã¥È¥ª¥Ö¥¸¥§¥¯¥È¤Ø¤Î
657 ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£ $NAME ¤¬ @c NULL ¤Ê¤é¤Ð¡¢¥Ç¥Õ¥©¥ë¥È¥Õ¥©¥ó¥È¥»¥Ã¥È
660 $NAME ¤È¤¤¤¦Ì¾Á°¤ò»ý¤Ä¥Õ¥©¥ó¥È¥»¥Ã¥È¤¬¤Ê¤±¤ì¤Ð¡¢¿·¤·¤¤¤â¤Î¤¬ºî¤é¤ì
661 ¤ë¡£¤½¤ÎºÝ¡¢m17n ¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ë \<@c fontset, $NAME\> ¤È¤¤¤¦¥Ç¡¼¥¿
662 ¤¬¤¢¤ì¤Ð¡¢¥Õ¥©¥ó¥È¥»¥Ã¥È¤Ï¤½¤Î¥Ç¡¼¥¿¤Ë±è¤Ã¤Æ½é´ü²½¤µ¤ì¤ë¡£¤Ê¤±¤ì¤Ð¡¢
665 ¥Þ¥¯¥í M17N_INIT () ¤Ï¥Ç¥Õ¥©¥ë¥È¤Î¥Õ¥©¥ó¥È¥»¥Ã¥È¤òºî¤ë¡£¥¢¥×¥ê¥±¡¼
666 ¥·¥ç¥ó¥×¥í¥°¥é¥à¤Ï mframe () ¤ò½é¤á¤Æ¸Æ¤Ö¤Þ¤Ç¤Ï¥Ç¥Õ¥©¥ë¥È¥Õ¥©¥ó¥È
667 ¥»¥Ã¥È¤òÊѹ¹¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
670 ¤³¤Î´Ø¿ô¤Ï¸«¤Ä¤«¤Ã¤¿¡¢¤¢¤ë¤¤¤Ïºî¤Ã¤¿¥Õ¥©¥ó¥È¥»¥Ã¥È¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
674 mfontset (char *name)
680 fontset = default_fontset;
683 sym = msymbol (name);
684 fontset = mplist_get (fontset_list, sym);
687 M17N_OBJECT (fontset, free_fontset, MERROR_FONTSET);
689 fontset->mdb = mdatabase_find (Mfontset, sym, Mnil, Mnil);
692 fontset->per_script = mplist ();
693 fontset->per_charset = mplist ();
694 fontset->fallback = mplist ();
696 mplist_put (fontset_list, sym, fontset);
699 M17N_OBJECT_REF (fontset);
706 @brief Return the name of a fontset.
708 The mfontset_name () function returns the name of fontset $FONTSET. */
710 @brief ¥Õ¥©¥ó¥È¥»¥Ã¥È¤Î̾Á°¤òÊÖ¤¹.
712 ´Ø¿ô mfontset_name () ¤Ï¥Õ¥©¥ó¥È¥»¥Ã¥È $FONTSET ¤Î̾Á°¤òÊÖ¤¹¡£ */
714 mfontset_name (MFontset *fontset)
716 return fontset->name;
722 @brief Make a copy of a fontset.
724 The mfontset_copy () function makes a copy of fontset $FONTSET, gives it a
725 name $NAME, and returns a pointer to the created copy. $NAME must
726 not be a name of existing fontset. In such case, this function
727 returns NULL without making a copy. */
729 @brief ¥Õ¥©¥ó¥È¥»¥Ã¥È¤Î¥³¥Ô¡¼¤òºî¤ë.
731 ´Ø¿ô mfontset_copy () ¤Ï¥Õ¥©¥ó¥È¥»¥Ã¥È $FONTSET ¤Î¥³¥Ô¡¼¤òºî¤Ã¤Æ¡¢
732 ̾Á° $NAME ¤òÍ¿¤¨¡¢¤½¤Î¥³¥Ô¡¼¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£$NAME ¤Ï´û¸¤Î
733 ¥Õ¥©¥ó¥È¥»¥Ã¥È¤Î̾Á°¤Ç¤¢¤Ã¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£¤½¤Î¾ì¹ç¤Ë¤Ï¥³¥Ô¡¼¤òºî¤é¤º
737 mfontset_copy (MFontset *fontset, char *name)
739 MSymbol sym = msymbol (name);
740 MFontset *copy = mplist_get (fontset_list, sym);
745 M17N_OBJECT (copy, free_fontset, MERROR_FONTSET);
748 if (fontset->per_script)
750 copy->per_script = mplist ();
751 MPLIST_DO (plist, fontset->per_script)
753 MPlist *new = mplist ();
755 MPLIST_DO (pl, MPLIST_PLIST (plist))
756 mplist_add (new, MPLIST_KEY (pl), mplist_copy (MPLIST_PLIST (pl)));
757 mplist_add (copy->per_script, MPLIST_KEY (plist), new);
760 if (fontset->per_charset)
762 copy->per_charset = mplist ();
763 MPLIST_DO (plist, fontset->per_charset)
764 mplist_add (copy->per_charset, MPLIST_KEY (plist),
765 mplist_copy (MPLIST_PLIST (plist)));
767 if (fontset->fallback)
768 copy->fallback = mplist_copy (fontset->fallback);
770 copy->font_spec_list = fontset->font_spec_list;
771 M17N_OBJECT_REF (copy->font_spec_list);
773 mplist_put (fontset_list, sym, copy);
774 M17N_OBJECT_REF (copy);
781 @brief Modify the contents of a fontset.
783 The mfontset_modify_entry () function associates, in fontset
784 $FONTSET, a copy of $FONT with the $SCRIPT / $LANGUAGE pair or
787 Each font in a fontset is associated with a particular
788 script/language pair, with a particular charset, or with the
789 symbol @c Mnil. The fonts that are associated with the same item
792 If $SCRIPT is not @c Mnil, it must be a symbol identifying a
793 script. In this case, $LANGUAGE is either a symbol identifying a
794 language or @c Mnil, and $FONT is associated with the $SCRIPT /
797 If $CHARSET is not @c Mnil, it must be a symbol representing a
798 charset object. In this case, $FONT is associated with that
801 If both $SCRIPT and $CHARSET are not @c Mnil, two copies of $FONT
802 are created. Then one is associated with the $SCRIPT / $LANGUAGE
803 pair and the other with that charset.
805 If both $SCRIPT and $CHARSET are @c Mnil, $FONT is associated with
806 @c Mnil. This kind of fonts are called @e fallback @e fonts.
808 The argument $HOW specifies the priority of $FONT. If $HOW is
809 positive, $FONT has the highest priority in the group of fonts
810 that are associated with the same item. If $HOW is negative,
811 $FONT has the lowest priority. If $HOW is zero, $FONT becomes the
812 only available font for the associated item; all the other fonts
813 are removed from the group.
815 If $LAYOUTER_NAME is not @c Mnil, it must be a symbol
816 representing a @ref flt. In that case, if $FONT is selected for
817 drawing an M-text, that font layout table is used to generate a
818 glyph code sequence from a character sequence.
821 If the operation was successful, mfontset_modify_entry () returns 0.
822 Otherwise it returns -1 and assigns an error code to the external
823 variable #merror_code. */
826 @brief ¥Õ¥©¥ó¥È¥»¥Ã¥È¤ÎÆâÍƤòÊѹ¹¤¹¤ë.
828 ´Ø¿ô mfontset_modify_entry () ¤Ï¡¢$LANGUAGE ¤È $SCRIPT ¤ÎÁȤ߹ç¤ï
829 ¤»¤Þ¤¿¤Ï $CHARSET ¤ËÂФ·¤Æ $FONT ¤Î¥³¥Ô¡¼¤ò»È¤¦¤è¤¦¤Ë¡¢¥Õ¥©¥ó¥È¥»¥Ã
830 ¥È $FONTSET ¤òÀßÄꤹ¤ë¡£
832 ¥Õ¥©¥ó¥È¥»¥Ã¥È¤Î³Æ¥Õ¥©¥ó¥È¤Ï¡¢ÆÃÄê¤Î¥¹¥¯¥ê¥×¥È¤È¸À¸ì¤Î¥Ú¥¢¡¢ÆÃÄê¤Î
833 ʸ»ú¥»¥Ã¥È¡¢¥·¥ó¥Ü¥ë @c Mnil ¤Î¤¤¤º¤ì¤«¤È´ØÏ¢ÉÕ¤±¤é¤ì¤Æ¤¤¤ë¡£Æ±¤¸
834 ¤â¤Î¤È´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥Õ¥©¥ó¥È¤Ï¥°¥ë¡¼¥×¤ò¹½À®¤¹¤ë¡£
836 $SCRIPT ¤Ï @c Mnil ¤Ç¤¢¤ë¤«¡¢¥¹¥¯¥ê¥×¥È¤òÆÃÄꤹ¤ë¥·¥ó¥Ü¥ë¤Ç¤¢¤ë¡£
837 ¥·¥ó¥Ü¥ë¤Ç¤¢¤ë¾ì¹ç¤Ë¤Ï¡¢$LANGUAGE ¤Ï¸À¸ì¤òÆÃÄꤹ¤ë¥·¥ó¥Ü¥ë¤« @c
838 Mnil ¤Ç¤¢¤ê¡¢$FONT ¤Ïthe $SCRIPT / $LANGUAGE ¥Ú¥¢¤Ë´ØÏ¢ÉÕ¤±¤é¤ì¤ë¡£
840 $CHARSET ¤Ï @c Mnil ¤Ç¤¢¤ë¤«¡¢Ê¸»ú¥»¥Ã¥È¥ª¥Ö¥¸¥§¥¯¥È¤òɽ¤¹¥·¥ó¥Ü¥ë
841 ¤Ç¤¢¤ë¡£¥·¥ó¥Ü¥ë¤Ç¤¢¤ë¾ì¹ç¤Ë¤Ï $FONT ¤Ï¤½¤Îʸ»ú¥»¥Ã¥È¤È´ØÏ¢ÉÕ¤±¤é¤ì
844 $SCRIPT ¤È $CHARSET ¤ÎÁÐÊý¤¬ @c Mnil ¤Ç¤Ê¤¤¾ì¹ç¤Ë¤Ï $FONT ¤Î¥³¥Ô¡¼
845 ¤¬£²¤Äºî¤é¤ì¡¢¤½¤ì¤¾¤ì $SCRIPT / $LANGUAGE ¥Ú¥¢¤Èʸ»ú¥»¥Ã¥È¤Ë´ØÏ¢
848 $SCRIPT ¤È $CHARSET ¤ÎÁÐÊý¤¬ @c Mnil ¤Ê¤é¤Ð¡¢ $FONT ¤Ï @c Mnil ¤È
849 ´ØÏ¢ÉÕ¤±¤é¤ì¤ë¡£¤³¤Î¼ï¤Î¥Õ¥©¥ó¥È¤Ï @e fallback @e font ¤È¸Æ¤Ð¤ì¤ë¡£
851 °ú¿ô $HOW ¤Ï $FONT ¤ÎÍ¥ÀèÅÙ¤ò»ØÄꤹ¤ë¡£$HOW ¤¬Àµ¤Ê¤é¤Ð¡¢$FONT ¤ÏƱ
852 ¤¸¤â¤Î¤È´ØÏ¢ÉÕ¤±¤é¤ì¤¿¥°¥ë¡¼¥×Ãæ¤ÇºÇ¹â¤ÎÍ¥ÀèÅÙ¤ò»ý¤Ä¡£$HOW ¤¬Éé¤Ê
853 ¤é¤Ð¡¢ºÇÄã¤ÎÍ¥ÀèÅÙ¤ò»ý¤Ä¡£$HOW ¤¬ 0 ¤Ê¤é¤Ð¡¢$FONT ¤Ï´ØÏ¢ÉÕ¤±¤é¤ì¤¿
854 ¤â¤Î¤ËÂФ¹¤ëÍ£°ì¤ÎÍøÍѲÄǽ¤Ê¥Õ¥©¥ó¥È¤È¤Ê¤ê¡¢Â¾¤Î¥Õ¥©¥ó¥È¤Ï¥°¥ë¡¼¥×
857 $LAYOUTER_NAME ¤Ï @c Mnil ¤Ç¤¢¤ë¤«¡¢@ref flt ¤ò¼¨¤¹¥·¥ó¥Ü¥ë¤Ç¤¢¤ë¡£
858 ¥·¥ó¥Ü¥ë¤Ç¤¢¤ì¤Ð¡¢$FONT ¤òÍѤ¤¤ÆM-text ¤òɽ¼¨¤¹¤ëºÝ¤Ë¤Ï¡¢¤½¤Î FONT
859 LAYOUT TABLE ¤ò»È¤Ã¤Æʸ»úÎ󤫤饰¥ê¥Õ¥³¡¼¥ÉÎó¤òÀ¸À®¤¹¤ë¡£
862 ½èÍý¤¬À®¸ù¤·¤¿¤È¤¡¢mfontset_modify_entry () ¤Ï 0 ¤òÊÖ¤¹¡£
863 ¼ºÇÔ¤·¤¿¤È¤¤Ï -1 ¤òÊÖ¤·¡¢³°ÉôÊÑ¿ô #merror_code ¤Ë¥¨¥é¡¼¥³¡¼¥É¤ò
871 mfontset_modify_entry (MFontset *fontset,
872 MSymbol script, MSymbol language, MSymbol charset,
873 MFont *spec, MSymbol layouter_name,
876 MPlist *per_lang, *plist[3], *pl;
881 load_fontset_contents (fontset);
883 if (! fontset->font_spec_list)
884 fontset->font_spec_list = mplist ();
886 MPLIST_DO (pl, fontset->font_spec_list)
888 if (! memcmp (MPLIST_VAL (pl), spec, sizeof (MFont)))
890 font = MPLIST_VAL (pl);
898 mplist_add (fontset->font_spec_list, Mt, font);
904 if (language == Mnil)
906 per_lang = mplist_get (fontset->per_script, script);
908 mplist_add (fontset->per_script, script, per_lang = mplist ());
909 plist[i] = mplist_get (per_lang, language);
911 mplist_add (per_lang, language, plist[i] = mplist ());
916 plist[i] = mplist_get (fontset->per_charset, charset);
918 mplist_add (fontset->per_charset, charset, plist[i] = mplist ());
921 if (script == Mnil && charset == Mnil)
923 plist[i++] = fontset->fallback;
926 if (layouter_name == Mnil)
928 for (i--; i >= 0; i--)
931 mplist_push (plist[i], layouter_name, font);
933 mplist_add (plist[i], layouter_name, font);
936 mplist_set (plist[i], Mnil, NULL);
937 mplist_add (plist[i], layouter_name, font);
948 @brief Lookup a fontset.
950 The mfontset_lookup () function lookups $FONTSET and returns a
951 plist that describes the contents of $FONTSET corresponding to the
952 specified script, language, and charset.
954 If $SCRIPT is @c Mt, keys of the returned plist are script name
955 symbols for which some fonts are specified and values are NULL.
957 If $SCIRPT is a script symbol, the returned plist is decided by
960 If $LANGUAGE is @c Mt, keys of the plist are language name symbols
961 for which some fonts are specified and values are NULL. A key may
962 be @c Mt which means some fallback fonts are specified for the
965 If $LANGUAGE is a language name symbol, the plist is a @c
966 FONT-GROUP for the specified script and langauge.
968 If $LANGAUGE is @c Mt, the plist is fallback @c FONT-GROUP for the
971 If $SCRIPT is @c Mnil, the returned plist is decided as below.
973 If $CHARSET is @c Mt, keys of the returned plist are charset name
974 symbols for which some fonts are specified and values are NULL.
976 If $CHARSET is a charset symbol, the plist is a @c FONT-GROUP for
979 If $CHARSET is @c Mnil, the plist is a fallback @c FONT-GROUP.
981 @c FONT-GROUP is a plist whose keys are FLT name symbols (@c Mt if
982 no FLT is associated with the font) and values are pointers to
986 It returns a plist describing the contents of a fontset. The
987 plist should be freed by m17n_object_unref (). */
990 mfontset_lookup (MFontset *fontset,
991 MSymbol script, MSymbol language, MSymbol charset)
993 MPlist *plist = mplist (), *pl, *p;
996 load_fontset_contents (fontset);
999 if (! fontset->per_script)
1002 MPLIST_DO (pl, fontset->per_script)
1003 p = mplist_add (p, MPLIST_KEY (pl), NULL);
1008 if (! fontset->per_script)
1010 pl = mplist_get (fontset->per_script, script);
1017 p = mplist_add (p, MPLIST_KEY (pl), NULL);
1020 if (language == Mnil)
1022 pl = mplist_get (pl, language);
1024 else if (charset != Mnil)
1026 if (! fontset->per_charset)
1031 MPLIST_DO (pl, fontset->per_charset)
1032 p = mplist_add (p, MPLIST_KEY (pl), NULL);
1035 pl = mplist_get (fontset->per_charset, charset);
1038 pl = fontset->fallback;
1041 return mplist_copy (pl);
1047 /*** @addtogroup m17nDebug */
1052 @brief Dump a fontset.
1054 The mdebug_dump_fontset () function prints fontset $FONTSET in a human readable
1055 way to the stderr. $INDENT specifies how many columns to indent
1056 the lines but the first one.
1059 This function returns $FONTSET. */
1061 @brief ¥Õ¥©¥ó¥È¥»¥Ã¥È¤ò¥À¥ó¥×¤¹¤ë.
1063 ´Ø¿ô mdebug_dump_face () ¤Ï¥Õ¥©¥ó¥È¥»¥Ã¥È $FONTSET ¤ò stderr ¤Ë¿Í
1064 ´Ö¤Ë²ÄÆɤʷÁ¤Ç°õºþ¤¹¤ë¡£ $INDENT ¤Ï£²¹ÔÌܰʹߤΥ¤¥ó¥Ç¥ó¥È¤ò»ØÄꤹ
1068 ¤³¤Î´Ø¿ô¤Ï $FONTSET ¤òÊÖ¤¹¡£ */
1071 mdebug_dump_fontset (MFontset *fontset, int indent)
1073 char *prefix = (char *) alloca (indent + 1);
1074 MPlist *plist, *pl, *p;
1076 memset (prefix, 32, indent);
1079 fprintf (stderr, "(fontset %s", fontset->name->name);
1080 if (fontset->per_script)
1081 MPLIST_DO (plist, fontset->per_script)
1083 fprintf (stderr, "\n %s(%s", prefix, MPLIST_KEY (plist)->name);
1084 MPLIST_DO (pl, MPLIST_PLIST (plist))
1086 fprintf (stderr, "\n %s(%s", prefix, MPLIST_KEY (pl)->name);
1087 MPLIST_DO (p, MPLIST_PLIST (pl))
1089 fprintf (stderr, "\n %s(%s ", prefix,
1090 MPLIST_KEY (p)->name);
1091 mdebug_dump_font (MPLIST_VAL (p));
1092 fprintf (stderr, ")");
1094 fprintf (stderr, ")");
1096 fprintf (stderr, ")");
1098 if (fontset->per_charset)
1099 MPLIST_DO (pl, fontset->per_charset)
1101 fprintf (stderr, "\n %s(%s", prefix, MPLIST_KEY (pl)->name);
1102 MPLIST_DO (p, MPLIST_PLIST (pl))
1104 fprintf (stderr, "\n %s(%s ", prefix, MPLIST_KEY (p)->name);
1105 mdebug_dump_font (MPLIST_VAL (p));
1106 fprintf (stderr, ")");
1108 fprintf (stderr, ")");
1111 if (fontset->fallback)
1112 MPLIST_DO (p, fontset->fallback)
1114 fprintf (stderr, "\n %s(%s ", prefix, MPLIST_KEY (p)->name);
1115 mdebug_dump_font (MPLIST_VAL (p));
1116 fprintf (stderr, ")");
1119 fprintf (stderr, ")");