48d2f14f80
add new functions pageaddr() that returns a string describing the page to be loaded. it is in the form of: /path/to/file!pagename!subpage!.... one can jump to such a page by calling trywalk(name, addr) where name and addr get concatinated with ! to form a page address and then the currently loaded pages are walked up to the nearest page which is then returned. (or nil when not found). the remaining address will be set in the global pagewalk variable. once pages get loaded (asynchronously), pagewalk1() gets called again on addpage() and continues the walking up to the last page. new program flag -j <addr> was added to jump to a page on startup. page address (without filename) can also be supplied in plumb message with the "addr" attribute.
208 lines
4.1 KiB
Text
208 lines
4.1 KiB
Text
.TH PAGE 1
|
|
.SH NAME
|
|
page \- view
|
|
FAX,
|
|
image, graphic, PostScript, PDF, and
|
|
typesetter output
|
|
files
|
|
.SH SYNOPSIS
|
|
.B page
|
|
[
|
|
.B -abirPRvVw
|
|
] [
|
|
.B -p
|
|
.I ppi
|
|
] [
|
|
.B -j
|
|
.I addr
|
|
] [
|
|
.IR file ...
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Page
|
|
is a general purpose document viewer.
|
|
It can be used to display the individual pages
|
|
of a
|
|
PostScript,
|
|
PDF,
|
|
or
|
|
.IR tex (1)
|
|
or
|
|
.IR troff (1)
|
|
device independent output
|
|
file.
|
|
.I Tex
|
|
or
|
|
.I troff
|
|
output is simply converted to PostScript in order to be viewed.
|
|
It can also be used to view any number of
|
|
graphics files
|
|
(such as a
|
|
FAX
|
|
page,
|
|
a Plan 9
|
|
.IR image (6)
|
|
file, an Inferno bitmap file, or other common format).
|
|
.I Page
|
|
displays these
|
|
in sequence.
|
|
In the absence of named files,
|
|
.I page
|
|
reads one from standard input.
|
|
.PP
|
|
By default,
|
|
.I page
|
|
runs in the window in which it is started
|
|
and leaves the window unchanged.
|
|
The
|
|
.B -R
|
|
option causes
|
|
.I page
|
|
to grow the window if necessary
|
|
to display the page being viewed.
|
|
The
|
|
.B -w
|
|
option causes
|
|
.I page
|
|
to create a new window for itself.
|
|
The newly created window will grow as under the
|
|
.B -R
|
|
option.
|
|
If being used to display
|
|
multipage documents,
|
|
only one file may be specified on the command line.
|
|
.PP
|
|
The
|
|
.B -p
|
|
option sets the resolution for PostScript and PDF
|
|
files, in pixels per inch.
|
|
The default is 100 ppi.
|
|
The
|
|
.B -r
|
|
option reverses the order in which pages are displayed.
|
|
.PP
|
|
When viewing images with
|
|
.IR page ,
|
|
it listens to the
|
|
.B image
|
|
plumbing channel
|
|
(see
|
|
.IR plumber (4))
|
|
for more images to display.
|
|
The
|
|
.B -i
|
|
option causes
|
|
.I page
|
|
to not load any graphics files nor to read
|
|
from standard input but rather to listen
|
|
for ones to load from the plumbing channel.
|
|
.PP
|
|
The
|
|
.B -j
|
|
option with a page address
|
|
.I addr
|
|
jumps to the specified page on startup.
|
|
.PP
|
|
Pressing and holding button 1 permits panning about the page.
|
|
.PP
|
|
Button 2 raises a menu of operations on the current image or the
|
|
entire set. The image transformations are non-destructive and are
|
|
valid only for the currently displayed image. They are lost as soon
|
|
as another image is displayed.
|
|
The button 2 menu operations are:
|
|
.TF Resize
|
|
.TP
|
|
.B Orig size
|
|
Restores the image to the original. All modifications are lost.
|
|
.TP
|
|
.B Zoom
|
|
controls magnification.
|
|
.TP
|
|
.B Fit
|
|
Resizes the image so that it fits in the current window.
|
|
.TP
|
|
.B Rotate 90
|
|
Rotates the image 90 degrees clockwise
|
|
.TP
|
|
.B Upside down
|
|
Toggles whether images are displayed upside-down.
|
|
.TP
|
|
.B Next
|
|
Displays the next page.
|
|
.TP
|
|
.B Prev
|
|
Displays the previous page.
|
|
.TP
|
|
.B Snarf
|
|
Writes the current page address to the snarf buffer.
|
|
.TP
|
|
.B Zerox
|
|
Displays the current image in a new page window.
|
|
Useful for selecting important pages from large documents.
|
|
.TP
|
|
.B Write
|
|
Asks for a filename and writes the current image as
|
|
Plan 9 bitmap.
|
|
.TP
|
|
.B Ext
|
|
Shows the current image using external
|
|
.IR jpg (1)
|
|
program in a separate window. This is mostly useful for
|
|
animated gifs.
|
|
.PD
|
|
.PP
|
|
Button 3 raises a menu of the
|
|
pages
|
|
to be selected for viewing in any order.
|
|
.PP
|
|
Typing a
|
|
.B q
|
|
or
|
|
control-D exits the program.
|
|
.PP
|
|
To go to a specific page, one can type its number followed by enter.
|
|
Typing left arrow, backspace, or minus displays the previous page.
|
|
Typing right arrow, space, or enter displays the next page.
|
|
The up and down arrow pan up and down one half screen height,
|
|
changing pages when panning off the top or bottom of the page.
|
|
.PP
|
|
.I Page
|
|
calls
|
|
.IR gs (1)
|
|
to draw each page of PostScript
|
|
and
|
|
PDF
|
|
.IR files .
|
|
It also calls a variety of conversion programs, such as those described in
|
|
.IR jpg (1),
|
|
to convert the various raster graphics formats
|
|
into Inferno bitmap files.
|
|
Pages are converted ``on the fly,'' as needed.
|
|
.SH EXAMPLES
|
|
.TP
|
|
.L
|
|
page /sys/src/cmd/gs/examples/tiger.eps
|
|
Display a color PostScript file.
|
|
.TP
|
|
.L
|
|
page /usr/inferno/icons/*.bit
|
|
Browse the Inferno bitmap library.
|
|
.TP
|
|
.L
|
|
page -j /sys/doc/troff.pdf!7 /sys/doc/troff.pdf
|
|
Jump to page 7 in the troff manual.
|
|
.TP
|
|
.L
|
|
man -t page | page -w
|
|
Preview this manual in a new window.
|
|
.SH "SEE ALSO
|
|
.IR gs (1),
|
|
.IR jpg (1),
|
|
.IR tex (1),
|
|
.IR troff (1)
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/page.c
|
|
.SH BUGS
|
|
The interface to the plumber is unsatisfactory. In particular,
|
|
document references cannot be sent
|
|
via plumbing messages.
|