summaryrefslogtreecommitdiff
path: root/static/unix-v10/man1/psifile.1
blob: 9e9078da85294fd7bb27ba2eb1c11a6c46144a45 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
.TH PSIFILE 1
.CT 1 writing_output
.SH NAME
psifile, mhssend\- postscript interpreter/fax sender
.lg 0
.SH SYNOPSIS
.B psifile
[
.I option ...
] [
.I file
]
.br
.B mhssend
.I phone_number
.I file
.SH DESCRIPTION
.I Psifile
reads Postscript input from
.I file
or from standard input
and produces a file containing an image of the page.
The format of the output file is specified by the following options:
.TF /make/it
.TP
.B -fax
runs at 200 dpi and produces g31 fax in the multipage fax format called
.BR mhs ,
putting its output in file
.B fax\fI$$\fP.mhs
by default. If a phone number is supplied,
the output file is pushed to
.B /tmp
on fama
and
.B mhssend
is run to send the fax.
.TP
.BI -P " phone_no"
specifies the destination phone number for
.BR -fax .
.TP
.B -g4
runs at 300 dpi and produces a fax g4 file called
.B psi.out.g4
by default that
can be displayed on the gnots with
.IR rbits .
.TP
.B -bm
produces
.IR bitfile (9.5)
output in file
.B psi.out
by default.
.I -bm
is useful for debugging postscript programs because
it has better diagnostics than the printers.
.PP
Other options are
.TF /this/is
.TP
.B -s
assumes the file is in
.B mhs
format and sends it to the phone number provided with
.B -P
above.
.TP
.BI -o " name"
use
.I name
as the basename of the output file.
.TP
.BI -p " page"
only output postscript page number
.I page
as determined by
.B %%Page
comments in the file.
.sp
.PP
Fonts are implemented with 24 point bitmap fonts.
Those available are
Symbol, Courier, Times-Roman, Times-Italic, Times-Bold, Times-BoldItalic, Helvetica,
Helvetica-Oblique, Helvetica-Bold, Helvetica-BoldOblique.
Fonts
Courier-Bold,
Courier-Oblique,
and
Courier-BoldOblique
are mapped to
Courier.
Postscript type 1 fonts are implemented and work if supplied
with the input.
.sp
.PP
For best results with TeX documents, run
.B dvips
with the
.B -Tfax
or
.B "-D 200"
option to get fonts of the proper resolution.
.SH EXAMPLES
.TP
.L
troff -ms memo | lp -dstdout -H | psifile -fax -P 4223
.br
.TP
.L
troff -ms memo | dpost | psifile -fax -P 4223
Two equivalent ways to format a memo, convert it to PostScript,
and produce a fax file.
.SH FILES
.TF /usr/lib/psi/psifaxg4
.TP
.F fax\fI$$\fP.mhs
default
.B -fax
output file
.TP
.F psi.out.g4
default
.B -g4
output file
.TP
.F psi.out
default
.B -bm
output file
.TP
.B /usr/lib/psi/psifax
postscript\->mhs format program
.TP
.B /usr/lib/psi/psifaxg4
postscript\->fax g4 program
.TP
.B /usr/lib/psi/psibm
postscript\->bitfile program
.SH SEE ALSO
.IR psi (9.1),
.IR lp (1),
.IR dvips (1),
.IR postscript (8),
.IR proof (9.1) ,
.IR bcp (1)
.SH DIAGNOSTICS
.PP
Symbols that lack bitmaps are replaced by `?'
and an error is reported.
.SH BUGS
Unimplemented PostScript features are rotated images
and half tone screens.
Imagemasks may only be rotated by multiples of 90 degrees,
not by arbitrary angles.