.\" Copyright (C) 2001 Information-technology Promotion Agency (IPA)
.\" Copyright (C) 2001-2003
.\"   National Institute of Advanced Industrial Science and Technology (AIST)
.\" This file si aprt of the m17n library documentation.
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.2 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Section, Front-Cover Texts "The m17n library documentation",
.\" and no Back-Cover Texts.  A copy of the license is included in the
.\" appendix entitled "GNU Free Documentation License".
.TH "Fontset" 3m17n "14 Jul 2007" "" "Version 1.4.0" "" "The m17n Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
Fontset \- A fontset is an object that maps a character to fonts.  

.PP
.SS "Functions"

.in +1c
.ti -1c
.RI "\fBMFontset\fP * \fBmfontset\fP (char *name)"
.br
.RI "\fIReturn a fontset. \fP"
.ti -1c
.RI "\fBMSymbol\fP \fBmfontset_name\fP (\fBMFontset\fP *fontset)"
.br
.RI "\fIReturn the name of a fontset. \fP"
.ti -1c
.RI "\fBMFontset\fP * \fBmfontset_copy\fP (\fBMFontset\fP *fontset, char *name)"
.br
.RI "\fIMake a copy of a fontset. \fP"
.ti -1c
.RI "int \fBmfontset_modify_entry\fP (\fBMFontset\fP *fontset, \fBMSymbol\fP script, \fBMSymbol\fP language, \fBMSymbol\fP charset, \fBMFont\fP *spec, \fBMSymbol\fP layouter_name, int how)"
.br
.RI "\fIModify the contents of a fontset. \fP"
.ti -1c
.RI "\fBMPlist\fP * \fBmfontset_lookup\fP (\fBMFontset\fP *fontset, \fBMSymbol\fP script, \fBMSymbol\fP language, \fBMSymbol\fP charset)"
.br
.RI "\fILookup a fontset. \fP"
.in -1c
.SH "Detailed Description"
.PP 
A \fIfontset\fP is an object of the type \fCMFontset\fP. When drawing an M-text, a fontset provides rules to select a font for each character in the M-text according to the following information.
.PP
.PD 0
.TP
The script character property of a character. 

The language text property of a character. 
.TP
The charset text property of a character.

The documentation of \fBmdraw_text()\fP describes how that information is used.