Title:      ReGIS to HP-GL Conversion Program

     Routine Name:     RHP

     File  Name:       RHP.FTN

     Author:           N. Hoult

     Description:

     This routine converts a file of ReGIS commands into HP-GL
     commands for the 7470A plotter, which it drives down the HPIB
     interface.  The plotter should be set to 'listen only' mode
     (i.e. HPIB address 31); the computer HPIB address is assumed
     to be 9.  If this is not the case, edit parameter COMADR in
     routine IEEE (in this file) appropriately.  Any ReGIS command is
     accepted, only the following are interpreted:

     S(E)        -     Interpreted as end of plot.  Program pauses
                       for paper to be changed

     S(A[..][..])-     Interpreted as for VT125

     W(F..)      -     Interpreted as pen select.  Note that pen 1 and
                       pen 3 produce the same results.

     W(P..)      -     Select writing pattern. Pattern 1 (the default)
                       is a solid line, but the other numbers do not
                       necessarily correspond to the same patterns as
                       on the VT125.  The form W(P10110) is not accepted.

     W(P(M..))   -     Set pattern multiplier

     T(S..)      -     Text size, as for VT125

     T'...'
  OR T"..."      -     Text, as for VT125

     P[..][..].. -     Cursor move, as for VT125.  Both absolute and
                       relative moves are allowed, but x and y must be
                       both absolute or both relative: a warning message
                       is printed if not.  Both this and the V command
                       may be split between coordinate pairs to occupy
                       several lines; other commands may not be split.

     V[..][..].. -     Vector command.  See comments above.

     To use, install as ...RHP (or use 'catchall' feature), connect
     plotter to HPIB and set its address to 31.  Type either

        RHP <filename>

     or

        RHP

     (in which case it will prompt for the file name).


     Modification List:
     1.A  Date:  12-Nov-84   ORIGINAL
     1.B  Date:  15-Nov-84   Correct text position, ignore carr. ctl. chars
     1.C  Date:  16-Nov-84   Trap HPIB errors
     1.D  Date:  20-Nov-84   Take command line
     1.E  Date:  26-Nov-84   Better parsing - take macrographs
     1.F  Date:  29-Nov-84   Better parsing - take T'...' '...'
     1.G  Date:  07-Dec-84   Accept W(P...)
     1.H  Date:  20-Mar-85   Fix bug with zero-length input lines
     1.I  Date:  17-Apr-85   Fix bugs with pattern control + absence of
                             carriage controls
     1.J  Date:  12-Dec-85   Make HPIB address a parameter

     Restrictions:     Maximum macrograph length, and maximum length of
                       a line after interpreting macrographs, is 1000 chars.

     Calling Sequence: Connect plotter to HPIB, type RHP <filename>

     External Routines called:     GETCDS, IPOS, LENGTH, ERRISB, ERRDSW

     Common Blocks:    None