home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1336 / gepackt.exe / GROVER.DOC < prev    next >
Encoding:
Text File  |  1993-07-13  |  10.4 KB  |  231 lines
  1. This is file GROVER.DOC
  2.  
  3.                   GROVER - the GRaphics OVERlay program    (c) 1992  Skinsoft
  4.  
  5.                   Author:  Lee H. Skinner
  6.                            P.O. Box 14944
  7.                            Albuquerque, NM  87191
  8.  
  9.      GROVER is a FRACTINT utility which layouts and maps on the screen and/or
  10.      HP laserjet printer the locations of where fractal images lie within
  11.      lower resolution images.  It will allow one to keep track of zoomed
  12.      explorations by keeping a visual record that can be accessed anytime
  13.      in a .GOF (Graphics Overlay Format) file.  It can also be used as
  14.      reverse engineering to investigate visually where an acquired image
  15.      is in relation to a master "world" map.
  16.  
  17.      The zipped file GROVER.ZIP includes the following:
  18.        GOF.BAT      - bat file for running GROVER
  19.        GROVER.DOC   - this file
  20.        F-DATA.EXE   - Another Fractint utility by Marc Reinig    CIS  72410,77
  21.                       which is called by GROVER.EXE to generate .fda files.
  22.        GROVER.EXE
  23.        GROVER.FOR   - The source file - needs LAHEY F77L-EM/32 Ver 5.01
  24.                         and graphics utility INGRAF 6.0 or later.
  25.                         (may not be included - request with SASE and floppy)
  26.        COMPLEX1.FNT - Font file used by GROVER.EXE
  27.        F77L3.EER    - FORTRAN General Error Message File
  28.  
  29.        Current Restrictions and Limitations:
  30.          Hardware:
  31.            The Screen uses 640*480 pixels with 16 colors.
  32.            HP Laserjet printers only.
  33.          Software:
  34.            GOF.BAT, F-DATA.EXE, and GROVER.EXE should all be put
  35.              into a directory in your DOS path.
  36.            COMPLEX1.FNT needs to go into the root directory C:\.
  37.            Only rectangular images with an aspect ratio of 0.75 are examined
  38.            .FDA, .INP, .NEW, .GOF files must be in the current directory,
  39.               (.GIF files may be anywhere)
  40.  
  41.        How to use GROVER:
  42.  
  43.        GOF { arg1 { arg2 } }
  44.  
  45.        This executes the batch file GOF.BAT which calls GROVER with 0, 1,
  46.        or 2 arguments.
  47.  
  48.        Arguments are files names.  They may be given with no extension, or
  49.        with .GIF, .GOF, or .INP extensions.
  50.  
  51.        Whether on the command line, in .inp file listed file names, or
  52.          file names you may enter after prompting, the entire path name
  53.          (drive: and dirctories) may be given.  However, this will only
  54.          specify where the .gif files are located.  All other files
  55.          (.gof, .inp, etc.) must be located in the current directory.
  56.          Sub-area .gifs must have different names, even if they are in
  57.          different directories.
  58.  
  59.        GROVER runs in one of three possible modes:
  60.  
  61.          1. Quickview Mode - Displays sub-area of one .GIF image within
  62.                              another. C:\giflist.dat doesn't exist.
  63.  
  64.              Example:  GOF name1.gif name2{.gif}
  65.                        where the magnification of name2.gif > name1.gif,
  66.                        i.e., name2.gif is a sub-area of name1.gif.
  67.  
  68.              Example:  GOF name1.gif
  69.                        (in this case, GROVER will prompt you for name2)
  70.  
  71.          2. .GOF Creation Mode - Builds a .GOF file from an .INP file.
  72.  
  73.              Example: GOF name1.inp
  74.                       where name1.inp specifies a list of names of
  75.                       sub-images within name1.GIF.
  76.                       (Note: If name1 includes a pathname, this will tell
  77.                       GROVER where to find the needed .gif file. The .inp
  78.                       file must be in the current directory.)
  79.  
  80.              Example: GOF name1.gif (if C:\giflist.dat exists)
  81.                       Creates both .inp and .gof files.
  82.                       All related .gifs must be in the current directory.
  83.  
  84.          3. .GOF Display Mode - Displays an existing .GOF file.
  85.  
  86.              Example: GOF name1.gof
  87.                       where name1.gof is a file created earlier by GROVER
  88.  
  89.          Automatic Mode Determination
  90.  
  91.              Example: GOF name1
  92.                       (name1 has no extension)
  93.  
  94.                               or
  95.  
  96.                       GOF
  97.                       (no arguments)
  98.                       This will casuse the program to prompt you for the
  99.                       name of the outer .gif file
  100.  
  101.              In either of the above two cases the mode is determined
  102.              automatically:
  103.  
  104.              If the .gof file exists in the current directory,
  105.                .GOF Display Mode will be chosen;
  106.  
  107.              Else if the .inp file exists in the current directory,
  108.                 .GOF Creation Mode will be chosen;
  109.  
  110.              Else if name1 has no extension and c:\giflist.dat exists,
  111.                 Grover will build name1.inp by finding all matches of
  112.                 name1 in cols 14-21 of giflist.dat, copying the names
  113.                 in cols 1-8 of giflist.dat (one per line) to name1.inp.
  114.                 .GOF Creation Mode will then be chosen.  Note: If any
  115.                 sub-gif names are in other than the current directory,
  116.                 user must edit name1.inp to include the path.
  117.  
  118.              Else Quickview Mode will be chosen.
  119.  
  120.  
  121.        Grover input (.inp) files:
  122.  
  123.              A list consists of 1 sub-area file name per line (extension
  124.                not required as these are all assumed to be .gif)
  125.              A space followed by the letter M may follow a file name.
  126.                This specifies a merge option:  If the sub area .gof file
  127.                exists, it's own sub-areas will also be displayed. (If not,
  128.                the merge request is ignored.)
  129.  
  130.              Example of an .inp file with 5 lines:
  131.              name1
  132.              name2 M
  133.               name3.gif  m
  134.              name4 comment if desired
  135.              NAME5.GIF
  136.  
  137.        Quickview Mode
  138.  
  139.          After the areas are displayed and labeled on the screen,
  140.            hit any key to exit.  You will then be prompted whether to
  141.            print the image.  Enter 'Y' or 'y' to print the diagram.
  142.  
  143.        .GOF Creation Mode
  144.  
  145.          After the drawing of each sub-area (normally a box, but crosshairs
  146.            for very small sub-areas) a red prompt will appear in the top left
  147.            corner of the screen to enter a digit (0 through 9).  Enter a
  148.            digit followed by ENTER to tell GROVER where to label the sub-area:
  149.              0 - don't dwaw a label
  150.              1 - label above and to the left          |    Remember
  151.              2 - label above                          |
  152.              3 - label above and to the right         |    1   2   3
  153.              4 - label at the left                    |
  154.              5 - label at center (except crosshairs)  |    4   5   6
  155.              6 - label at the right                   |
  156.              7 - label below and to the left          |    7   8   9
  157.              8 - label below (default)                |
  158.              9 - label below and to the right         |   This Pattern
  159.  
  160.            Sub-sub-areas (from merged .gofs) will show up as small triangles.
  161.            When finished with the .inp file, a green prompt will ask you if
  162.            the layout is OK.  If not, you can re-format the screen by
  163.            starting over and giving different responses.  If it is OK,
  164.            GROVER renames the file it is building from a .new to a .gof
  165.            file.  (You will have to hit the enter key twice - once to
  166.            answer the prompt, once to close the screen.)  If you reformat
  167.            the display, GROVER will access .fda files instead of .gif files
  168.            to save time.  Finally, you will be prompted whether to
  169.            print the image.  Enter 'Y' or 'y' to print the diagram.
  170.  
  171.        .GOF Display Mode
  172.  
  173.          You will be prompted whether to display the areas on the screen.
  174.            A 'L' or 'l' will cancel the screen image and go directly to
  175.            printing a laserjet hardcopy. An 'S', 's', or Enter will cause
  176.            areas to be displayed and labeled on the screen first.
  177.            Hit any key to exit.  You will then be prompted whether to
  178.            print the image.  Enter 'Y' or 'y' to print the diagram.
  179.  
  180.        Grover output (.gof) files:
  181.          .Gof files are ASCII files and may be looked at by your editor.
  182.  
  183.          For each area there is the following information:
  184.          Area Number - The outermost is always number 1.
  185.          Area Name - The first one has the extension .gif, the others don't.
  186.          Label placement code - (10 indicates this is a merged area)
  187.          Magnification - (although computable from other parameters, it
  188.                           is included for visual inspection.)
  189.          Xmin, Xmax, Ymin, Ymax of the area
  190.  
  191.        All error messages hopefully are meaningful and not cryptic.
  192.  
  193.        A documented quirky feature:
  194.          The author is currently using FRACTINT to remake many of his
  195.        fractal images in 1024x768/256 format where older versions exist
  196.        at 640x480/256.  The new higher resolution images are then given
  197.        the same name, but preceeded by a 1.  Thus 1DOG.GIF is the same
  198.        as DOG.GIF as far as co-ordinates go.  DOG.GIF is usually thrown
  199.        away to generate more disk space.  To keep from having to update
  200.        the .inp files whenever an image is replaced, if GROVER can't
  201.        find a particular .gif file, it looks for one with the alternate
  202.        spelling (preceeded by a 1).
  203.  
  204.        The sstools.ini file.
  205.  
  206.          If you have an sstools.ini file in your DOS append path,
  207.          then you may have the following types of configuration commands:
  208.  
  209.          [GROVER]
  210.          printer=hp/300
  211.          VPIC=YES
  212.          BATCH=yes
  213.  
  214.          Currently, the only printers supported are 'hp/75', 'hp/100,'
  215.          'hp/150', 'hp/300', and 'none'.
  216.  
  217.          If you say vpic=y, then you are telling GROVER that
  218.            1)  VPIC.EXE is in my DOS path, and
  219.            2)  I want GROVER to briefly display the fractal image for me
  220.                before drawing the diagram.
  221.  
  222.          If you say batch=yes, then when running in .Gof display mode
  223.          with a .gof file name on the command line, GROVER will automatically
  224.          just print the file without any prompts.  This allows you to create
  225.          a batch file to print any number of diagrams from previously
  226.          created .gof files.
  227.  
  228.        Enjoy the program.
  229.                                       Lee H. Skinner
  230.                                       Fractint Stone Soup Member
  231.