/* HPUX_ID: @(#)hpstar.w	29.1     86/06/19  */





hpstar [-_o_p_t_i_o_n(s)] [GPS _f_i_l_e(s)];  display GPS on a Hewlett-
Packard display

Displays the GPS on one of several devices supported by the 'Starbase'
graphics package.  The default display device is '/dev/tty', and the
default Starbase driver is 'hpterm'.  The device file can be changed
by setting the environment variable SB_OUTDEV or with the -f option.
The driver name can be changed by setting the environment variable
SB_OUTDRIVER or with the -d option.  A viewing window is computed
from the maximum and minimum points in the GPS _f_i_l_e(s) unless
the _r or _u option is provided.  If no _f_i_l_e is given, the
standard input is assumed.

Options:

     d_d_r_i_v_e_r   Use Starbase driver _d_r_i_v_e_r.
     f_f_i_l_e     Use device file _f_i_l_e.
     l         Gopen with the SPOOLED flag for output to a file.
     p_n        Select pen numbered _n.
     r_n        Window on GPS region _n, _n between 1 and 25
	       inclusive.
     s_n        Slant characters _n degrees counterclockwise
	       from the vertical.
     u         Window on the entire GPS universe.
     xd_n       Set x displacement of the viewport's lower
	       left corner to _n inches.
     xv_n       Set width of viewport to _n inches.
     yd_n       Set y displacement of the viewport's lower
	       left corner to _n inches.
     yv_n       Set height of viewport to _n inches.

Example:   hpstar -p3,s-20,xv12.5,yv10 A.g B.g
displays A.g and B.g together using pen number three and
slanting characters forward by 20 degrees.  The viewing
window is built to include all of both files, and the device
viewport is 12.5 by 10 inches.

(Note: additional Starbase devices can be supported by relinking
the hpstar.o with different device drivers; see Starbase(3g)
for linking details.)
