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
- `-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.
Write the image to `image-name.eps' as an Encapsulated
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
- `-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 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 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.)
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.
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.
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.
Print the version number. See section 3.3.2 Common options.