1 /* Copyright (C) 2003, 2004
2 National Institute of Advanced Industrial Science and Technology (AIST)
3 Registration Number H15PRO112
4 See the end for copying conditions. */
8 @page mdbFontset Fontset
10 @section fontset-description DESCRIPTION
12 The m17n library loads a fontset definition from the m17n database by
13 the tags \<fontset, FONTSET-NAME\>. The plist format of the data is
17 FONTSET ::= PER-SCRIPT * PER-CHARSET * FALLBACK *
19 PER-SCRIPT ::= '(' SCRIPT PER-LANGUAGE + ')'
21 PER-LANGUAGE ::= '(' LANGUAGE FONT-SPEC-ELEMENT + ')'
23 PER-CHARSET ::= '(' CHARSET FONT-SPEC-ELEMENT + ')'
25 FALLBACK ::= FONT-SPEC-ELEMENT
27 FONT-SPEC-ELEMENT ::= '(' FONT-SPEC [ FLT-NAME ] ')'
31 [ WEIGHT [ STYLE [ STRETCH [ ADSTYLE ]]]]]
35 @c SCRIPT is a symbol of script name (e.g. latin, han) or @c nil. @c
36 LANGUAGE is a two-letter symbol of language name code defined by ISO
37 639 (e.g. ja, zh) or @c nil.
39 @c FONT-SPEC is to specify properties of a font. @c FOUNDRY to @c
40 REGISTRY are symbols corresponding to #Mfoundry to #Mregistry property
41 of a font. See @ref m17nFont for the meaning of each property.
43 @c FLT-NAME is a name of Font Layout Table (@ref mdbFLT).
45 @section fontset-example EXAMPLE
47 This is an example of @c PER_SCRIPT.
59 It instructs the font selector to use a font of registry
60 "jisx0208.1983-0" for a "han" character (i.e. a character whose
61 #Mscript property is 'han') if the character has #Mlanguage text
62 property "ja" in an M-text and the character is in the repertories of
63 such fonts. Otherwise, try a font of registry "gb2312.1980-0" or
64 "big5-0". If that "han" character does not have #Mlanguage text
65 property, try all three fonts.
67 See the function mdraw_text () for the detail of how a font is
72 Copyright (C) 2003, 2004
73 National Institute of Advanced Industrial Science and Technology (AIST)
74 Registration Number H15PRO112
76 This file is part of the m17n database; a sub-part of the m17n
79 The m17n library is free software; you can redistribute it and/or
80 modify it under the terms of the GNU Lesser General Public License
81 as published by the Free Software Foundation; either version 2.1 of
82 the License, or (at your option) any later version.
84 The m17n library is distributed in the hope that it will be useful,
85 but WITHOUT ANY WARRANTY; without even the implied warranty of
86 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
87 Lesser General Public License for more details.
89 You should have received a copy of the GNU Lesser General Public
90 License along with the m17n library; if not, write to the Free
91 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA