|
|
1.1 root 1: .eh '%'Interpress Toolkit''
2: .oh ''Interpress Toolkit'%'
3: .sh 1 Overview
4: .sh 2 "What is \*(IP?"
5: .lp
6: To describe \*(IP, we choose to quote from the preface of ``Introduction
7: to Interpress'' (see Appendix \f(RN1\fP for a bibilography):
8: .(q
9: The \*(IP standard defines the digital representation of printed
10: material for exchange between a creator and a printer. A document
11: represented in Interpress can be transmitted to a raster printer or other
12: display device for printing, it can be transmitted across a communication
13: network as a means of exchanging graphic information, or it can be stored
14: as an archival master copy of the material. A document in \*(IP
15: is not limited to any particular printing device; it can be printed
16: on any sufficiently powerful printer that is equiped with \*(IP
17: print software.
18: .)q
19: .sh 2 "What is in this distribution?"
20: .lp
21: The \*(IP Toolkit provides ``C'' language code
22: for the creation and manipulation of \*(IP files.
23: The package consists of:
24: .RS
25: ``C'' source files which define useful constants
26: .br
27: a library of subroutines
28: .br
29: executable utilities
30: .br
31: documentation
32: .RE
33: Items one and two aid programmers in writing new application code.
34: .lp
35: A attempt has been made to keep the code portable. While
36: development has occured under 4.3BSD Vax Unix, portions of this package
37: also run on Masscomp Unix, Vax/VMS, and IBM PC-DOS operating systems.
38: .lp
39: The executable utilities mainly transform files to and/or from \*(IP.
40: Below is a quick summary of the names of the programs and their function:
41: .RS
42: .ip "maha"
43: treats the laser printer as a line-printer.
44: Normally, it uses a fixed-width font so that columns will line up.
45: Options are provided to change the font, provide two-column output,
46: and print landscape (rotated) output.
47: .ip "dipress\(dg"
48: .(f
49: \(dg Unix only
50: .)f
51: post-processes the output from typesetter-independent \*(TR
52: and creates from it an \*(IP master.
53: .ip "iptroff\(dg"
54: A shell script which will call typesetter-independent \*(TR and then
55: ``dipress''.
56: .ip "ipfe"
57: An editor to extract, modify and combine pages from \*(IP files.
58: .ip "ipmetrics"
59: converts fonts metrics from the \*(IP metric master format
60: to that of specific composing systems.
61: .ip "plot2ip\(dg"
62: converts Unix plot(5) format to \*(IP.
63: .ip "iptotext"
64: \*(IP files are encoded in binary.
65: We have created a parallel ASCII representation to \*(IP to aid in
66: reading \*(IP masters. Since the mapping is one-to-one, \*(IP files
67: can be converted back & forth from binary to ASCII
68: without loss of information.
69: The ASCII syntax is documented in Section 5 of this document.
70:
71: The programs iptotext and texttoip convert between these two representations
72: in the obvious way. Converting to text is a handy way to debug
73: \*(IP files that are constructed using the C language interface described
74: in Section 4. A text representation also provides a way for knowledgable people
75: to edit \*(IP files. For example, it was used to debug \*(TR changes
76: to remove the cut-marks inserted by the standard 4.2BSD macros.
77: .ip "texttoip"
78: reverses the above transformation.
79: .ip "charset"
80: .EQ
81: delim $$
82: .EN
83: This program creates an \*(IP master of a
84: .i "character set"
85: of a specific font in a given point
86: size in tabular form. The Xerox Character Encoding Standard currently specifies
87: characters for a range of [0..$2 sup 16 - 1$] values.
88: This space is divided into 256 character sets.
89: Since this space is rather sparse, it's handy to know exactly which
90: characters your printer can print. See appendix \f(RN1\fP for a reference
91: to the Character Code Standard.
92: .EQ
93: delim off
94: .EN
95: .ip "mp2res, restotext and stackres"
96: Xerox's Raster Encoding Standard (RES) is used to transmit
97: and exchange image data. The program ``mp2res'' converts a
98: MacPaint file to RES format. ``restotext'' converts an RES file
99: to a textual representation in a manner similar to iptotext. ``stackres''
100: executes the RES file (an RES file is similar to an \*(IP file) and
101: prints out what is left on the stack.
102: .RE
103: .sh 2 "What is not in this distribution?"
104: .lp
105: The code provided in this distribution only creates \*(IP masters.
106: Functions such as communicating the master to a printer are beyond
107: the scope of this package.
108: .lp
109: For users of 4.3BSD Unix, XNS communications protocols are provided
110: on the standard tape. For users of VMS, a Xerox software product called
111: ``XNS/DEC VAX'' is available. For users of the PCs, there is a package
112: offered by Xerox and 3Com called ``XNS/IBM PC''. This list is not
113: exhaustive as we have heard of (but not used) other implementations.
114:
115:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.