home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / SCREEN / GRABB392.ZIP / GRTXT.DOC < prev    next >
Encoding:
Text File  |  1991-11-27  |  12.0 KB  |  270 lines
  1.  
  2.  
  3.  
  4.                                        GRTXT (tm)
  5.  
  6.                             the GRABBER (tm) ASCII Text Subset
  7.  
  8.                                Version 0.50 Shareware Issue
  9.  
  10.                            ----------------------------------
  11.  
  12.                             The ASCII Screen Capture Program
  13.                               for the IBM PC, XT, AT, PS/2
  14.                                     and Compatibles
  15.  
  16.  
  17.                                      DOCUMENTATION
  18.                                    November 27, 1991
  19.  
  20.  
  21.                                    Copyright 1991 by
  22.                                     Gerald A. Monroe
  23.                                   All rights reserved.
  24.  
  25.  
  26.  
  27.  
  28.           YOUR LICENSE TO USE THIS SOFTWARE
  29.           ----------------------------------
  30.  
  31.           GRTXT.EXE and GRTXT.DOC are Copyright 1991 by Gerald A. Monroe.
  32.           All rights are reserved except those expressly granted here.
  33.  
  34.           The GRTXT program and this documentation file are distributed as an
  35.           integral part of the GRABBER (tm) screen capture package under the
  36.           terms of a shareware license that is fully set forth in the file
  37.           GRABBER.DOC, which is the instruction manual for GRABBER.EXE, the
  38.           main program module in the package.
  39.  
  40.           The shareware license terms in the GRABBER.DOC file are incorporated
  41.           here by reference.  This license permits you to copy and distribute
  42.           the files GRTXT.EXE and GRTXT.DOC (this file) freely, provided that:
  43.           these files are always distributed together with each other and with
  44.           the GRABBER.EXE and GRABBER.DOC files; none of the files is modified
  45.           in any way; and no fee, premium or donation of any kind is charged
  46.           or requested for their distribution except as permitted on the terms
  47.           described in the GRABBER.DOC file.
  48.  
  49.           Continued use of the GRTXT program for more than a 10-day trial
  50.           period requires you to register your use of the software with the
  51.           author.  For more information about the benefits of registration
  52.           and how to go about registering, please refer to the full licensing
  53.           and ordering information in the GRABBER.DOC file.
  54.  
  55.  
  56.  
  57.           GRTXT (tm)   Documentation                                 Page 2 of 5
  58.  
  59.  
  60.  
  61.  
  62.           ABOUT GRTXT.EXE -- GRABBER's "TEXT" VERSION
  63.           --------------------------------------------
  64.  
  65.           GRTXT is an alternative version of the GRABBER screen capture
  66.           program.  It is an especially valuable tool for users who need to
  67.           capture character-based text images from the video screen directly
  68.           to plain ASCII text files on disk.
  69.  
  70.           While GRABBER can be used to capture both character-based text
  71.           screens as well as pixel-based graphic images to your disk in the
  72.           form of executable image files, GRTXT is designed to capture
  73.           character-based text screens exclusively.  GRTXT also differs from
  74.           GRABBER in that GRTXT captures your screens directly to plain-ASCII
  75.           text files, instead of to the .exe format.
  76.  
  77.           GRTXT is installed and operated in much the same way as GRABBER, and
  78.           the two programs have a very similar look and feel.  For the most
  79.           part, this documentation for GRTXT covers only the aspects of GRTXT
  80.           which differ from GRABBER.  It is assumed here that you have already
  81.           browsed the GRABBER documentation file (GRABBER.DOC) and become
  82.           familiar with how GRABBER works.
  83.  
  84.  
  85.           USING GRABBER and GRTXT SIMULTANEOUSLY
  86.           ---------------------------------------
  87.  
  88.           GRTXT is designed to be compatible with GRABBER.  Both programs
  89.           can be installed in memory at the same time.
  90.  
  91.           The default "hotkey" sequence for GRTXT is [Alt =].  That is, you
  92.           hold down the [Alt] key, press the equal sign key [=], then release
  93.           the [Alt] key.
  94.  
  95.           GRTXT is designed to capture character-based text images exclusively.
  96.           If you press GRTXT's hotkey and hear a single low-pitched tone on the
  97.           computer speaker, this means that the video screen is running in a
  98.           pixel-based graphics mode, and GRTXT is unable to capture the screen.
  99.  
  100.           GRTXT allows you to modify your hotkey sequence from the default
  101.           [Alt =] to practically any other key sequence you choose.  In this
  102.           respect, GRTXT is exactly like GRABBER.  There is no separate docu-
  103.           mentation here which covers the procedure for changing your GRTXT
  104.           hotkey.  GRTXT uses the exact same hotkey procedures as GRABBER.
  105.           You can read about these in the GRABBER.DOC manual, at page 29 and
  106.           at Appendices A and B.  (To view a list of valid KEY= codes for
  107.           GRTXT, use the command GRTXT KEY=?.  To view a list of valid SHIFT=
  108.           codes, enter GRTXT SHIFT=?.)
  109.  
  110.  
  111.  
  112.           GRTXT (tm)   Documentation                                 Page 3 of 5
  113.  
  114.  
  115.  
  116.  
  117.           INSTALLATION OPTIONS
  118.           ---------------------
  119.  
  120.           GRTXT accepts the following command-line switches.  Each of these
  121.           optional switches (except for the /A option) is also available in the
  122.           GRABBER program.  For more complete details concerning the purpose of
  123.           these optional switches and how they work, consult the section on
  124.           page 16 of your GRABBER documentation which is headed "Grabber
  125.           Installation Options."
  126.  
  127.  
  128.           Option:   /D
  129.  
  130.           Purpose:  Tells GRTXT to capture text screens to whatever drive and
  131.                     directory path is the current DOS default.  As with
  132.                     GRABBER, this switch can substitute for the drive/path
  133.                     parameter which is required to make GRTXT stay resident
  134.                     in memory.
  135.  
  136.  
  137.           Option:   /M+  and  /M-        (for Microsoft-compatible mice only)
  138.  
  139.           Purpose:  To enable and disable, respectively, GRTXT's recognition
  140.                     of the "mouse hotkey," which allows you to capture your
  141.                     text screens by holding down both the left and right mouse
  142.                     buttons for about two seconds.
  143.  
  144.                     Please note:  The mouse hotkey function is available in the
  145.                     GRABBER program as well as in GRTXT.  If you have installed
  146.                     both programs in memory simultaneously, do not use the /M+
  147.                     switch to enable the mouse hotkey with both programs.
  148.                     Strange results are almost guaranteed to occur, and it may
  149.                     even lock up your computer when you use the mouse hotkey.
  150.                     It is acceptable to use the /M+ switch with either GRTXT or
  151.                     GRABBER, but not both.
  152.  
  153.  
  154.           Option:   /U
  155.  
  156.           Purpose:  Removes, or "uninstalls," GRTXT from your computer's
  157.                     memory.  GRTXT cannot be removed from memory if, after you
  158.                     initially installed it, you loaded other memory-resident
  159.                     software which uses any of the same hardware or software
  160.                     interrupts which GRTXT uses.  If you are using GRTXT and
  161.                     GRABBER simultaneously, both programs can be removed from
  162.                     memory, but only in the reverse order in which they were
  163.                     initially installed.  In other words, "last in, first out."
  164.  
  165.  
  166.  
  167.           GRTXT (tm)   Documentation                                 Page 4 of 5
  168.  
  169.  
  170.  
  171.  
  172.           Option:   /S+  and  /S-
  173.  
  174.           Purpose:  To enable and disable, respectively, GRTXT's use of sounds
  175.                     through the computer's speaker.  When enabled, the sounds
  176.                     accompany the on-screen filename prompts, and are also
  177.                     issued to indicate the successful completion of a screen-
  178.                     capture operation.
  179.  
  180.  
  181.           Option:   /P+  and  /P-
  182.  
  183.           Purpose:  To enable and disable, respectively, GRTXT's on-screen
  184.                     filename prompts.  When the prompts are disabled, GRTXT
  185.                     creates ASCII text files on your disk without asking you
  186.                     first what the file should be called.  Instead, the program
  187.                     assigns a sort of "serial number" name to each file that is
  188.                     created.  These files are named GRTXT000.TXT, GRTXT001.TXT,
  189.                     and so forth up to GRTXT999.TXT, at which point they "turn
  190.                     over" again, back to GRTXT000.  Please see also the section
  191.                     below dealing with the /A command switch, and consult the
  192.                     description of the /P options in your GRABBER documentation
  193.                     for more information.
  194.  
  195.  
  196.           Option:   /A
  197.  
  198.           Purpose:  To enable the "Append Mode" when you have told GRTXT not
  199.                     to use on-screen filename prompts by issuing the /P-
  200.                     command switch.  This option has no effect when the file-
  201.                     name prompts are enabled.  If you do not combine the /P-
  202.                     option with this /A option, then GRTXT will work in its
  203.                     "Overwrite Mode," which means that it will create a
  204.                     separate .TXT file for each screen capture you request.
  205.                     However, when you do use the /A switch, GRTXT creates only
  206.                     one GRTXTXXX file, and appends each subsequent screen
  207.                     capture to it.
  208.  
  209.                     For a complete explanation of the filename options avail-
  210.                     able to you when the on-screen prompts are disabled, please
  211.                     see the next section, "Grtxt and Filename Prompts."
  212.  
  213.  
  214.  
  215.           GRTXT (tm)   Documentation                                 Page 5 of 5
  216.  
  217.  
  218.  
  219.           Option:   /W
  220.  
  221.           Purpose:  To enable "DOS Swap Mode" of operation, which can eliminate
  222.                     some of the delays you may experience in getting GRTXT to
  223.                     pop up after you press the hotkey.  The /W switch is valid
  224.                     only when you are initially installing GRTXT in memory, and
  225.                     has no effect after the program is already resident.  For
  226.                     more information about this option, see page 18 of the
  227.                     GRABBER.DOC file.
  228.  
  229.  
  230.  
  231.  
  232.           GRTXT AND FILENAME PROMPTS
  233.           ---------------------------
  234.  
  235.           Probably the most significant difference you will notice between
  236.           GRTXT's interface and GRABBER's is in the area of the on-screen
  237.           filename prompts.
  238.  
  239.           Unlike GRABBER, GRTXT does not offer a default filename sequence
  240.           such as GRTXT000, GRTXT001, etc., when it displays the prompts on
  241.           your screen.  The first time you call up GRTXT after installing it,
  242.           there is no default filename present.  You must supply your own.
  243.  
  244.           After your first .TXT screen capture, however, subsequent filename
  245.           prompts will offer you a default filename which is identical to the
  246.           previous one you specified.  You may accept this default filename
  247.           by pressing <Return>, or you can enter another name.  After you press
  248.           <Return>, you will then see this additional prompt, which is not
  249.           present in GRABBER:
  250.  
  251.                  FILENAME exists -- (A)ppend, (O)verwrite, (C)ancel ?
  252.  
  253.           If you wish to retain the contents of FILENAME.TXT and simply append
  254.           the current screen to the bottom of it, just press <A> or <Return>.
  255.           If you wish to overwrite (i.e., erase and replace) the contents of
  256.           the original FILENAME.TXT file, then press <O>.  If you decide not
  257.           to work with this name and wish to enter a different name instead,
  258.           press <C>.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                            * * *    End of GRTXT.DOC   * * *
  270.