6.3 Invoking Imageto

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

The main input filename (see section 3.3.1 The main input file) is called image-name below.

`-baselines scanline1,scanline2,...'

Define the baselines for each image row. The default baseline for the characters in the first image row is taken to be scanline1, etc. The scanlines are not cumulative: the top scanline in each image row is numbered zero.

`-designsize real'

Set the design size of the output font to real; default is 10.0.

`-dpi unsigned'

The resolution of the input image, in pixels per inch (required for PBM input). See section 3.3.2 Common options.

`-encoding enc-file'

The encoding file to read for the mapping between character names and character codes. See section 5.3 Encoding files. If enc-file has no suffix, `.enc' is appended. Default is to assign successive character codes to the character names in the IFI file.

`-epsf'

Write the image to `image-name.eps' as an Encapsulated PostScript file.

`-help'

Print a usage message. See section 3.3.2 Common options.

`-ifi-file filename'

Set the name of the IFI file to filename (if filename has an extension) or `filename.ifi' (if it doesn't). The default is `image-name.ifi'.

`-input-format format'

Specify the format of the input image; format must be one of `pbm' or `img'. The default is taken from image-name, if possible.

`-nchars unsigned'

Only write the first unsigned (approximately) characters from the image to the output font; default is all the characters.

`-output-file filename'

Write to filename if filename has a suffix. If it doesn't, then if writing strips, write to filenamesp.dpigf; else write to `filename.dpigf'. By default, use `image-name designsize' for filename.

`-print-clean-info'

Print the size of each bounding box considered for removal, and the size of the containing bitmaps. This option implies `-verbose'. See section 6.1.3 Dirty images, for a full explanation of its output.

`-print-guidelines'

Print the numbers of the top and bottom scanlines for each character. This implies `verbose'. See section 6.1.2 Image to font conversion, for a full explanation of its output.

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

`-strips'

Take a constant number of scanlines from the image as each character in the output font, instead of using an IFI file to analyze the image.

`-trace-scanlines'

Show every scanline as we read it as plain text, using `*' and space characters. This is still another way to view the image (see section 6.1.1 Viewing an image), but the result takes an enormous amount of disk space (over eight times as much as the original image) and is quite difficult to look at (because it's so big). To be useful at all, we start a giant XTerm window with the smallest possible font and look at the resulting file in Emacs. This option is primarily for debugging.

`-verbose'

Output progress reports. See section 3.3.2 Common options. Specifically, a `.' is output for every 100 scanlines read, a `+' is output when an image row does not end on a character boundary, and the character code is output inside brackets.

`-version'

Print the version number. See section 3.3.2 Common options.