InterpressToolsDoc.tioga
Doug Wyatt, May 31, 1985 10:34:50 am PDT
Michael Plass, September 18, 1986 4:06:41 pm PDT
Nickell, September 18, 1985 11:11:14 am PDT
Tim Diebert: September 18, 1985 4:29:18 pm PDT
Pier, December 17, 1985 10:23:57 am PST
Eric Nickell February 19, 1986 3:38:44 pm PST
Rick Beach, February 25, 1986 8:12:54 am PST
Eric Nickell, December 13, 1986 12:44:13 pm PST
Stone, December 16, 1986 4:39:16 pm PST
INTERPRESS TOOLS
CEDAR 6.1 — FOR INTERNAL XEROX USE ONLY
Interpress Tools
Cedar tools for manipulating Interpress masters
Doug Wyatt, Michael Plass
© Copyright 1985, 1986 Xerox Corporation. All rights reserved.
Abstract: InterpressTools provides a collection of tools for manipulating Interpress masters. We expect the collection to grow over time; the operations currently implemented are conversions between various print file formats.
Created by: Doug Wyatt
Maintained by: Doug Wyatt <Wyatt.pa>
Keywords: Interpress, Imager, printing
XEROX  Xerox Corporation
   Palo Alto Research Center
   3333 Coyote Hill Road
   Palo Alto, California 94304

