5 image, graphic, PostScript, PDF, and
22 is a general purpose document viewer.
23 It can be used to display the individual pages
31 device-independent output
36 output is simply converted to PostScript in order to be viewed.
37 It can also be used to view any number of
44 file, an Inferno bitmap file, or other common format).
48 In the absence of named files,
50 reads one from standard input.
54 runs in the window in which it is started
55 and leaves the window unchanged.
60 to grow the window if necessary
61 to display the page being viewed.
66 to create a new window for itself.
67 The newly created window will grow as under the
70 If being used to display
72 only one file may be specified on the command line.
76 option sets the resolution for PostScript and PDF
77 files, in pixels per inch.
78 The default is 100 ppi.
81 option reverses the order in which pages are displayed.
83 When viewing a document,
85 will try to guess the true bounding box, usually rounding up from
86 the file's bounding box to
90 option causes it to respect the bounding box given in the file.
91 As a more general problem,
92 some PostScript files claim to conform to Adobe's
93 Document Structuring Conventions but do not.
96 option enables a slightly slower and slightly more
97 skeptical version of the PostScript processing code.
98 Unfortunately, there are PostScript documents
99 that can only be viewed with the
101 option, and there are PostScript documents that
102 can only be viewed without it.
104 When viewing images with
111 for more images to display.
116 to not load any graphics files nor to read
117 from standard input but rather to listen
118 for ones to load from the plumbing channel.
122 option turns on extra debugging output, and
125 option turns on even more debugging output.
131 Unix's \fIabort\fR(3)
132 rather than exit cleanly on errors,
133 to facilitate debugging.
135 Pressing and holding button 1 permits panning about the page.
137 Button 2 raises a menu of operations on the current image or the
138 entire set. The image transformations are non-destructive and are
139 valid only for the currently displayed image. They are lost as soon
140 as another image is displayed.
141 The button 2 menu operations are:
145 Restores the image to the original. All modifications are lost.
148 Prompts the user to sweep a rectangle on the image which is
149 expanded proportionally to the rectangle.
152 Resizes the image so that it fits in the current window.
155 Rotates the image 90 degrees clockwise
158 Toggles whether images are displayed upside-down.
161 Displays the next page.
164 Displays the previous page.
167 Displays the current image in a new page window.
168 Useful for selecting important pages from large documents.
171 Reverses the order in which pages are displayed.
174 Writes the image to file.
177 Button 3 raises a menu of the
179 to be selected for viewing in any order.
184 control-D exits the program.
187 toggles whether images are displayed upside-down.
188 (This is useful in the common case of mistransmitted upside-down faxes).
191 reverses the order in which pages are displayed.
194 will write the currently viewed page to a new file as a compressed
197 When possible, the filename is of the form
198 .IR basename . pagenum . bit .
201 removes an image from the working set.
203 To go to a specific page, one can type its number followed by enter.
204 Typing left arrow, backspace, or minus displays the previous page.
205 Typing right arrow, space, or enter displays the next page.
206 The up and down arrow pan up and down one half screen height,
207 changing pages when panning off the top or bottom of the page.
212 to draw each page of PostScript
216 It also calls a variety of conversion programs, such as those described in
218 to convert the various raster graphics formats
219 into Inferno bitmap files.
220 Pages are converted ``on the fly,'' as needed.
224 page /sys/src/cmd/gs/examples/tiger.eps
225 Display a color PostScript file.
228 page /usr/inferno/icons/*.bit
229 Browse the Inferno bitmap library.
232 man -t page | page -w
233 Preview this manual in a new window.
243 The mouse cursor changes to an arrow and ellipsis
246 is reading or writing a file.
249 supports reading of only one document
251 the user interface is clumsy when viewing very large documents.
253 When viewing multipage PostScript files that do not contain
255 comments, the button 3 menu only contains
256 ``this page'' and ``next page'':
257 correctly determining
258 page boundaries in Postscript code is not computable
263 has trouble viewing a Postscript file,
264 it might not be exactly conforming: try viewing it with the
268 The interface to the plumber is unsatisfactory. In particular,
269 document references cannot be sent
270 via plumbing messages.
272 There are too many keyboard commands and menu items.
274 Displaying a PostScript or PDF file depends both on having
278 installed and on the underlying operating system
279 providing a file descriptor device tree at
282 Some FreeBSD installations
283 do not provide file descriptors greater than 2
289 /fdescfs /dev/fd fdescfs rw 0 0
299 ensures causes FreeBSD to mount the file system
300 automatically at boot time.)