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 codingscheme command (see section 9.2.6 codingscheme command).

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 9.2.7.1 TFM fontdimens.

`-help'

Print a usage message. See section 3.3.2 Common options.

`-no-gf'

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.)

`-verbose'

Output progress reports.

`-version'

Print the version number.

`-xheight-char code'

Use the TFM height of code for the xheight fontdimen (see section 9.2.7.1 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.)