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 [
  14 .B -p
  15 .I ppi
  16 ]
  17 [
  18 .IR file ...
  19 ]
  20 .SH DESCRIPTION
  21 .I Page
  22 is a general purpose document viewer.
  23 It can be used to display the individual pages
  24 of a
  25 PostScript,
  26 PDF,
  27 or
  28 .IR tex (1)
  29 or
  30 .IR troff (1)
  31 device independent output
  32 file.
  33 .I Tex
  34 or
  35 .I troff
  36 output is simply converted to PostScript in order to be viewed.
  37 It can also be used to view any number of
  38 graphics files
  39 (such as a
  40 FAX
  41 page,
  42 a Plan 9
  43 .IR image (6)
  44 file, an Inferno bitmap file, or other common format).
  45 .I Page
  46 displays these
  47 in sequence.
  48 In the absence of named files,
  49 .I page
  50 reads one from standard input.
  51 .PP
  52 By default,
  53 .I page
  54 runs in the window in which it is started
  55 and leaves the window unchanged.
  56 The
  57 .B -R
  58 option causes
  59 .I page
  60 to grow the window if necessary
  61 to display the page being viewed.
  62 The
  63 .B -w
  64 option causes
  65 .I page
  66 to create a new window for itself.
  67 The newly created window will grow as under the
  68 .B -R
  69 option.
  70 If being used to display
  71 multipage documents,
  72 only one file may be specified on the command line.
  73 .PP
  74 The
  75 .B -p
  76 option sets the resolution for PostScript and PDF
  77 files, in pixels per inch.
  78 The default is 100 ppi.
  79 The
  80 .B -r
  81 option reverses the order in which pages are displayed.
  82 .PP
  83 When viewing images with
  84 .IR page ,
  85 it listens to the
  86 .B image
  87 plumbing channel
  88 (see
  89 .IR plumber (4))
  90 for more images to display.
  91 The
  92 .B -i
  93 option causes
  94 .I page
  95 to not load any graphics files nor to read
  96 from standard input but rather to listen
  97 for ones to load from the plumbing channel.
  98 .PP
  99 Pressing and holding button 1 permits panning about the page.
 100 .PP
 101 Button 2 raises a menu of operations on the current image or the
 102 entire set.  The image transformations are non-destructive and are
 103 valid only for the currently displayed image.  They are lost as soon
 104 as another image is displayed.
 105 The button 2 menu operations are:
 106 .TF Resize
 107 .TP
 108 .B Orig size
 109 Restores the image to the original. All modifications are lost.
 110 .TP
 111 .B Zoom
 112 controls magnification.
 113 .TP
 114 .B Fit
 115 Resizes the image so that it fits in the current window.
 116 .TP
 117 .B Rotate 90
 118 Rotates the image 90 degrees clockwise
 119 .TP
 120 .B Upside down
 121 Toggles whether images are displayed upside-down.
 122 .TP
 123 .B Next
 124 Displays the next page.
 125 .TP
 126 .B Prev
 127 Displays the previous page.
 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 usefull 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, backspace, or minus 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 man -t page | page -w
 183 Preview this manual in a new window.
 184 .SH "SEE ALSO
 185 .IR gs (1),
 186 .IR jpg (1),
 187 .IR tex (1),
 188 .IR troff (1)
 189 .SH SOURCE
 190 .B /sys/src/cmd/page.c
 191 .SH BUGS
 192 The interface to the plumber is unsatisfactory.  In particular,
 193 document references cannot be sent
 194 via plumbing messages.