InterpressToolsDoc.tioga
Doug Wyatt, May 31, 1985 10:34:50 am PDT
Michael Plass, May 15, 1992 12:35 pm PDT
Tim Diebert: September 18, 1985 4:29:18 pm PDT
Pier, December 17, 1985 10:23:57 am PST
Rick Beach, March 12, 1987 8:08:17 pm PST
Eric Nickell, December 13, 1986 12:44:13 pm PST
Stone, December 16, 1986 4:39:16 pm PST
Bloomenthal, May 9, 1988 5:01:43 pm PDT
Wes Irish, December 3, 1987 2:54:30 pm PST
Bier, April 15, 1988 10:47:30 am PDT
Last tweaked by Mike Spreitzer on May 22, 1989 6:10:19 pm PDT
Weiser, February 17, 1989 5:50:05 pm PST
Polle Zellweger, April 14, 1992 10:35 am PDT
INTERPRESS TOOLS
CEDAR 10.1
Interpress Tools
Cedar tools for manipulating Interpress masters
Doug Wyatt, Michael Plass
© Copyright 1985, 1986, 1987, 1990, 1991 Xerox Corporation. All rights reserved.
Abstract: InterpressTools provides a collection of tools for manipulating Interpress masters. Included are conversions between written and encoded form, and tools for breaking-up, overlaying, concatenating and extracting pages, etc.
Created by: Doug Wyatt
Maintained by: Doug Wyatt:PARC, Michael Plass:PARC
Keywords: composition, debugging, Imager, Interpress, page description language, printing, TeX
XEROX   Xerox Corporation
    Palo Alto Research Center
    3333 Coyote Hill Road
    Palo Alto, California 94304
Commands
note: in the following, angle brackets surround parameter names, square brackets denote optional syntax, curly brackets denote repetition zero or more times, and underlines denote things that you actually type.
InterpressArrows [<output> ←] <input>
(synonym IPArrows)
A kludgey way of pasting figures into a document that was created by a program too dumb to include its own figures (e.g. TEX). The input interpress master may contain strings of the form
<==<filename.interpress<
(this must be in a done with a single interpress SHOW; no leading or trailing space is allowed); the string is stripped out and replaced by the image on page 1 of the named interpress master, with the lower left corner of the included page aligned with the arrow. If the named file is not found, a warning is printed and the string appears in the output. Use the Preview program to create an appropriate master if the positioning is not initially correct. When using this with TEX, use the typewriter font for the arrow so that kerning does not break the string into multiple SHOWs. Use PressToInterpress to get an Interpress master from the TEX-created press file.
InterpressBooklet [-b | -f | -s<scaleFactor> | -u | -n] <output> ← <input>
(synonym IPBooklet)
InterpressBooklet creates a new Interpress master from an existing Interpress master. The input master is assumed to be a multiple-page Interpress master intended for 8-1/2 x 11 printing. When the resulting master is printed on a double sided 8-1/2 x 11 printer, and the pages folded in half, a "booklet" results. The pages of the resulting booklet will all be in the correct order with page one being the first or "cover" page.
The style BookletCedar.style generates a print area appropriate for a booklet, no scaling is needed or done. If your document wasn't created with BookletCedar.style then you may want InterpressBooklet to scale down the original so that if fits on the now 5.5 x 8.5 page, use the -f option for this purpose.
The -p and -i options allow paper and input sizes other than 8-1/2 x 11.
Options:
-b Input file was made with CedarBooklet.style, do not do any scaling (default).
-f Input file is a "standard" (8.5 x 11 by default) document and should be scaled to fit.
-s<scaleFactor> Scale by <scaleFactor>. For example: -s0.5
-u Shifts image "up" a little (good with -f)
-p <paper size name> Specifies size of paper (usletter, uslegal, usledger, a4).
-i <input image size name> Specifies size of image (used by -f to calculate scale factor).
-n Adds new page numbers (does not try to remove any that are already there).
InterpressBreakup [-by <pages> | -into <files>] <input>
(synonym IPBreakup)
Breaks up the named Interpress master into multiple masters. Either the number of pages per master or the number of masters can be specified; the default is one page per master.
InterpressCompose <output> ← <input1> [transform1] . . . <inputN> [transformN]
(synonym IPCompose)
Combine any number of input Interpress masters to form a single output master. Each input may be followed by an optional transformation, which is an arbitrary combination of the following:
  translate <x> <y> [in | m | cm | mm | pt]
 | rotate <angle> [radians]
 | scale <scale>
 | scale2 <xScale> <yScale>
The default translation is in meters, but inches, centimeters, millimeters, or points may be specified; the default rotation is in degrees, but radians may be specified. <output> will have the same number of pages as the input master with the greatest number of pages; other input pages will be cycled through as necessary.
This program is useful for composing several images for output to a printer. For example, three interpress masters, each designed for output to the Dunn camera, may be composed as a single row of images for the Versatec printer by:
 InterpressCompose Output.ip ←
  Input1.ip translate 1.0 0.0 in scale 0.75
  Input2.ip translate 13.0 0.0 in scale 0.75
  Input3.ip translate 25.0 0.0 in scale 0.75
To take a landscape-formatted interpress master and turn it sideways, do this:
 interpresscompose PT.ip ← PhoenixTalk.ip translate 4.25 5.5 in rotate 90 translate -5.5 -4.25 in
InterpressConcatenate <output> ← <input1> <input2> . . . 
(synonym IPConcatenate)
Concatenates the pages of the named Interpress masters into one master.
InterpressExtract <output> ← <input> [ PAGE[S] { <page> | [<from>..<to>]}]
(synonym IPExtract)
Extracts specified pages from an interpress master.
InterpressOverlay <output> ← <input1> <input2> <transform>
(synonym IPOverlay)
Overlays two interpress masters on each other, page by page. <output> will have the same number of pages as <input1>; <input2> will be cycled through as necessary. Good for adding corner marks, private data seals, etc. Any transformations specified will be applied only to <input2>. <transform> consists of {translate <x> <y> | rotate <angle> | scale <scale> | scale2 <sx> <sy>}, where <x> and <y> are specified in meters, and <angle> in degrees.
InterpressSize <input>
(synonym IPSize)
Gives the estimated, device-independent size of a printed Interpress file, in inches.
Although not performing unnecessary operations, the entire Interpress file is examined, which might take a long time.
InterpressLS {<input>}
(synonym IPLS)
Gives the number of pages in each interpress master.
InterpressPageUp [-b | -f | -s<scaleFactor>] <output> ← <input>
InterpressPageUp creates a new Interpress master from an existing Interpress master. The input master is assumed to be a multiple-page Interpress master intended for 8-1/2 x 11 printing. When the resulting master is printed on an 8-1/2 x 11 printer, each page contains four original pages, scaled to fit (i.e. tiny).