11.5 Invoking BZRto

This section describes the options that BZRto accepts. See section 3.3 Command-line options, for general option syntax.

The root of the main input fontname is called font-name below.

`-concat bzr-name1, bzr-name2, ...'

Concatenate the main input file with the given bzr-names; if a character code exists in more than one of the BZR files, it's the first occurrence that counts. The BZR files can have any design size; the output is normalized to the size of the main input file.

`-ccc-file filename'

Read the CCC file filename (if filename has a suffix) or `filename.ccc' (if it doesn't). Default is to use font-name for filename, but if BZRto does not find the file `font-name.ccc', it does not complain.

`-encoding filename'

Specify the encoding file for the input font, so character names in the CCC files can be matched to character codes. If filename has no suffix, use `filename.enc', otherwise just filename. The default is to guess the encoding from the `codingscheme' string in a TFM file corresponding to the main input file, if such exists.

`-help'

Print a usage message. See section 3.3.2 Common options.

`-metafont'

Translate the input to a Metafont program; write to `font-name.mf'. See section 11.1 Metafont and BZRto.

`-mf'

Synonym for `-metafont'.

`-oblique-angle angle-in-degrees'

Angle in degrees from the vertical by which to slant the shapes; default is zero.

`-output-file filename'

Output to filename (if it has a suffix) or to `filename.font-format' (if it doesn't), where font-format is `mf', `gsf', etc. If you give more than one of the output format options (i.e., `metafont', `pstype1' and `pstype3'), filename cannot have a suffix. The default is font-name with a trailing number removed, so that, for example, an input filename of `cmr10' becomes `cmr'.

`-ps-font-info name1:value1,...'

Assign each value to the corresponding name when outputting a PostScript font (either Type 1 or Type 3). Case is significant in both the names and values. You can specify the following:

`FontName:string'

The full PostScript name of the font; e.g., Times-BoldItalic. The default is unknown.

`FamilyName:string'

The name of the typeface family to which this font belongs; e.g., Times. The default is to use FontName up to the first `-'.

`Weight:string'

The typographic weight of the font, e.g., Bold. If FontName contains one of the strings `Black', `Book', `Bold', `Demi', `ExtraBold', `Light', `Heavy', `Regular', `Semibold', or `Ultra', that is the weight. Otherwise, BZRto uses `Medium'.

`ItalicAngle:real'

The angle in degrees by which the font slopes to the right from the vertical. Default is zero. Typical slanted or italic fonts have values between 10--20.

`isFixedPitch:true or false'

Whether or not this font is monospaced. If a TFM file corresponding to the main BZR file exists, and specifies a zero interword stretch and shrink, and a nonzero interword space, the default is true. Otherwise, it's false.

`UnderlinePosition:real'

Distance from the baseline for positioning underlines, in units of the character coordinate system. Default is -100.

`UnderlineThickness:real'

Thickness of underlines. Default is 50.

`UniqueID:non-negative integer'

An integer in the range 0 to 16777215 (2^24 - 1) uniquely identifying this font. The default is zero, meaning (for our purposes) not to output any UniqueID. This avoids unlikely-but-possible conflicts with existing fonts.

`version:string'

Identification for the particular version of this font. If a TFM file corresponding to the main BZR file exists, and specifies a version number, that is the default; otherwise, there is none.

All values except FontName and UniqueID go in the FontInfo dictionary.

`-pstype1'

Translate the input to (unencrypted) PostScript Type 1 font format; write to `font-name.gsf'. See section 11.2 Type 1 PostScript fonts and BZRto.

`-pstype3'

Translate the input to PostScript Type 3 font format; write to `font-name.pf3'. See section 11.3 Type 3 PostScript fonts and BZRto.

`-range char1-char2'

Only process characters between the character codes char1 and char2, inclusive.

`-text'

Translate the font to a BPL file, i.e., human-readable text; write to standard output. See section 12.1 BPL files.

`-verbose'

Output progress reports to standard output, unless `-text' is specified, in which case output to standard error.

`-version'

Print the version number.