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 Πs laser printer.  This simply sends the Πs 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/{ documentname }.{ page }.ras, where documentname and page are replaced by the appropriate values.  This rasterfile 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)

If psfile is specified, the POSTSCRIPT code is taken from that file. 
If no argument is given, or if a ‘−’ is given as the argument, pageview reads the POSTSCRIPT program from standard input. 
 

SEE ALSO

psh(1), newsserverstr(1), lpr(1)
 

POSTSCRIPT Language Reference Manual , Adobe Systems Inc., Addison-Wesley
 

TRADEMARK

POSTSCRIPT is a registered trademark of Adobe Systems Inc

Sun Release 4.1  —  Last change: 28 June 1989