MAN.9FRONT.ORG RTFM


     PAGE(1)                                                   PAGE(1)

     NAME
          page - view FAX, image, graphic, PostScript, PDF, and
          typesetter output files

     SYNOPSIS
          page [ -iRw ] [ -p ppi ] [ -j addr ] [ file... ]

     DESCRIPTION
          Page is a general purpose document viewer.  It can be used
          to display the individual pages of a PostScript, PDF, or
          troff(1) device independent output file.  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 image(6) file, an Inferno bitmap
          file, or other common format).  Page displays these in
          sequence.  In the absence of named files, page reads one
          from standard input.

          By default, page runs in the window in which it is started
          and leaves the window unchanged.  The -R option causes page
          to grow the window if necessary to display the page being
          viewed.  The -w option causes page to create a new window
          for itself.  The newly created window will grow as under the
          -R option.

          The -p option sets the resolution for PostScript and PDF
          files, in pixels per inch.  The default is 100 ppi.

          When viewing images with page, it listens to the image
          plumbing channel (see plumber(4)) for more images to dis-
          play.  The -i option causes 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.

          The -j option with a page address addr jumps to the speci-
          fied page on startup.

          Pressing and holding button 1 permits panning about the
          page.

          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:

          Orig size
                  Restores the image to the original. All modifica-
                  tions are lost.
          Zoom    controls magnification.

     PAGE(1)                                                   PAGE(1)

          Fit     Resizes the image so that it fits in the current
                  window.
          Rotate 90
                  Rotates the image 90 degrees clockwise
          Upside down
                  Toggles whether images are displayed upside-down.
          Next    Displays the next page.
          Prev    Displays the previous page.
          Snarf   Writes the current page address to the snarf buffer.
          Zerox   Displays the current image in a new page window.
                  Useful for selecting important pages from large doc-
                  uments.
          Write   Asks for a filename and writes the current image as
                  Plan 9 bitmap.
          Ext     Shows the current image using external jpg(1) pro-
                  gram in a separate window. This is mostly useful for
                  animated gifs.

          Button 3 raises a menu of the pages to be selected for view-
          ing in any order.

          Typing a q or control-D exits the program.

          To go to a specific page, one can type its number followed
          by enter.  Typing left arrow or backspace displays the pre-
          vious 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.

          Page calls gs(1) to draw each page of PostScript and PDF
          files. It also calls a variety of conversion programs, such
          as those described in jpg(1), to convert the various raster
          graphics formats into Inferno bitmap files.  Pages are con-
          verted ``on the fly,'' as needed.

     EXAMPLES
          page /sys/src/cmd/gs/examples/tiger.eps
               Display a color PostScript file.

          page /usr/inferno/icons/*.bit
               Browse the Inferno bitmap library.

          page -j /sys/doc/troff.ps!7 /sys/doc/troff.ps
               Jump to page 7 in the troff manual.

          man -t page | page -w
               Preview this manual in a new window.

     SEE ALSO
          gs(1), jpg(1), troff(1)

     PAGE(1)                                                   PAGE(1)

     SOURCE
          /sys/src/cmd/page.c

     BUGS
          The interface to the plumber is experimental.

     HISTORY
          Page first appeared in Plan 9 from Bell Labs. It was rewrit-
          ten from scratch for 9front (September, 2011).