Mercurial > hg > xemacs-beta

comparison man/xemacs/custom.texi @ 3111:e1bc252950d9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[xemacs-hg @ 2005-11-29 12:08:32 by stephent] Pitiful Xft user docs and CHANGES-beta. <87zmnnslq0.fsf@tleepslib.sk.tsukuba.ac.jp>
author stephent
date Tue, 29 Nov 2005 12:08:41 +0000
parents 40dc584fce16
children f5d8dba84d4f
comparison
equal deleted inserted replaced
3110:1d2a1d747bc0 3111:e1bc252950d9
2146 2146
2147 @findex set-face-background-pixmap 2147 @findex set-face-background-pixmap
2148 Alternately, you can use a simpler version of 2148 Alternately, you can use a simpler version of
2149 @code{set-face-background-pixmap} called 2149 @code{set-face-background-pixmap} called
2150 @code{set-face-background-pixmap-file}. This function does not give you 2150 @code{set-face-background-pixmap-file}. This function does not give you
2151 as much control on the pixmap instanciator, but provides filename 2151 as much control on the pixmap instantiator, but provides filename
2152 completion. 2152 completion.
2153 2153
2154 @findex set-face-font 2154 @findex set-face-font
2155 You can set the font of the specified @var{face} with the function 2155 You can set the font of the specified @var{face} with the function
2156 @code{set-face-font}. The @var{font} argument should be a string, the 2156 @code{set-face-font}. The @var{font} argument should be a string, the
2157 name of a font. When called from a program, if the 2157 name of a font. When called from a program, if the
2158 optional @var{frame} argument is provided, the face is changed only 2158 optional @var{frame} argument is provided, the face is changed only
2159 in that frame; otherwise, it is changed in all frames. 2159 in that frame; otherwise, it is changed in all frames.
2160
2161 The syntax of the @var{font} argument varies according to platform. In
2162 each of the following syntaxes, the example shows how to specify a
2163 14-point upright bold Courier font.
2164
2165 @table @strong
2166 @item X11
2167 The X11 syntax is defined by the @dfn{X Logical Font Descriptor} (XLFD)
2168 standard. An XLFD contains 14 fields each preceded by a hyphen:
2169 foundry, family, weight, slant, swidth, adstyle, pixelsize, pointsize,
2170 xresolution, yresolution, spacing, averagewidth, registry, and encoding.
2171 It is usually sufficient to specify family, weight, slant, pointsize,
2172 registry, and encoding, wildcarding the rest with @samp{*}. If you're
2173 not sure what's available, you can wildcard some of the fields usually
2174 specified, too. Here's our example font in XLFD syntax:
2175 @code{"-*-courier-bold-r-*-*-*-140-*-*-*-*-iso8859-*"}.
2176 The XLFD syntax is also used for GTK+ version 1. XLFD names must be
2177 encoding in ISO-8859-1.
2178
2179 @item Xft
2180 The Xft syntax is defined by the @file{fontconfig} library
2181 @ref{Font Names,,,fontconfig}. It is less a font naming convention than
2182 a way to express any arbitrary subset of the font's properties in a
2183 syntax that is both human- and machine-readable. A @file{fontconfig}
2184 font name contains the family, a hyphen, and the pointsize, followed by
2185 an arbitrary sequence of properties. Each property consists of a colon,
2186 a keyword, an equals sign, and the property value. Here's our example
2187 font in @file{fontconfig} syntax: @code{"Courier-14:weight=bold"}. This
2188 syntax admits ``style abbreviations'' which can be user-defined. A
2189 style is a single keyword denoting a sequence of properties. So the
2190 example font may be abbreviated to @code{"Courier-14:bold"} ("bold" is a
2191 standard abbreviation for "weight=bold"). The @file{fontconfig} syntax
2192 is also used for GTK+ version 2. @file{fontconfig} names must be
2193 encoded in UTF-8.
2194
2195 @item MS-Windows
2196 The MS Windows syntax is superficially similar to that of Xft but
2197 actually is more like XLFD. A font name consists of five fields,
2198 family, size, slant, weight, and encoding, each expressed as a keyword
2199 taking on standardized values (except family, which is just a name).
2200 Here's our example font in MS Windows syntax:
2201 @code{"Courier:14:Bold:Western"}.
2202 @end table
2160 2203
2161 @findex set-face-foreground 2204 @findex set-face-foreground
2162 You can set the foreground color of the specified @var{face} with the 2205 You can set the foreground color of the specified @var{face} with the
2163 function @code{set-face-foreground}. The argument @var{color} should be 2206 function @code{set-face-foreground}. The argument @var{color} should be
2164 a string, the name of a color. If the optional @var{frame} argument is 2207 a string, the name of a color. If the optional @var{frame} argument is