'\"macro stdmacro
.if n .pH g1.pageview @(#)pageview	40.2 of 12/29/89
.ig
Revised: D. Bodnar 9/7/89
format -dqm4 -man6 -rs1 pageview.1
..
.\" @(#)pageview.1 1.2 89/06/28
.nr X
.if \nX=0 .ds x} PAGEVIEW 1 "28 June 1989" "\&"
.if \nX=1 .ds x} PAGEVIEW 1 "28 June 1989"
.if \nX=2 .ds x} PAGEVIEW 1 "" "\&"
.if \nX=3 .ds x} PAGEVIEW "" "" "\&"
.TH \*(x}
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.IX pageview#(1) "" "\fLpageview\fP(1)"
.SH NAME
pageview \- \*(Ps language previewer for NeWS
.SH SYNOPSIS
.B pageview
[
.BI \-display "NEWSSERVER"
]
[
.BI \-geometry "WxH+X+Y"
]
[
.B \-mono
]
[
.BI \-w "paperwidth"
]
[
.BI \-h "paperheight"
]
[
.BI \-dpi "dots/inch"
]
[
.BI \-page "page"
]
[
.BI \-dir "directory"
]
[
.B \-left|right|upsidedown
]
[
.B \-verbose
]
[
.I psfile
|
\-
]
.SH DESCRIPTION
.B pageview
is an interactive \*(Ps previewer.  Unlike it's predecessor psview,
.B pageview
does not attempt to fit the whole page into a given window.
.B 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
.B pageview
window which are described below:

.TP 5
.B 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.
.TP 5
.B 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.
.B pageview
starts out at 80 dpi, unless you have the environment variable $DPI set to
some other default, or you use the \f3\-dpi\f1 command line argument.
.TP 5
.B 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
.B \-height
and
.B \-width
command line arguements.
.TP 5
.B 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.
.TP 5
.B Print:
There are three options to printing pages from
.B 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/{
.I documentname
}.{
.I page
}.ras, where
.I documentname
and
.I page
are replaced by the appropriate values.  This rasterfile can be edited by
SunPaint, or printed on any other device capable of rendering bitmaps.

.SH OPTIONS
.TP 5
.BI \-display NEWSSERVER
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.
.TP 5
.BI \-geometry WxH+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.
.TP 5
.B \-mono
is used to force pageview to use a monochrome retained canvas on color
systems.  This saves memory and is faster on some framebuffers.
.TP 5
.BI \-w paperwidth
sets the width of the "paper" to
.IR paperwidth
inches, the default is 8.5.
.TP 5
.BI \-h paperheight
sets the height of the "paper" to
.IR paperheight
inches, the default is 11.
.TP 5
.BI \-dpi dots/inch
sets the "dpi" of the "paper" to
.IR 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.
.TP 5
.BI \-dir directory
Sets the current working directory to
.IR directory
so that you can type filenames at the "Load File: " prompt relative to
.IR directory
.TP 5
.B \-left|right|upsidedown
Sets the rotation of the page.
.TP 5
.B \-verbose
Prints lots of debugging information (not useful to the user)
.TP 0
If \fIpsfile\fP is specified, the \*(Ps code is taken from that file.
If no argument is given, or if a `\-' is given as the argument,
.B pageview
reads the \*(Ps program from standard input.

.SH "SEE ALSO"
psh(1), newsserverstr(1), lpr(1)

.LP
.I "\*(Ps Language Reference Manual", Adobe Systems Inc., Addison-Wesley

.SH TRADEMARK
\*(Ps is a registered trademark of Adobe Systems Inc