For Internal Xerox Use Only
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.
IPWrittenFromXerox [<output> ] <input>
<input> is the file name of an Interpress master in the Xerox encoding
<output> will be in a written encoding, suitable for hand-editing
IPXeroxFromWritten [<output> ] <input> [<version>]
<input> is the file name of an Interpress master in the written encoding
<output> will be in the Xerox encoding, suitable for machine processing
<version> is an optional version number (i.e., 2.1) that will be placed verbatim in the header.
PressToInterpress [<output> ] <input> [<version>]
<input> is the file name of a Press file
<output> will be an Interpress master in the Xerox encoding
<version> is an optional version number (i.e., 1.0) that will be placed in the header; if supplied, an attempt will be made to translate the pressfonts to Xerox corporate standard fonts.
AISToInterpress [<output> ] <input>
A simple way to get an Interpress master from a gray-scale AIS file.
The AIS image is scaled to fit a standard 8.5 by 11 inch page, with a small margin.
The command line is printed as a caption at the bottom.
ColorAISToInterpress [<output> ] <inputRoot>
The corresponding command for color AIS files.
The inputRoot parameter specifies the root for the names of three color AIS files; the actual file names are derived by appending -red.ais, -green.ais, and -blue.ais to inputRoot (other popular naming conventions will work as well).
The AIS image is scaled to fit a standard 8.5 by 11 inch page, with a small margin.
The command line is printed as a caption at the bottom.
InterpressBreakup <input>     (synonym IPBreakup)
Breaks up the named Interpress master into single-page masters.
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.
InterpressToPD [<output> ] <input> <deviceType> {<spec>}(synonym IPToPD)
<spec> ::= <tonerList> | (of (3 | 4)) | (<pixelsPerHalftoneDot> ppd) | (<tx> in <ty> in translate) | (<rotate> rotate) | (<scale> (scale | scaleX | scaleY)) | (<skip> skipPages) | (<nPages> nPages) | (<pixelsPerInch> (sResolution | fResolution | Resolution)) | (<pageSizeInInches> (pageSSize | pageFSize)) | (<ucrParm> (gamma | threshold | removedFraction) | (fontTuning <fontTuneSpec>) | leftovers | noLeftovers | (<n> (bandSize | load | deviceCode)) | <array> <brickPhase> <toner> brick
<tonerList> ::= {black | cyan | magenta | yellow}
<toner> ::= black | cyan | magenta | yellow
<vector> ::= [ { <realNumber> } ]
<array> ::= [ { <vector> } ]
<input> is the file name of an Interpress master in the Xerox encoding
<output> will be a PD file
<deviceType>: raven300 | raven384 | plateMaker | puffin | colorVersatec | versatec | color400 | c150 | colorado384 | ... (FindR *.pdDeviceSpec to see current list of supported devices)
black | cyan | magenta | yellow
 denotes which color passes are desired (do not use for versatec or colorVersatec).
of <number> specifies how many inks the press has (defaults to the inks specified by name)
<pixelsPerHalftoneDot> ppd specifies how many pixels per halftone dot
<tx> and <ty> are translations of the whole page, in inches
<rotate> is a rotation of the whole page, in degrees; note you will generally have to supply a translation as well to keep the image on the page
<scale> is a scale factor for the whole page, applied in either the slow or fast scan directions, or both
<skip> is the number of pages to skip at the beginning of the file (default 0)
<nPages> is the number of pages to print (default is to print to end)
<pixelsPerInch> specified printer pixels per inch in either the slow or fast (or both) scan directions
<pageSizeInInches> is the length or width of the page
gamma is the percentage of black ink to put down where a 3-color would have been printed
threshold is the minimum 3-color black at which to begin undercolor removal
removedFraction is the percentage of cyan, magenta, and yellow inks to remove as black ink is added
gamma, threshold, removedFraction are the undercolor removal paramaters
<fontTuneSpec> is a ROPE passed to ImagerPD. Available only for the Raven printer. Currently available strings are: Raven1.fontTune, RavenCraft384.fontTune, Simple1.fontTune, Simple0.fontTune. This will make your font scan conversion take a LONG TIME (first time only). The caching lasts until you rollback.
leftovers | noLeftovers specifies leftovers parm passed to ImagerPD (wizards only)
<n> sets one of the ImagerPD parameters: bandSize, load, or deviceCode (wizards only)
<array> <brickPhase> <toner> brick specifies a Holliday halftone brick for the specified toner (wizards only)
InterpressToPress [<output> ] <input>
<input> is the file name of an Interpress master in the Xerox encoding
<output> will be a Press file; note that all Interpress semantics are not supported by Press
InterpressToAIS [<outputRoot> ] <input> {gray} {ppi: <pixels per inch>}
<input> is the file name of an Interpress master in the Xerox encoding
<output> will be three AIS files: outputRoot-red.ais, outputRoot-green.ais, outputRoot-blue.ais without gray option.
<output> will be single AIS file, Intensity encoded: outputRoot.ais, with gray option.
<pixels per inch> specifies the resolution of the resulting AIS image. Note that the size of each AIS file will be 8.5*<pixels per inch> by 11*<pixels per inch>.
InterpressToJaM [<output> ] <input>
<input> is the file name of an Interpress master in the Xerox encoding
<output> will be a JaM text file
InterpressToTiogaArtwork
[<output>
] <input> {[(<key>: <real><unit>)|(scale: <s>)|(page: <p>)|(clip: <clip>)}{,|;}}
example:
foo.ip page: 1, topMargin: 1 in, leftMargin: 1 in, height: 9 in, depth: 0 in, width: 6.5 in, scale: 1, clip: FALSE, topSpace: 4 bp, bottomSpace: 8 bp
Creates a document with the designated portion of the page as a tioga "Artwork Interpress" node; this node may contain arbitrary graphics, and may be selected, copied, moved, and deleted just like tioga node. It will be displayed on the screen if ArtworkInterpress is enabled (see below). If ArtworkInterpress is not enabled, you will see a comment describing where the Interpress came from. The keyword parameters need be specified only if they differ from the default values shown above. <unit> is in, pt, cm, mm, or bp.
<output> is the name of an output file; if not provided. a viewer will be created to hold the new document
<input> is the file name of an Interpress master
<s> is a magnification factor to apply to the page image
<clip> is TRUE or FALSE, and says whether to clip the image to the designated rectangle (Research Interpress only)
the remaining parameters describe the portion of the page to be included:
<key>: topMargin | leftMargin | height | depth | width | topSpace | bottomSpace
The preferred way to specify the area is with the height parameter, leaving the depth to default to zero. The selection feedback will be more pleasant this way.
ArtworkInterpress on | off
Enables or disables ArtworkInterpress
ArtworkRule
Loads the ArtworkRule package to support displaying typographic rules in Tioga documents. The content of a node with Artwork property value of Rule is interpreted to determine the rule length and thickness. (This interpretation is identical to that of the TSetter ArtworkClass = Rule). The default length of the rule is the width of the column from the current indent. Some thicknesses are predefined: - (minus sign) gives a 0.4 point rule (a thin line), (em dash) also gives a 0.4 point rule, = (equals sign) gives a 1.0 point rule (a thicker line), ~ (tilde) gives a rule 80% of the font height, # (number sign) gives a rule 80% of the font height. Two keyword parameters may also be given, thickness: <value> <unit>, or length: <value> <unit>, where <value> is a real number and <unit> may be one of in for inches, pt for points, cm for centimeters, mm for millimeters, and bp for big points. The rule below has a 2 pt thickness and length 2 inches:
thickness: 2 pt length: 2 in
XCFonts
This provides compatibility (sort of) for Xerox Character Code fonts like you will find in Interpress masters coming from other parts of the corporation. Run automatically with any of the above.
InterpressArrows [<output> ←] <input>
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. 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.
InterpressOverlay <output> ← <input1> <input2> {translate <x> <y> | rotate <angle> | scale <scale> | scale2 <sx> <sy>}
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 platemaker corner marks, private data seals, etc. Any transformations specified will be applied only to <input2>. <x> <y> <sx> <sy> are all specified in meters, and <angle> in degrees.
Client interfaces
ImagerArtwork
For creating Tioga Artwork with the Imager.
Implemented by ImagerArtworkImpl.