Font utilities

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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 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 xheight fontdimen (see section 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.)

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]