9.3 Invoking Charspace
This section describes the options that Charspace accepts.
See section 3.3 Command-line options, for general option syntax.
The root of the main input fontname is called font-name below.
- `-cmi-files file1,file2,...'
- read the CMI files `file1.dpicmi',
`file2.dpicmi', etc., where dpi is the resolution
of the main input font. Default is to read
`font-name.dpicmi'. The `.dpicmi' is not
appended to any of the files which already have a suffix.
`common.cmi' is read before any of these files.
- `-dpi unsigned'
- The resolution, in pixels per inch. See section 3.3.2 Common options.
- `-encoding enc-file'
- The encoding file to read for the mapping between character codes in the
input font and character names. See section 5.3 Encoding files. If
enc-file has no suffix, `.enc' is appended. The default is
to read the encoding file specified via the
(see section 9.2.6
If a TFM file `font-name.tfm' exists, it is also read for
default ligature, headerbyte, and fontdimen information. Definitions in
the CMI files override those in such a TFM file.
- `-fontdimens fd1:value1,fd2:value2,...'
- See section 18.104.22.168 TFM fontdimens.
- Print a usage message. See section 3.3.2 Common options.
- Don't output a revised GF file. This is primarily useful while
debugging the TFM output, since without a bitmap font to match the TFM
output, you can't actually print anything reliably.
- `-output-file filename'
- If filename does not have a suffix, write the output to
`filename.tfm' and (if `-no-gf' was not specified)
`filename.dpigf'. If this would overwrite an input
file, prepend an `x' to the output name.
If filename has a suffix, and `-no-gf' was not specified,
Charspace complains and gives up, since it can't output two files with
the same name.
By default, use the name of the main input font for filename.
- `-range char1-char2'
- Only output characters with codes between char1 and char2,
inclusive. (See section 3.3.2 Common options, and 3.3.3 Specifying character codes.)
- Output progress reports.
- Print the version number.
- `-xheight-char code'
- Use the TFM height of code for the
(see section 22.214.171.124 TFM fontdimens); default is 120 (ASCII `x'). (It is
reasonable to use 120 instead of whatever `x' is in the underlying
character set because most font encoding schemes are based on ASCII
regardless of the host computer's character set.)