sys/man/1/page

   1 .TH PAGE 1
   2 .SH NAME
   3 page \- view
   4 FAX,
   5 image, graphic, PostScript, PDF, and
   6 typesetter output
   7 files
   8 .SH SYNOPSIS
   9 .B page
  10 [
  11 .B -abirPRvVw
  12 ] [
  13 .B -p
  14 .I ppi
  15 ] [
  16 .B -j
  17 .I addr
  18 ] [
  19 .IR file ...
  20 ]
  21 .SH DESCRIPTION
  22 .I Page
  23 is a general purpose document viewer.
  24 It can be used to display the individual pages
  25 of a
  26 PostScript,
  27 PDF,
  28 or
  29 .IR tex (1)
  30 or
  31 .IR troff (1)
  32 device independent output
  33 file.
  34 .I Tex
  35 or
  36 .I troff
  37 output is simply converted to PostScript in order to be viewed.
  38 It can also be used to view any number of
  39 graphics files
  40 (such as a
  41 FAX
  42 page,
  43 a Plan 9
  44 .IR image (6)
  45 file, an Inferno bitmap file, or other common format).
  46 .I Page
  47 displays these
  48 in sequence.
  49 In the absence of named files,
  50 .I page
  51 reads one from standard input.
  52 .PP
  53 By default,
  54 .I page
  55 runs in the window in which it is started
  56 and leaves the window unchanged.
  57 The
  58 .B -R
  59 option causes
  60 .I page
  61 to grow the window if necessary
  62 to display the page being viewed.
  63 The
  64 .B -w
  65 option causes
  66 .I page
  67 to create a new window for itself.
  68 The newly created window will grow as under the
  69 .B -R
  70 option.
  71 If being used to display
  72 multipage documents,
  73 only one file may be specified on the command line.
  74 .PP
  75 The
  76 .B -p
  77 option sets the resolution for PostScript and PDF
  78 files, in pixels per inch.
  79 The default is 100 ppi.
  80 The
  81 .B -r
  82 option reverses the order in which pages are displayed.
  83 .PP
  84 When viewing images with
  85 .IR page ,
  86 it listens to the
  87 .B image
  88 plumbing channel
  89 (see
  90 .IR plumber (4))
  91 for more images to display.
  92 The
  93 .B -i
  94 option causes
  95 .I page
  96 to not load any graphics files nor to read
  97 from standard input but rather to listen
  98 for ones to load from the plumbing channel.
  99 .PP
 100 The
 101 .B -j
 102 option with a page address
 103 .I addr
 104 jumps to the specified page on startup.
 105 .PP
 106 Pressing and holding button 1 permits panning about the page.
 107 .PP
 108 Button 2 raises a menu of operations on the current image or the
 109 entire set.  The image transformations are non-destructive and are
 110 valid only for the currently displayed image.  They are lost as soon
 111 as another image is displayed.
 112 The button 2 menu operations are:
 113 .TF Resize
 114 .TP
 115 .B Orig size
 116 Restores the image to the original. All modifications are lost.
 117 .TP
 118 .B Zoom
 119 controls magnification.
 120 .TP
 121 .B Fit
 122 Resizes the image so that it fits in the current window.
 123 .TP
 124 .B Rotate 90
 125 Rotates the image 90 degrees clockwise
 126 .TP
 127 .B Upside down
 128 Toggles whether images are displayed upside-down.
 129 .TP
 130 .B Next
 131 Displays the next page.
 132 .TP
 133 .B Prev
 134 Displays the previous page.
 135 .TP
 136 .B Snarf
 137 Writes the current page address to the snarf buffer.
 138 .TP
 139 .B Zerox
 140 Displays the current image in a new page window.
 141 Useful for selecting important pages from large documents.
 142 .TP
 143 .B Write
 144 Asks for a filename and writes the current image as
 145 Plan 9 bitmap.
 146 .TP
 147 .B Ext
 148 Shows the current image using external
 149 .IR jpg (1)
 150 program in a separate window. This is mostly useful for
 151 animated gifs.
 152 .PD
 153 .PP
 154 Button 3 raises a menu of the
 155 pages
 156 to be selected for viewing in any order.
 157 .PP
 158 Typing a
 159 .B q
 160 or
 161 control-D exits the program.
 162 .PP
 163 To go to a specific page, one can type its number followed by enter.
 164 Typing left arrow, backspace, or minus displays the previous page.
 165 Typing right arrow, space, or enter displays the next page.
 166 The up and down arrow pan up and down one half screen height,
 167 changing pages when panning off the top or bottom of the page.
 168 .PP
 169 .I Page
 170 calls
 171 .IR gs (1)
 172 to draw each page of PostScript
 173 and
 174 PDF
 175 .IR files .
 176 It also calls a variety of conversion programs, such as those described in
 177 .IR jpg (1),
 178 to convert the various raster graphics formats
 179 into Inferno bitmap files.
 180 Pages are converted ``on the fly,'' as needed.
 181 .SH EXAMPLES
 182 .TP
 183 .L
 184 page /sys/src/cmd/gs/examples/tiger.eps
 185 Display a color PostScript file.
 186 .TP
 187 .L
 188 page /usr/inferno/icons/*.bit
 189 Browse the Inferno bitmap library.
 190 .TP
 191 .L
 192 page -j /sys/doc/troff.pdf!7 /sys/doc/troff.pdf
 193 Jump to page 7 in the troff manual.
 194 .TP
 195 .L
 196 man -t page | page -w
 197 Preview this manual in a new window.
 198 .SH "SEE ALSO
 199 .IR gs (1),
 200 .IR jpg (1),
 201 .IR tex (1),
 202 .IR troff (1)
 203 .SH SOURCE
 204 .B /sys/src/cmd/page.c
 205 .SH BUGS
 206 The interface to the plumber is experimental.
 207 .SH HISTORY
 208 .I Page
 209 first appeared in Plan 9 from Bell Labs. It was rewritten from
 210 scratch for 9front (September, 2011).