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 .PD
 133 .PP
 134 Button 3 raises a menu of the
 135 pages
 136 to be selected for viewing in any order.
 137 .PP
 138 Typing a
 139 .B q
 140 or
 141 control-D exits the program.
 142 .PP
 143 To go to a specific page, one can type its number followed by enter.
 144 Typing left arrow, backspace, or minus displays the previous page.
 145 Typing right arrow, space, or enter displays the next page.
 146 The up and down arrow pan up and down one half screen height,
 147 changing pages when panning off the top or bottom of the page.
 148 .PP
 149 .I Page
 150 calls
 151 .IR gs (1)
 152 to draw each page of PostScript
 153 and
 154 PDF
 155 .IR files .
 156 It also calls a variety of conversion programs, such as those described in
 157 .IR jpg (1),
 158 to convert the various raster graphics formats
 159 into Inferno bitmap files.
 160 Pages are converted ``on the fly,'' as needed.
 161 .SH EXAMPLES
 162 .TP
 163 .L
 164 page /sys/src/cmd/gs/examples/tiger.eps
 165 Display a color PostScript file.
 166 .TP
 167 .L
 168 page /usr/inferno/icons/*.bit
 169 Browse the Inferno bitmap library.
 170 .TP
 171 .L
 172 man -t page | page -w
 173 Preview this manual in a new window.
 174 .SH "SEE ALSO
 175 .IR gs (1),
 176 .IR jpg (1),
 177 .IR tex (1),
 178 .IR troff (1)
 179 .SH SOURCE
 180 .B /sys/src/cmd/page.c
 181 .SH BUGS
 182 The interface to the plumber is unsatisfactory.  In particular,
 183 document references cannot be sent
 184 via plumbing messages.