  $           date:     December 7, 1984            i&           to:       HGraph DECUS Users            ,$           from:     Dennis V. Jensen#                     Ames Laboratory "                     310 Metallurgy6                     Ames, Iowa  50011     515/294-4823            -?           subject:  HGraf3 - An HGraph DECUS Release for REGIS.     B                The initial DECUS release of HGraph was at the FallB           1983  Symposium.   Release one was coded entirely in DECB           Fortran 66 compatible  code.   The  second  release  wasB           distributed  at  the Spring 1984 symposium.  Included inB           the second  release  was  a  new  WRTSTR  (extracted  asB           WRTST2.*)  which  would  generate  characters as vectorsB           (stroke font);  it was not dependent on  any  particularB           terminal's  character  generator.   Also, included was aB           cubic  spline   interpolation   line   drawing   routineB           (extracted  as  SMOOTH.*)  which was compatible with theB           DASHLN  calling  convention.   HGR550  files   on   thisB           distribution are the same as the second release (Hgraf2)B           files which support the Visual 550 (TEK4014  compatible)0           and the Bausch and Lomb DMPL plotters.  B                This  third  release  includes  support  for  REGISB           compatible  terminals.   It  was initially developed forB           the VT-125 terminal although it should work  with  otherB           REGIS compatible terminals.  Refer to the VT125.DOC fileB           for information on which modules were modified to  adaptB           Hgraph to this terminal;  it includes insights as to theB           conversion for other terminals if users  would  like  toB           make changes.  The HGR125 files support a REGIS terminal0           and the Bausch and Lomb DMPL plotters.  B                Hgraph is coded in FLECS.  This structured  FortranB           code   is  contained  in  the  .FLX  files.   The  FLECSB           generated Fortran 66 code is in  the  .FOR  files.   TheB           HGraph  document  is  in  the  HGraph.DOC  file with theB           associated Runoff file as HGraph.RNO.   An  RT-11  FLECSB           translator  FLECS.*  (RE:   RT SIG Fall 81 Tape) is alsoB           included for reference.  Refer to the VAX  Fall  82  SIGB           Tape  [VAX82B.FORDAERO.UTIL.FORDUTIL]  (or  something toB           this effect) for a VMS FLECS  translator.   Other  FlecsB           translators  are  available from SIG tapes and the DECUS           library.  B                PLOT3D.FOR is included as a separate file.  A FLECSB           version is not included as it does not exist.  PLOT3D isB           known to have bugs, but will work for  many  of  the  3DB           plots   you  may  wish  to  do.   Although  considerable j  B           HGraf3 - HGraph DECUS Release - REGIS support.    PAGE 2      B           development is occuring at the Ames Laboratory on the 2DB           versions  of  HGraph,  no  additional  work is currentlyB           planned for the 3D code;  PLOT3D should  be  treated  as           unsupported.  B                In general, you will find that the source  code  isB           quite   transportable   to   other   operating  systems,B           especially if you transport the .FOR files.  Hgraph  wasB           designed  to  provide  graphics support on small systems6           but is quite extendable to larger systems.    B                You can look forward to a new interactive  graphicsB           editor  called  UGraph  which is based on Hgraph.  It isB           menu   driven   and   requires   no   programming.    ItB           unfortunately  is  getting  larger  though  and is beingB           developed on the VAX.  An overlayed  version  for  smallB           systems  may be possible, though.  It is running in testB           mode now and will likely be available in the  Spring  of           1985.b  B                The following notes relate primarily to  Hgraph  onB           RT-11  (small)  systems.   They are included as they may*           help you isolate setup problems:  B                When using HGRAPH it is  common  to  encounter  theB           message  "LINK-F-Library  list  overflow".  Increase theB           library list size with the /P switch when linking.   For           example:           		r link%           		prog/P:400=prog,sy:hgraphx  B                A  commonly  occuring  run-time  error  when  usingB           HGRAPH is "?MON-F-Trap to 4 NNNNNN" or "Stack Overflow".B           This message likely indicates a lack  of  program  stackB           space.   The  solution  is  to  increase  the  amount ofB           program stack space using the  /B  linker  option.   For           example:           		r link,           		prog/B:1400/P:400=prog,sy:hgraphB           The default value of B is 1000 octal.  This problem will>           undoubtedly be encountered when using threaded code.  B                All code included in this distribution  is  in  theB           public  domain  and  may not be marketed for profit.  ItB           may be altered without the explicit  permission  of  theB           authors.   Any  corrections or significant modificationsB           to HGraph are of interest to  the  authors  and  may  beB           communicated  to  the  address  above.   The authors andB           their  employers  assume  no  responsibility   for   theB           correctness   or  the  appropriatness  of  the  software(           included in this distribution. i  