pageview(1)

POSTSCRIPT language previewer for NeWS

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

pageview - POSTSCRIPT language previewer for NeWS

SYNOPSIS

pageview [ -displayNEWSSERVER ] [ -geometryWxH+X+Y ] [ -mono
]  [  -wpaperwidth  ]  [ -hpaperheight ] [ -dpidots/inch ] [
-pagepage ] [ -dirdirectory ] [ -left|right|upsidedown  ]  [
-verbose ] [ psfile | - ]

DESCRIPTION

pageview is an interactive POSTSCRIPT previewer. Unlike it's predecessor psview, pageview does not attempt to fit the whole page into a given window. pageview renders a document, a page at a time, onto an offscreen bitmap which may be of arbitrary size, resolution and orientation. The user can then adjust the viewing window's size to see as much of the page as desired. The mouse buttons are used to position the page under the window in two different modes.

The left button moves the page in "relative mode". This allows you to move the page in a physically intuitive way. You press the left button on the page and while you drag the mouse around, the spot on the page that was under the mouse cursor when you pressed the button remains stationary relative to the cursor.

The middle button moves the page in "absolute mode". This allows you to easily get to the edges of the document, especially when the DPI is large and/or the window is small. When you press the middle button on a point in the window, the page is adjusted so that the same relative point on the page is under the mouse. For example, if you press the middle button at the top right corner of the window, you will see the top right corner of the page. A little experimentation with a page at 300 dpi and you will find this mode indispensible.

There are several buttons across the top of the pageview window which are described below:

Page:

In multipage documents this allows you to move to the Next, Previous, First and Last pages. In single page documents this menu is disabled. To go to an arbitrary page use the slider at the bottom of the window, or type in the page number at the "Page: " prompt to the left of the slider.

DPI: This lets you change the "resolution" of  the  retained
     bitmap  which  the page is being rendered onto.  36 dpi
     will make a US Letter sized  page  be  306x396  pixels,
     where  300 dpi would be 2490x3300 pixels.  This has the
     effect of making 36 dpi images appear smaller  and  300
     dpi pages appear larger due to the static resolution of
     the display.  pageview starts out at 80 dpi, unless you
     have  the  environment  variable $DPI set to some other
     default, or you use the -dpi command line argument.

Size:

This lets you change the size of the retained bitmap which the page is rendered onto. USLetter is 8.5x11, Legal is 8.5x14, and Envelope is 8.5x4.5. These values can be set to custom values by the -height and -width command line arguements.

Rotation:

This menu lets you choose which way to rotate the paper in 90 degree increments. This is useful for viewing slides which are commonly rendered in "Landscape left" orientation.

Print:

There  are  three  options  to  printing   pages   from
pageview.  You  can print the current page or the whole
document on a Ps laser printer.  This       simply sends  the
Ps  for  the current page to lpr(1), so you can use the
$PRINTER environment variable to  set  the  printer  to
use.   You  can  also  dump  the retained bitmap of the
current page to  a  rasterfile(5)  named  /tmp/{  docu-
mentname  }.{  page  }.ras, where documentname and page
are replaced by the appropriate values.   This  raster-
file can be edited by SunPaint, or printed on any other
device capable of rendering bitmaps.

OPTIONS

-displayNEWSSERVER

sets the NeWS server to connect to, this defaults to the value of the $NEWSSERVER environment variable. See newsserverstr(1) to find out how to set this variable.

-geometryWxH+X+Y

sets the location and size of the outer frame of pageview. The Width and Height are in pixels and the X and Y specify the lower left corner. For example, "pageview -display 200x400+100+100" will start a pageview, 200 wide and 400 tall with the lower left corner at 100,100.

-mono

is used to force pageview to use a monochrome retained canvas on color systems. This saves memory and is faster on some framebuffers.

-wpaperwidth

sets the width of the "paper" to paperwidth inches, the default is 8.5.

-hpaperheight

sets the height of the "paper" to paperheight inches, the default is 11.

-dpidots/inch

sets the "dpi" of the "paper" to dots/inch The environment variable $DPI is used if this option is not present, and the default is 80 if this variable is not in the environment. Caution must be used in setting this argument as well as the paper size args above, so you do not exhaust memory resources. For example a USLetter sized page previewed at 300 dpi, takes up 300*8.5/8*300*11 or a little over a Megabyte. The same page at 1500 dpi takes over 26 Megabytes.

-dirdirectory

Sets the current working directory to directory so that you can type filenames at the "Load File: " prompt relative to directory

-left|right|upsidedown

Sets the rotation of the page.

-verbose

Prints lots of debugging information (not useful to the user)

file.
     If psfile is specified, the POSTSCRIPT code is  taken  from  that
     If  no  argument is given, or if a `-' is given as the argu-
     ment, pageview reads the POSTSCRIPT  program  from  standard
     input.

TRADEMARK