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