Table of contents


NAME

ltrtops - Convert LaTeX letter file addresses to PostScript for envelope printing

SYNOPSIS

ltrtops [ -a ] [ -ba llx lly urx ury ] [ -br llx lly urx ury ] [ -bt llx lly urx ury ] [ -c copies ] [ -e envelopetype ] [ -f fontname ] [ -m max-return-address-lines ] [ -r return-address-type-size-dimen ] [ -t to-address-type-size-dimen ] [ -u u-offset-dimen ] [ -v v-offset-dimen ] [ < infile ]

DESCRIPTION

The input stream on stdin is assumed to be in LaTeX letter-style format, and the addresses are extracted from the arguments of LaTeX macros. TeX comments are ignored, ties (~ characters) are converted to blanks, braces are discarded, TeX accents are converted to \*(Ps accents where possible, and any remaining backslashes are discarded.

The output \*(Ps on stdout positions the envelope in landscape mode in the upper-left corner of the page, suitable for output on laser printers, such the Hewlett-Packard LaserJet 4M, which feed envelopes from the left side of the manual feed tray. Command-line options are provided to allow arbitrary repositioning of the envelope image to match envelope feeders on other printers.

Before the \*(Ps file is sent to the printer, you must load the input tray with envelopes, and select manual feed from the control panel, or via suitable software commands. The accompanying scripts hp4m-envfdr(1) and hp4m-manfdr(1) can be used as an interface to ltrtops to provide automatic selection of either manual feed mode, or an envelope feeder tray.

ltrtops version 2.00 and later provides automatic resizing of the fonts used for the Air Mail, return, and to text boxes to ensure that text is not truncated. Font resizing applies only to the current text box; other boxes, and other envelopes, are not affected.

If font resizing is required, an integral point size is always chosen, to reduce font rasterization time and printer font cache memory consumption.


OPTIONS

For options that take a single value, that value may be specified as the next option, or in the same option with no separator, or with a colon or equals separator. For example, -r 12pt, -r12pt, -r=12pt, and -r:12pt are all equivalent ways of selecting 12pt type for the return address.

Dimension values must be specified as a single number with an optional fractional part, and a required two-letter unit designator, with no spaces between the number and the unit. Possible forms are:

#.##bp	big point (1in = 72bp)
#.##cc	cicero (1cc = 12dd)
#.##cm	centimeter
#.##dd	didot point (1157dd = 1238pt)
#.##in	inch
#.##mm	millimeter (10mm = 1cm)
#.##pc	pica (1pc = 12pt)
#.##pt	point (72.27pt = 1in)
#.##sp	scaled point (65536sp = 1pt)
-a
Add an "Air Mail" designator in the lower-left corner of the envelope. This is always written in a fixed-size outline Helvetica font.
-ba llx lly urx ury
Define the bounding box of the Air Mail text. The four dimensions specify the lower-left and upper-right corner coordinates of the bounding box, measured from the lower-left corner of the envelope.

The default values are specified internally as fractions of the envelope width and height: 0.05W 0.05H 0.20W 0.20H; they are suitable for plain envelopes, but for preprinted envelopes, the more precise control provided by this option may be required.

If this option is given, it must be supplied after any -e envelope option.

-br llx lly urx ury
Define the bounding box of the return address text.

The default values are specified internally as fractions of the envelope width and height: 0.02W 0.50H 0.50W 0.98H.

If this option is given, it must be supplied after any -e envelope option.

-bt llx lly urx ury
Define the bounding box of the to address text.

The default values are specified internally as fractions of the envelope width and height: 0.50W 0.05H 0.95W 0.50H.

If this option is given, it must be supplied after any -e envelope option.

-c copies
Specify the number of copies of each envelope (default = 1).
-e envelopetype
Specify the envelope type, using one of the names given in the first column of this table. Letter case is ignored in the name comparisons, and all characters must be specified (default = COM10).

Name	Height	Width
Executive	7.25in	10.5in
COM10	4.125in	9.5in
Standard	3.625in	6.5in
Monarch	3.9in	7.5in
DL	110mm	220mm
C5	162mm	229mm
B5	176mm	250mm

When this option is given, new default bounding boxes are computed for the Air Mail, return, and to text areas; consequently, any -ba, -br, or -bt options to set bounding boxes must follow the -e option.

-f fontname
Select the \*(Ps font used for the addresses. The full name or an abbreviation for the desired font type is given as font. The default is NewCenturySchlbk-Bold.

The following 13 fonts are available on all \*(Ps printers. The second column provides font abbreviations used by lptops(1); the third column contains ditroff(1) font abbreviations, and the fourth column, Adobe \*(Ts font abbreviations. Any of these abbreviations may be used to specify font.


The remaining fonts are available only on enhanced printers, such as the Apple LaserWriter Plus.


Note that the ditroff(1L) and \*(Ts abbreviations are identical except for the Courier and Times fonts. The \*(Ts abbreviations are based on two-letter mnemonics, where upper-case in the first letter indicates bold, and upper-case in the second letter indicates italic.

Only the Courier fonts are fixed-width fonts; the others are proportionally spaced.

-m max-return-address-lines
This option specifies a limit on the number of return address lines to print. Its primary use is for preprinted envelopes that already provide a return address; a command-line -m 1 setting would then produce only the sender name in the return address box.
-r return-address-type-size-dimen
Specify the type size to be used for the return address (default 14bp).
-t to-address-type-size-dimen
Specify the type size to be used for the to address (default 20bp).
-u u-offset-dimen and -v v-offset-dimen
Specify the position of the lower-left corner of the envelope relative to the lower-left corner of the landscape page image. These options can be used to position the envelope image anywhere on the page. The default is no offset.

SEE ALSO

hp4m-envfdr(1), hp4m-manfdr(1), lptops(1).

AUTHOR

Patrick Redington, Ph.D.
593 Evesham Drive
Murray, UT 84107
USA
Tel: +1 801 265 1614

and

Nelson H. F. Beebe, Ph.D.
Center for Scientific Computing
Department of Mathematics
University of Utah
Salt Lake City, UT 84112
USA
Tel: +1 801 581 5254
FAX: +1 801 581 4148
Email: <beebe@math.utah.edu>
URL: http://www.math.utah.edu/~beebe