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