1 058b0118 2005-01-03 devnull .TH PAGE 1
5 058b0118 2005-01-03 devnull image, graphic, PostScript, PDF, and
6 058b0118 2005-01-03 devnull typesetter output
8 058b0118 2005-01-03 devnull .SH SYNOPSIS
11 c0cc7cc4 2009-08-21 t.lainson .B -abirPRvVw
18 058b0118 2005-01-03 devnull .IR file ...
20 c0cc7cc4 2009-08-21 t.lainson .SH DESCRIPTION
21 c0cc7cc4 2009-08-21 t.lainson .I Page
22 c0cc7cc4 2009-08-21 t.lainson is a general purpose document viewer.
23 c0cc7cc4 2009-08-21 t.lainson It can be used to display the individual pages
25 c0cc7cc4 2009-08-21 t.lainson PostScript,
28 d32deab1 2020-08-16 rsc .MR troff (1)
32 c0cc7cc4 2009-08-21 t.lainson device-independent output
34 c0cc7cc4 2009-08-21 t.lainson .I Troff
37 c0cc7cc4 2009-08-21 t.lainson output is simply converted to PostScript in order to be viewed.
38 c0cc7cc4 2009-08-21 t.lainson It can also be used to view any number of
39 c0cc7cc4 2009-08-21 t.lainson graphics files
43 c0cc7cc4 2009-08-21 t.lainson a Plan 9
44 d32deab1 2020-08-16 rsc .MR image (7)
45 c0cc7cc4 2009-08-21 t.lainson file, an Inferno bitmap file, or other common format).
46 c0cc7cc4 2009-08-21 t.lainson .I Page
47 c0cc7cc4 2009-08-21 t.lainson displays these
48 c0cc7cc4 2009-08-21 t.lainson in sequence.
49 c0cc7cc4 2009-08-21 t.lainson In the absence of named files,
50 c0cc7cc4 2009-08-21 t.lainson .I page
51 c0cc7cc4 2009-08-21 t.lainson reads one from standard input.
53 c0cc7cc4 2009-08-21 t.lainson By default,
54 c0cc7cc4 2009-08-21 t.lainson .I page
55 c0cc7cc4 2009-08-21 t.lainson runs in the window in which it is started
56 c0cc7cc4 2009-08-21 t.lainson and leaves the window unchanged.
59 977b25a7 2020-08-14 rsc option causes
61 c0cc7cc4 2009-08-21 t.lainson to grow the window if necessary
62 c0cc7cc4 2009-08-21 t.lainson to display the page being viewed.
65 977b25a7 2020-08-14 rsc option causes
67 c0cc7cc4 2009-08-21 t.lainson to create a new window for itself.
68 c0cc7cc4 2009-08-21 t.lainson The newly created window will grow as under the
70 c0cc7cc4 2009-08-21 t.lainson option.
71 977b25a7 2020-08-14 rsc If being used to display
72 c0cc7cc4 2009-08-21 t.lainson multipage documents,
73 c0cc7cc4 2009-08-21 t.lainson only one file may be specified on the command line.
77 c0cc7cc4 2009-08-21 t.lainson option sets the resolution for PostScript and PDF
78 c0cc7cc4 2009-08-21 t.lainson files, in pixels per inch.
79 c0cc7cc4 2009-08-21 t.lainson The default is 100 ppi.
82 c0cc7cc4 2009-08-21 t.lainson option reverses the order in which pages are displayed.
84 c0cc7cc4 2009-08-21 t.lainson When viewing a document,
86 c0cc7cc4 2009-08-21 t.lainson will try to guess the true bounding box, usually rounding up from
87 c0cc7cc4 2009-08-21 t.lainson the file's bounding box to
88 c0cc7cc4 2009-08-21 t.lainson 8½×11 or A4 size.
91 c0cc7cc4 2009-08-21 t.lainson option causes it to respect the bounding box given in the file.
92 c0cc7cc4 2009-08-21 t.lainson As a more general problem,
93 c0cc7cc4 2009-08-21 t.lainson some PostScript files claim to conform to Adobe's
94 c0cc7cc4 2009-08-21 t.lainson Document Structuring Conventions but do not.
97 c0cc7cc4 2009-08-21 t.lainson option enables a slightly slower and slightly more
98 c0cc7cc4 2009-08-21 t.lainson skeptical version of the PostScript processing code.
99 c0cc7cc4 2009-08-21 t.lainson Unfortunately, there are PostScript documents
100 c0cc7cc4 2009-08-21 t.lainson that can only be viewed with the
102 c0cc7cc4 2009-08-21 t.lainson option, and there are PostScript documents that
103 c0cc7cc4 2009-08-21 t.lainson can only be viewed without it.
105 977b25a7 2020-08-14 rsc When viewing images with
106 c0cc7cc4 2009-08-21 t.lainson .IR page ,
107 977b25a7 2020-08-14 rsc it listens to the
108 c0cc7cc4 2009-08-21 t.lainson .B image
109 c0cc7cc4 2009-08-21 t.lainson plumbing channel
111 d32deab1 2020-08-16 rsc .MR plumber (4) )
112 c0cc7cc4 2009-08-21 t.lainson for more images to display.
115 977b25a7 2020-08-14 rsc option causes
117 977b25a7 2020-08-14 rsc to not load any graphics files nor to read
118 c0cc7cc4 2009-08-21 t.lainson from standard input but rather to listen
119 c0cc7cc4 2009-08-21 t.lainson for ones to load from the plumbing channel.
123 c0cc7cc4 2009-08-21 t.lainson option turns on extra debugging output, and
126 c0cc7cc4 2009-08-21 t.lainson option turns on even more debugging output.
129 977b25a7 2020-08-14 rsc option causes
130 c0cc7cc4 2009-08-21 t.lainson .I page
131 c0cc7cc4 2009-08-21 t.lainson to call
133 977b25a7 2020-08-14 rsc .IR abort (3)
134 c0cc7cc4 2009-08-21 t.lainson rather than exit cleanly on errors,
135 c0cc7cc4 2009-08-21 t.lainson to facilitate debugging.
137 c0cc7cc4 2009-08-21 t.lainson Pressing and holding button 1 permits panning about the page.
139 c0cc7cc4 2009-08-21 t.lainson Button 2 raises a menu of operations on the current image or the
140 c0cc7cc4 2009-08-21 t.lainson entire set. The image transformations are non-destructive and are
141 c0cc7cc4 2009-08-21 t.lainson valid only for the currently displayed image. They are lost as soon
142 c0cc7cc4 2009-08-21 t.lainson as another image is displayed.
143 c0cc7cc4 2009-08-21 t.lainson The button 2 menu operations are:
144 c0cc7cc4 2009-08-21 t.lainson .TF Resize
146 c0cc7cc4 2009-08-21 t.lainson .B Orig size
147 c0cc7cc4 2009-08-21 t.lainson Restores the image to the original. All modifications are lost.
149 c0cc7cc4 2009-08-21 t.lainson .B Zoom
150 977b25a7 2020-08-14 rsc Prompts the user to sweep a rectangle on the image which is
151 c0cc7cc4 2009-08-21 t.lainson expanded proportionally to the rectangle.
153 c0cc7cc4 2009-08-21 t.lainson .B Fit window
154 c0cc7cc4 2009-08-21 t.lainson Resizes the image so that it fits in the current window.
156 c0cc7cc4 2009-08-21 t.lainson .B Rotate 90
157 c0cc7cc4 2009-08-21 t.lainson Rotates the image 90 degrees clockwise
159 c0cc7cc4 2009-08-21 t.lainson .B Upside down
160 c0cc7cc4 2009-08-21 t.lainson Toggles whether images are displayed upside-down.
162 c0cc7cc4 2009-08-21 t.lainson .B Next
163 c0cc7cc4 2009-08-21 t.lainson Displays the next page.
165 c0cc7cc4 2009-08-21 t.lainson .B Prev
166 c0cc7cc4 2009-08-21 t.lainson Displays the previous page.
168 c0cc7cc4 2009-08-21 t.lainson .B Zerox
169 977b25a7 2020-08-14 rsc Displays the current image in a new page window.
170 c0cc7cc4 2009-08-21 t.lainson Useful for selecting important pages from large documents.
172 c0cc7cc4 2009-08-21 t.lainson .B Reverse
173 c0cc7cc4 2009-08-21 t.lainson Reverses the order in which pages are displayed.
175 c0cc7cc4 2009-08-21 t.lainson .B Write
176 c0cc7cc4 2009-08-21 t.lainson Writes the image to file.
179 c0cc7cc4 2009-08-21 t.lainson Button 3 raises a menu of the
181 c0cc7cc4 2009-08-21 t.lainson to be selected for viewing in any order.
183 c0cc7cc4 2009-08-21 t.lainson Typing a
186 c0cc7cc4 2009-08-21 t.lainson control-D exits the program.
187 c0cc7cc4 2009-08-21 t.lainson Typing a
189 c0cc7cc4 2009-08-21 t.lainson toggles whether images are displayed upside-down.
190 c0cc7cc4 2009-08-21 t.lainson (This is useful in the common case of mistransmitted upside-down faxes).
191 c0cc7cc4 2009-08-21 t.lainson Typing a
193 c0cc7cc4 2009-08-21 t.lainson reverses the order in which pages are displayed.
196 c0cc7cc4 2009-08-21 t.lainson will write the currently viewed page to a new file as a compressed
197 d32deab1 2020-08-16 rsc .MR image (7)
199 c0cc7cc4 2009-08-21 t.lainson When possible, the filename is of the form
200 c0cc7cc4 2009-08-21 t.lainson .IR basename . pagenum . bit .
203 c0cc7cc4 2009-08-21 t.lainson removes an image from the working set.
205 c0cc7cc4 2009-08-21 t.lainson To go to a specific page, one can type its number followed by enter.
206 c0cc7cc4 2009-08-21 t.lainson Typing left arrow, backspace, or minus displays the previous page.
207 c0cc7cc4 2009-08-21 t.lainson Typing right arrow, space, or enter displays the next page.
208 c0cc7cc4 2009-08-21 t.lainson The up and down arrow pan up and down one half screen height,
209 c0cc7cc4 2009-08-21 t.lainson changing pages when panning off the top or bottom of the page.
211 c0cc7cc4 2009-08-21 t.lainson .I Page
215 c0cc7cc4 2009-08-21 t.lainson to draw each page of PostScript
218 c0cc7cc4 2009-08-21 t.lainson .IR files .
219 c0cc7cc4 2009-08-21 t.lainson It also calls a variety of conversion programs, such as those described in
220 d32deab1 2020-08-16 rsc .MR jpg (1) ,
221 c0cc7cc4 2009-08-21 t.lainson to convert the various raster graphics formats
222 c0cc7cc4 2009-08-21 t.lainson into Inferno bitmap files.
223 c0cc7cc4 2009-08-21 t.lainson Pages are converted ``on the fly,'' as needed.
224 c0cc7cc4 2009-08-21 t.lainson .SH EXAMPLES
227 c0cc7cc4 2009-08-21 t.lainson page /sys/src/cmd/gs/examples/tiger.eps
228 c0cc7cc4 2009-08-21 t.lainson Display a color PostScript file.
231 c0cc7cc4 2009-08-21 t.lainson page /usr/inferno/icons/*.bit
232 c0cc7cc4 2009-08-21 t.lainson Browse the Inferno bitmap library.
235 c0cc7cc4 2009-08-21 t.lainson man -t page | page -w
236 c0cc7cc4 2009-08-21 t.lainson Preview this manual in a new window.
237 058b0118 2005-01-03 devnull .SH "SEE ALSO
238 d32deab1 2020-08-16 rsc .MR gs (1) ,
239 d32deab1 2020-08-16 rsc .MR jpg (1) ,
240 d32deab1 2020-08-16 rsc .MR proof (1) ,
241 d32deab1 2020-08-16 rsc .MR tex (1) ,
242 d32deab1 2020-08-16 rsc .MR troff (1)
243 058b0118 2005-01-03 devnull .SH SOURCE
244 c0cc7cc4 2009-08-21 t.lainson .B \*9/src/cmd/page
245 c0cc7cc4 2009-08-21 t.lainson .SH DIAGNOSTICS
246 c0cc7cc4 2009-08-21 t.lainson The mouse cursor changes to an arrow and ellipsis
248 c0cc7cc4 2009-08-21 t.lainson .I page
249 c0cc7cc4 2009-08-21 t.lainson is reading or writing a file.
250 f6bc9149 2005-01-11 devnull .SH BUGS
251 c0cc7cc4 2009-08-21 t.lainson .I Page
252 c0cc7cc4 2009-08-21 t.lainson supports reading of only one document
253 c0cc7cc4 2009-08-21 t.lainson file at a time, and
254 c0cc7cc4 2009-08-21 t.lainson the user interface is clumsy when viewing very large documents.
256 c0cc7cc4 2009-08-21 t.lainson When viewing multipage PostScript files that do not contain
257 c0cc7cc4 2009-08-21 t.lainson .RB `` %%Page ''
258 c0cc7cc4 2009-08-21 t.lainson comments, the button 3 menu only contains
259 c0cc7cc4 2009-08-21 t.lainson ``this page'' and ``next page'':
260 977b25a7 2020-08-14 rsc correctly determining
261 c0cc7cc4 2009-08-21 t.lainson page boundaries in Postscript code is not computable
262 c0cc7cc4 2009-08-21 t.lainson in the general case.
266 c0cc7cc4 2009-08-21 t.lainson has trouble viewing a Postscript file,
267 977b25a7 2020-08-14 rsc it might not be exactly conforming: try viewing it with the
269 c0cc7cc4 2009-08-21 t.lainson option.
271 c0cc7cc4 2009-08-21 t.lainson The interface to the plumber is unsatisfactory. In particular,
272 977b25a7 2020-08-14 rsc document references cannot be sent
273 c0cc7cc4 2009-08-21 t.lainson via plumbing messages.
275 c0cc7cc4 2009-08-21 t.lainson There are too many keyboard commands and menu items.
277 b763f1e0 2011-10-31 rsc Displaying a PostScript or PDF file depends both on having
280 d32deab1 2020-08-16 rsc .MR gs (1) )
281 b763f1e0 2011-10-31 rsc installed and on the underlying operating system
282 b763f1e0 2011-10-31 rsc providing a file descriptor device tree at
283 b763f1e0 2011-10-31 rsc .BR /dev/fd .
285 b763f1e0 2011-10-31 rsc Some FreeBSD installations
286 b763f1e0 2011-10-31 rsc do not provide file descriptors greater than 2
288 b763f1e0 2011-10-31 rsc .BR /dev/fd .
289 b763f1e0 2011-10-31 rsc To fix this, add
292 b763f1e0 2011-10-31 rsc /fdescfs /dev/fd fdescfs rw 0 0
296 b763f1e0 2011-10-31 rsc .BR /etc/fstab ,
299 b763f1e0 2011-10-31 rsc .BR /dev/fd .
300 b763f1e0 2011-10-31 rsc (Adding the line to
302 b763f1e0 2011-10-31 rsc ensures causes FreeBSD to mount the file system
303 b763f1e0 2011-10-31 rsc automatically at boot time.)
