5 image, graphic, PostScript, PDF, and
22 is a general purpose document viewer.
23 It can be used to display the individual pages
32 device-independent output
37 output is simply converted to PostScript in order to be viewed.
38 It can also be used to view any number of
45 file, an Inferno bitmap file, or other common format).
49 In the absence of named files,
51 reads one from standard input.
55 runs in the window in which it is started
56 and leaves the window unchanged.
61 to grow the window if necessary
62 to display the page being viewed.
67 to create a new window for itself.
68 The newly created window will grow as under the
71 If being used to display
73 only one file may be specified on the command line.
77 option sets the resolution for PostScript and PDF
78 files, in pixels per inch.
79 The default is 100 ppi.
82 option reverses the order in which pages are displayed.
84 When viewing a document,
86 will try to guess the true bounding box, usually rounding up from
87 the file's bounding box to
91 option causes it to respect the bounding box given in the file.
92 As a more general problem,
93 some PostScript files claim to conform to Adobe's
94 Document Structuring Conventions but do not.
97 option enables a slightly slower and slightly more
98 skeptical version of the PostScript processing code.
99 Unfortunately, there are PostScript documents
100 that can only be viewed with the
102 option, and there are PostScript documents that
103 can only be viewed without it.
105 When viewing images with
112 for more images to display.
117 to not load any graphics files nor to read
118 from standard input but rather to listen
119 for ones to load from the plumbing channel.
123 option turns on extra debugging output, and
126 option turns on even more debugging output.
134 rather than exit cleanly on errors,
135 to facilitate debugging.
137 Pressing and holding button 1 permits panning about the page.
139 Button 2 raises a menu of operations on the current image or the
140 entire set. The image transformations are non-destructive and are
141 valid only for the currently displayed image. They are lost as soon
142 as another image is displayed.
143 The button 2 menu operations are:
147 Restores the image to the original. All modifications are lost.
150 Prompts the user to sweep a rectangle on the image which is
151 expanded proportionally to the rectangle.
154 Resizes the image so that it fits in the current window.
157 Rotates the image 90 degrees clockwise
160 Toggles whether images are displayed upside-down.
163 Displays the next page.
166 Displays the previous page.
169 Displays the current image in a new page window.
170 Useful for selecting important pages from large documents.
173 Reverses the order in which pages are displayed.
176 Writes the image to file.
179 Button 3 raises a menu of the
181 to be selected for viewing in any order.
186 control-D exits the program.
189 toggles whether images are displayed upside-down.
190 (This is useful in the common case of mistransmitted upside-down faxes).
193 reverses the order in which pages are displayed.
196 will write the currently viewed page to a new file as a compressed
199 When possible, the filename is of the form
200 .IR basename . pagenum . bit .
203 removes an image from the working set.
205 To go to a specific page, one can type its number followed by enter.
206 Typing left arrow, backspace, or minus displays the previous page.
207 Typing right arrow, space, or enter displays the next page.
208 The up and down arrow pan up and down one half screen height,
209 changing pages when panning off the top or bottom of the page.
215 to draw each page of PostScript
219 It also calls a variety of conversion programs, such as those described in
221 to convert the various raster graphics formats
222 into Inferno bitmap files.
223 Pages are converted ``on the fly,'' as needed.
227 page /sys/src/cmd/gs/examples/tiger.eps
228 Display a color PostScript file.
231 page /usr/inferno/icons/*.bit
232 Browse the Inferno bitmap library.
235 man -t page | page -w
236 Preview this manual in a new window.
246 The mouse cursor changes to an arrow and ellipsis
249 is reading or writing a file.
252 supports reading of only one document
254 the user interface is clumsy when viewing very large documents.
256 When viewing multipage PostScript files that do not contain
258 comments, the button 3 menu only contains
259 ``this page'' and ``next page'':
260 correctly determining
261 page boundaries in Postscript code is not computable
266 has trouble viewing a Postscript file,
267 it might not be exactly conforming: try viewing it with the
271 The interface to the plumber is unsatisfactory. In particular,
272 document references cannot be sent
273 via plumbing messages.
275 There are too many keyboard commands and menu items.
277 Displaying a PostScript or PDF file depends both on having
281 installed and on the underlying operating system
282 providing a file descriptor device tree at
285 Some FreeBSD installations
286 do not provide file descriptors greater than 2
292 /fdescfs /dev/fd fdescfs rw 0 0
302 ensures causes FreeBSD to mount the file system
303 automatically at boot time.)