mkfontscale
create an index of scalable font files for X
see also :
X - mkfontdir - xset
Synopsis
mkfontscale
[ -b ] [ -s ] [ -o
filename ] [ -x suffix ] [
-a encoding ] ... [ -f
fuzz ] [ -l ] [ -e
directory ] [ -p prefix ] [
-r prefix ] [ -n
prefix ] [ -- ] [ directory
] ...
add an example, a script, a trick and tips
examples
no example yet ...
... Feel free to add your own example above to help other Linux-lovers !
description
For each
directory argument, mkfontscale reads all of the
scalable font files in the directory. For every font file
found, an X11 font name (XLFD) is generated, and is written
together with the file name to a file fonts.scale in
the directory.
The resulting
fonts.scale file should be checked and possibly
manually edited before being used as input for the
mkfontdir(1) program.
options
-b
read bitmap fonts. By default,
bitmap fonts are ignored.
-s
ignore scalable fonts. By default, scalable fonts are
read. If -b is set, this flag has the side
effect of enabling the reading of fonts.scale
files.
-o
filename
send program output to
filename; default is fonts.scale if bitmap
fonts are not being read, and fonts.dir if they are.
If filename is relative, it is created in the
directory being processed. If it is the special value
-, output is written to standard output.
-x
suffix
exclude all files with the
specified suffix.
-a
encoding
add encoding to the list
of encodings searched for.
-f fuzz
set the fraction of characters
that may be missing in large encodings to fuzz
percent. Defaults to 2%.
-l
Write fonts.dir files suitable for
implementations that cannot reencode legacy fonts (BDF and
PCF). By default, it is assumed that the implementation can
reencode Unicode-encoded legacy fonts.
-e
specifies a directory with encoding files. Every such
directory is scanned for encoding files, the list of which
is then written to an "encodings.dir" file in
every font directory.
-p
Specifies a prefix that is prepended to the encoding
file path names when they are written to the
"encodings.dir" file. The prefix is prepended
literally: if a ’/’ is required between the
prefix and the path names, it must be supplied explicitly as
part of the prefix.
-r
Keep non-absolute encoding directories in their relative
form when writing the "encodings.dir" file. The
default is to convert relative encoding directories to
absolute directories by prepending the current directory.
The positioning of this options is significant, as this
option only applies to subsequent -e
options.
-n
do not scan for fonts, do not write font directory
files. This option is useful when generating encoding
directories only.
--
end of options.
notes
The format of the fonts.scale, fonts.dir and
encodings.dir files is documented in the mkfontdir(1)
manual page.
Mkfontscale will overwrite any fonts.scale file
even if it has been hand-edited.
mkfontscale -b -s -l is equivalent to mkfontdir.
see also
X ,
Xserver, mkfontdir , ttmkfdir, xfs, xset
author
The version of
mkfontscale included in this X.Org Foundation release
was originally written by Juliusz Chroboczek
<jch[:at:]freedesktop[:dot:]org> for the XFree86 project. The
functionality of this program was inspired by the
ttmkfdir utility by Joerg Pommnitz.