.\" Copyright (C) 2001 Information-technology Promotion Agency (IPA) .\" Copyright (C) 2001-2011 .\" National Institute of Advanced Industrial Science and Technology (AIST) .\" This file is part 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, no Front-Cover Texts, .\" and no Back-Cover Texts. A copy of the license is included in the .\" appendix entitled "GNU Free Documentation License". .TH "mfont_parse_name" 3m17n "12 Jan 2011" "Version 1.6.2" "The m17n Library" \" -*- nroff -*- .ad l .nh .SH NAME mfont_parse_name \- Create a font by parsing a fontname. .SH SYNOPSIS \fBMFont\fP* \fBmfont_parse_name\fP (const char * \fIname\fP, \fBMSymbol\fP \fIformat\fP) .SH DESCRIPTION Create a font by parsing a fontname. The .ft B mfont_parse_name() .ft R function creates a new font object. The properties are extracted fontname .ft B name\fP. .ft R .PP \fBformat .ft R specifies the format of .ft B name\fP. .ft R If .ft B format .ft R is .ft B Mx\fP, .ft R .ft B name .ft R is parsed as XLFD (X Logical Font Description). If .ft B format .ft R is .ft B Mfontconfig\fP, .ft R .ft B name .ft R is parsed as Fontconfig's textual representation of font. If .ft B format .ft R is .ft B Mnil\fP, .ft R .ft B name .ft R is at first parsed as XLFD, and it it fails, parsed as Fontconfig's representation. .PP .SH RETURN VALUE .PP .RS 4 If the operation was successful, this function returns a pointer to the created font. Otherwise it returns .ft C NULL\fP. .ft R .RE .PP .SH COPYRIGHT Copyright (C) 2001 Information\-technology Promotion Agency (IPA) .br Copyright (C) 2001\-2011 National Institute of Advanced Industrial Science and Technology (AIST) .br Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License .