ILPTOPS(1) Printing Tools ILPTOPS(1)
NAME
ilptops - convert a text file into a PostScript file
SYNOPSIS
ilptops [-B #] [-C n] [-D] [-E header]
[-F fontlist] [-G] [-H] [-I #] [-J printer]
[-K n] [-L #] [-M n] [-N [tb][lcr]n]
[-O #] [-P #] [-Q] [-R #] [-T #] [-U]
[-V] [-W] [-X] [-2] [-a] [-h #] [-l locale name]
[-m map file] [-p bitmap size] [-w #] infiles
DESCRIPTION
ilptops converts a text file into a PostScript file for printing on an
Apple LaserWriter, or any other PostScript-compatible output device. It
supports selection of a variety of fonts at arbitrary point sizes, margin
specification, portrait and landscape page orientation, automatic page
numbering, page outlining, and multi-column printing. It is similar to
ilptops (1) except that it processes supplementary code set characters
according to the locale specified in the LC_CTYPE environment variables
[see LANG on environ(5)]. The -l options overrides LC_CTYPE. It also has
the capability to download bitmap and Type 1 fonts to printers.
In the option descriptions below, physical dimensions described as # may
be specified as a single number with an optional fractional part, and a
required two-letter unit designator. Letter case is ignored. Possible
forms are:
#.##bp big point (1in=72bp) [Courier: 120.000/Pbp cpi]
#.##cm centimeter [Courier: 4.233/Pcm cpi]
#.##in inch [Courier: 1.667/Pin cpi]
#.##mm millimeter (10mm=1cm) [Courier: 42.333/Pmm cpi]
#.##pt point (72.27pt=1in) [Courier: 120.450/Ppt cpi]
The bracketed values give the number of characters per inch (cpi) for a
point size of P units with the fixed-width Courier font.
Options are parsed left to right. So, always the most recent option is
considered when there is a conflict. For example,
ilptops -U -X
here, -X will be considered.
The letter case is ignored in the options and the following options may
appear in any order.
-B # Bottom margin of #.
-C n Print n copies of each page.
Page 1
ILPTOPS(1) Printing Tools ILPTOPS(1)
-D Use the Standard PostScript character set for text fonts. If this
option is not specified, the program will check whether the
specified font contains ISO 8859-1 (Latin-1) characters. If so, it
will use the ISO 8859-1 character set. Otherwise, it will use the
default character set for the specified font.
-E header
The header string will be used to print the gaudy header if -G
option is turned on. This flag has no effect if -G is not used.
-F fontlist
Comma seperated list of PostScript fontnames to be used with every
codeset. Possible values with acceptable short abbreviations (formed
from the upper-case letters in the font names) are as follows. The
following 35 typefaces are available on most of the PostScript
printers. Some old printers may support only the first 13 typefaces.
Full Name Abbreviation
___________________________________________
Courier C
Courier-Bold CB
Courier-BoldOblique CBO
Courier-Oblique CO
Helvetica H
Helvetica-Bold HB
Helvetica-BoldOblique HBO
Helvetica-Oblique HO
Symbol S
Times-Bold TB
Times-BoldItalic TBI
Times-Italic TI
Times-Roman T
AvantGarde-Book AGB
AvantGarde-BookOblique AGBO
AvantGarde-Demi AGD
AvantGarde-DemiOblique AGDO
Bookman-Demi BD
Bookman-DemiItalic BDI
Bookman-Light BL
Bookman-LightItalic BLI
Helvetica-Narrow HN
Helvetica-Narrow-Bold HNB
Helvetica-Narrow-BoldOblique HNBO
Helvetica-Narrow-Oblique HNO
NewCenturySchlbk-Bold NCSB
NewCenturySchlbk-BoldItalic NCSBI
NewCenturySchlbk-Italic NCSI
NewCenturySchlbk-Roman NCSR
Palatino-Bold PB
Page 2
ILPTOPS(1) Printing Tools ILPTOPS(1)
Palatino-BoldItalic PBI
Palatino-Italic PI
Palatino-Roman PR
ZapfChancery-MediumItalic ZCMI
ZapfDingbats ZD
The user is not limited to the above 35 typefaces. If there are any
additional fonts that have been downloaded into the PostScript
printer, then they can be used by specifying them through fontname.
If the requested font is not found, then the PostScript interpreter
will substitute it with a Courier font. Alternatively, the user can
opt to download fonts to the printer if the corresponding outline
font is not available int the printer.. The fontname is as
specified by the ps2xlfd_map.* file [ see type1xfonts(1) ] and the
download flag in the ilptops_map.* file shoule be 1.
Only the Courier fonts have fixed widths like typewriter and line
printer fonts. The others are proportionally spaced for improved
readability, and consequently, tabular material will not line up
properly with them.
-G Turn on page decorations. Prints Date,Time,File name and Page
number. If a header is specified with the -E option, it will
override file name.
-H Horizontal page orientation (landscape mode) instead of vertical
page orientation (portrait mode).
-I # Top margin of # for initial page (for letterheads); if not
specified, it will default to the value given for the top margin by
default or by the -T# command.
-J printer
The printer on which the document ( output ) is going to be printed.
The printer has to be installed on the system. If this option is not
specified, ilptops assumes 8.5x11in page size and 0.35in margins.
-K n The maximum number of lines to be printed on the page. Default is 66
lines.
-L # Left margin of #.
-M n Multiple column output (n columns). In multiple column mode,
formfeeds cause column breaks instead of page breaks.
-N [tb][lcr]n
Number output pages. The number is placed by default in the center
of the top margin, but the margin can be selected explicitly by t
(top) or b (bottom), and the position of the page number can be
further specified by l (left), c (center), or r (right). If an
initial top margin value is given with the -I# option, numbering
will be omitted on the first page if it is at the top. Pages are
Page 3
ILPTOPS(1) Printing Tools ILPTOPS(1)
unnumbered if this option is not specified.
-O # Draw a # unit wide outline for pages/columns. In multi-column mode a
rectangular box is drawn around each column. A 0.4pt width outline
is an optimal choice for this option.
-P # Font point size. The point size also determines the interline
spacing.
-Q Turn on debug messages.
-R # Right margin of #.
-T # Top margin of #.
-U Output pages in unsorted (first to last) order instead of in sorted
(page reversed) order; some PostScript printers have page handlers
that stack the paper in this order. The default is sorted because
this is appropriate for the most common PostScript printer,the Apple
LaserWriter. Note that the newer Apple LaserWriter II series stacks
pages reversed. Therefore, the -U option should be used when sending
print jobs to a LaserWriter II printer.
-V Vertical page orientation (portrait mode) instead of Horizontal page
orientation (landscape mode).
-W Wraps long lines in the text instead of clipping them. ilptops reads
the character width information from fontmetric files in
/usr/lib/DPS/AFM to do the line width calculations. If the requested
font's fontmetrics file is not found, then ilptops ignores this
switch and defaults to clip mode. Default mode is to clip text in
long lines.
-X Output pages in sorted (last to first) order instead of in unsorted
(-U option) order; some printers have page handlers that stack the
paper in this order. The default is sorted because this is
appropriate for the most common PostScript printer, the Apple
LaserWriter.
-2 Output PostScript file has Level 2 features.
-a Adjusts lines according to the rules in mapfile. It has no effect
if the option -W is not used.
-h # Page height of #.
-l localename
Locale name. Default is the environment variable LANG.
-m mapfile
Default is /usr/lib/print/ilptops_map.<locale>. Various locales
require their own map files. The map file includes font names,
Page 4
ILPTOPS(1) Printing Tools ILPTOPS(1)
download, AFM flag and rules in the following format. Any line that
begins with a '#' is a comment. Columns are separated from by any
sequence of spaces or tabs.
The first non-comment lines describe the fonts and character sets
used in the document. These lines have 5 columns: font_name ,
encoding , screenwidth , download_flag and AFM_flag. Each line
describes a font and corresponding code set available for text in
the current document.
font_name can be the font name of either a PostScript printer font
or IRIX Font Manager font.
encoding is the name of the character set encoding as given in the
ps2xlfd map file(s) for the desired language in /usr/lib/X11/fonts.
screenwidth indicates the number of ASCII spaces that equal the
width of the font's glyphs.
download_flag indicates whether ilptops should download the font to
the printer. With a value 1, the program generates Type 3 fonts in
the output PostScript file. It optimizes the amount of data sent to
the printer by generating only the font glyphs that are required for
printing the input text file. With a value 2, it simply copies Type
1 fonts to the PostScript file. A value of 0 switches the flag off.
AFM_flag indicates whether ilptops should use AFM to calculate
character width or not.
After the last font descriptor line, there must be a blank line.
Comment lines are not considered to be blank lines. After the blank
line, a single 2 column line describes the character sizes and space
between them: bitmap_size indicates the preferred size of bitmap
used when generating the Type 3 font to be downloaded to the printer
and side_bearings is any space that would be left around each
character generated in the Type 3 font. They have no effect if
download_flag is off.
The next three lines present rules which are used to adjust wrapped
lines. They contain lists lf characters that may and may not be
place at the end and beginning of lines of text. If the following
condition is satisfied, the line will be wrapped after the current
character:
{current character is in line 6} or
{{current character is not in line 7} and
{next character is not is line 8}}
It has no effect if the option -a is not used.
An example ilptops_map.ja_JP.SJIS file for the Japanese locale would
be as follows. (Note that the line break characters are not given
Page 5
ILPTOPS(1) Printing Tools ILPTOPS(1)
since this man page might be viewed in a locale that does not
support Japanese Shift-JIS.)
# fontname encoding width download AFM Courier
ISO8859-1 1 0 1 Ryumin-Light-H
jisx0208.1983-0 2 1 0 Ryumin-Light.Hankaku
jisx0201.1976-0 1 1 0
# fontsize sidebearings
24 2
# can wrap line after these characters
(list of SJIS line break characters)
# can not wrap line after these characters
(list of SJIS line break characters)
# can not wrap line before these characters
(list of SJIS line break characters)
The Ryumin-Light-H and Ryumin-Light.Hankaku fonts in the above map
file example are described in
/usr/lib/X11/fonts/ps2xlfdmap.japanese. Other fonts given in this
file could be substitued for the Ryumin fonts in the map file.
-p n Bitmap size used for generating Type 3 fonts. It has no effect if
download_flag is off.
-w # Page width of #.
Defaults are:
ilptops -B0.35in -C1 -FCourier -K66 -L0.35in -M1 -R0.35in -T0.35in
-X -h11.0in -w8.0in
BUGS
Currently, ilptops is not able to handle files that generate more than
1024 total pages.
FILES
/usr/lib/print/ilptops
filter to convert text to PostScript.
/usr/lib/print/ilptops_map.<locale>
Locale dependent map files.
/usr/lib/X11/fonts/ps2xlfd_map.*
Correlates PostScript and X11 font names.
Page 6
ILPTOPS(1) Printing Tools ILPTOPS(1)
SEE ALSO
lp(1)
lptops(1)
type1xfonts(1)
Page 7