home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 3 / CDASC03.ISO / maj / 1758 / gr4ai.doc < prev    next >
Text File  |  1993-04-01  |  20KB  |  455 lines
  1.  
  2.  
  3.  
  4.                                      GRABBER(tm)
  5.                            8514/A Adapter Interface Version
  6.                                 Shareware Release 0.50
  7.  
  8.                             -----------------------------
  9.  
  10.                               The Screen Capture Program
  11.                            for MS-DOS and 8514/A-Compatible
  12.                                     Video Graphics
  13.  
  14.  
  15.                           DOCUMENTATION AND TECHNICAL NOTES
  16.                                   November 26, 1992
  17.  
  18.                                Copyright 1991, 1992 by
  19.                                    Gerald A. Monroe
  20.                                  All rights reserved.
  21.  
  22.  
  23.  
  24.  
  25.           YOUR LICENSE TO USE THIS SOFTWARE:
  26.           -----------------------------------
  27.  
  28.           This documentation file and the GR4AI.EXE program are Copyright
  29.           1992 by Gerald A. Monroe.  All rights are reserved except as
  30.           expressly provided here.
  31.  
  32.           These files have been distributed as part of the GRABBER(tm)
  33.           screen capture package, under the terms of a shareware license
  34.           that is fully set forth in the file GRABBER.DOC.  (GRABBER.DOC is
  35.           the reference manual for GRABBER.EXE, which is the main program
  36.           module in the package.)
  37.  
  38.           The shareware license terms on the last page of the GRABBER.DOC
  39.           file are incorporated here by reference.  This license permits
  40.           you to freely copy and distribute this documentation and
  41.           GR4AI.EXE, provided that:  these files are always distributed
  42.           together with each other and with all the other files in the
  43.           GRABBER package; none of the files is modified in any way; and no
  44.           fee, premium or donation of any kind is charged or requested for
  45.           their distribution except as permitted on the terms described in
  46.           the GRABBER.DOC file.
  47.  
  48.           Continued use of any of these programs for more than a 10-day
  49.           trial period requires you to register your use of the software
  50.           with the author.  For more information about the benefits of
  51.           registration and how to go about registering, please refer to the
  52.           full licensing and ordering information in the GRABBER.DOC file.
  53.  
  54.  
  55.  
  56.                                   Table of Contents
  57.  
  58.  
  59.                Shareware License Terms ............................  1
  60.  
  61.                Overview of GR4AI.EXE ..............................  3
  62.  
  63.                About this documentation ...........................  4
  64.  
  65.                Using GRABBER and GR4AI simultaneously .............  4
  66.  
  67.                Modifying the GR4AI hotkey .........................  4
  68.  
  69.                GR4AI's audible error indicators ...................  5
  70.  
  71.                Features not available with GR4AI ..................  5
  72.  
  73.                GR4AI installation options .........................  5
  74.                     DEFAULTDRIVE ..................................  6
  75.                     MOUSE and NOMOUSE .............................  6
  76.                     UNLOAD ........................................  6
  77.                     SOUND and NOSOUND .............................  6
  78.                     PROMPT and NOPROMPT ...........................  7
  79.                     SWAPMODE ......................................  7
  80.  
  81.                "Thanks for trying GRABBER" messages ...............  7
  82.  
  83.                Offspring file compatibility with other systems ....  8
  84.  
  85.                Offspring file command-line options ................  8
  86.  
  87.                Converting GR4AI offspring to PCX and GIF formats ..  9
  88.  
  89.           GR4AI(tm)        Documentation & Technical Notes      Page 3 of 9
  90.  
  91.  
  92.  
  93.  
  94.  
  95.           OVERVIEW OF GR4AI.EXE
  96.           ----------------------
  97.  
  98.           GR4AI(tm) is an alternative version of the GRABBER screen capture
  99.           program.  It is designed exclusively for capturing high-resolu-
  100.           tion 640 x 480 and 1024 x 768 graphic images from PC systems that
  101.           are compatible with the IBM 8514/A Adapter Interface, and which
  102.           are running in "real mode" under MS-DOS.  (GR4AI, like GRAB-
  103.           BER.EXE, does not capture screens from Microsoft Windows or
  104.           Windows applications.)
  105.  
  106.           The Adapter Interface, or "AI," is a programming interface that
  107.           lets application programs work with your high-resolution video
  108.           adapter.  Usually, the AI is loaded as a memory-resident (TSR)
  109.           program in your computer's memory.  When it is present, it allows
  110.           GR4AI to capture certain types of high-resolution graphics.
  111.  
  112.           GR4AI can only capture a screen if the foreground program that is
  113.           generating the image is actually using the AI to do its screen
  114.           work.  Note that this is not always the case.  For example, if
  115.           you have an IBM 8514/A adapter, or another manufacturer's card
  116.           that is compatible with IBM's 8514/A at the register level (such
  117.           as an ATI 8514/Ultra, Graphics Ultra or Graphics Vantage card),
  118.           then it is possible for some application programs to work with
  119.           the screen by writing directly to the adapter's hardware regis-
  120.           ters and ignoring the AI completely.  GR4AI cannot capture any
  121.           screens from such applications, because unless the AI is being
  122.           used for screen output, GR4AI has no way of knowing that the
  123.           adapter is in use at all.
  124.  
  125.           Therefore, if you have an application from which you want to
  126.           capture screens, and the application's installation or setup
  127.           allows you to choose between AI-compatible and 8514/A register-
  128.           level compatible video, then you should choose the AI-compatible
  129.           option.
  130.  
  131.           Whatever kind of video hardware is installed, GR4AI expects to
  132.           find an AI driver resident in memory when you install it, and
  133.           when you ask it to capture a screen.  If an AI driver is not
  134.           present, GR4AI will not capture the screen.  (With the IBM 8514/A
  135.           and the ATI 8514/A-compatibles mentioned above, the AI driver is
  136.           called HDILOAD.EXE.  If you have a different brand of adapter,
  137.           the driver file may be called by a different name.)
  138.  
  139.           Note that you do not have to have an adapter that is register-
  140.           level compatible with the 8514/A in order to use GR4AI.  All you
  141.           need is an adapter that comes supplied with an AI driver, and an
  142.           application program that uses the AI for its screen output.
  143.  
  144.           GR4AI(tm)        Documentation & Technical Notes      Page 4 of 9
  145.  
  146.  
  147.  
  148.  
  149.  
  150.           ABOUT THIS DOCUMENTATION
  151.           -------------------------
  152.  
  153.           GR4AI can be installed in memory and operated in much the same
  154.           way as GRABBER.EXE, and the two programs have a very similar look
  155.           and feel.  For the most part, this documentation for GR4AI covers
  156.           only the aspects of GR4AI which differ from GRABBER.EXE.  To use
  157.           GR4AI effectively, you should read the GRABBER program documenta-
  158.           tion and become familiar with GRABBER's operation.
  159.  
  160.  
  161.  
  162.           USING GRABBER and GR4AI SIMULTANEOUSLY
  163.           ---------------------------------------
  164.  
  165.           GR4AI is designed to be compatible with GRABBER.  Both programs
  166.           can be installed in memory at the same time.
  167.  
  168.           The default "hotkey" sequence for GR4AI is [Ctrl Alt F10].  That
  169.           is, you hold down the [Ctrl] key and the [Alt] key at the same
  170.           time, then press the [F10] key, then release all three keys.
  171.  
  172.  
  173.  
  174.           MODIFYING THE GR4AI HOTKEY
  175.           ---------------------------
  176.  
  177.           GR4AI allows you to modify your hotkey sequence from the default
  178.           [Ctrl Alt F10] to practically any other key sequence you choose. 
  179.           In this respect, GR4AI is exactly like GRABBER.  There is no
  180.           separate documentation here which covers the procedure for
  181.           changing your GR4AI hotkey.  GR4AI uses the exact same hotkey
  182.           procedures as GRABBER.  You can read about these in the GRAB-
  183.           BER.DOC manual, at page 35 and at Appendices A and B.  (To view a
  184.           list of valid KEY= codes for GR4AI, use the command GR4AI KEY=?. 
  185.           To view a list of valid SHIFT= codes, enter GR4AI SHIFT=?.)
  186.  
  187.           GR4AI(tm)        Documentation & Technical Notes      Page 5 of 9
  188.  
  189.  
  190.  
  191.  
  192.  
  193.           GR4AI's AUDIBLE ERROR INDICATORS
  194.           ---------------------------------
  195.  
  196.           If you press GR4AI's hotkey and hear one or two short, low-
  197.           pitched tones from your PC speaker, it means that GR4AI is unable
  198.           to capture the screen because an error condition exists.
  199.  
  200.           One low-pitched tone indicates that no AI driver is currently
  201.           loaded in memory.
  202.  
  203.           Two low-pitched tones indicate that an AI driver is loaded in
  204.           memory, but that it is not presently in use by a foreground
  205.           application, or that the adapter is presently operating in a
  206.           video mode that exceeds GR4AI's capabilities.  GR4AI is able to
  207.           capture these four -- and only these four -- common AI modes:
  208.  
  209.                *  640 x 480, 16 colors       *  1024 x 768, 16 colors
  210.                *  640 x 480, 256 colors      *  1024 x 768, 256 colors
  211.  
  212.  
  213.           (Three low-pitched tones indicate a probable disk error during
  214.           the screen capture process.  See "Errors During the Screen
  215.           Capture" on page 16 of the main GRABBER program documentation
  216.           file, GRABBER.DOC.)
  217.  
  218.  
  219.  
  220.           FEATURES NOT AVAILABLE WITH GR4AI
  221.           ----------------------------------
  222.  
  223.           The BATCHCAPTURE options that are available in GRABBER.EXE are
  224.           not supported by GR4AI.  Also, the option which GRABBER.EXE
  225.           offers for capturing screens from inside other applications (by
  226.           calling INT 16h/AX=4752h) is not supported by GR4AI.
  227.  
  228.  
  229.  
  230.           GR4AI INSTALLATION OPTIONS
  231.           ---------------------------
  232.  
  233.           GR4AI accepts the following command-line configuration options. 
  234.           Each of these optional switches is also available in the GRABBER
  235.           program.  For more complete details concerning the purpose of
  236.           these options and how they work, consult the section beginning on
  237.           page 16 of the GRABBER.DOC manual which is headed "Grabber
  238.           Installation Options."
  239.  
  240.           GR4AI(tm)        Documentation & Technical Notes      Page 6 of 9
  241.  
  242.  
  243.  
  244.  
  245.  
  246.           Option:   DEFAULTDRIVE
  247.  
  248.           Purpose:  Tells GR4AI to capture screens to whatever drive and
  249.                     directory path is the current DOS default.  As with
  250.                     GRABBER, this switch can substitute for the drive/path
  251.                     parameter which is otherwise required to make GR4AI
  252.                     stay resident in memory.
  253.  
  254.  
  255.  
  256.           Option:   MOUSE  and  NOMOUSE
  257.  
  258.           Purpose:  To enable and disable, respectively, GR4AI's recogni-
  259.                     tion of the "mouse hotkey," which allows you to capture
  260.                     screens by holding down both the left and right mouse
  261.                     buttons for about two seconds.
  262.  
  263.           Please note:  The mouse hotkey function is available in the
  264.           GRABBER program as well as in GR4AI.  If you have installed both
  265.           programs in memory simultaneously, do not use the MOUSE switch to
  266.           enable the mouse hotkey with both programs.  Strange results are
  267.           almost guaranteed to occur, and it may even lock up your computer
  268.           when you use the mouse hotkey.  It is acceptable to use the MOUSE
  269.           switch with either GR4AI or GRABBER, but not both.
  270.  
  271.  
  272.  
  273.           Option:   UNLOAD
  274.  
  275.           Purpose:  Removes GR4AI from your computer's memory.  GR4AI
  276.                     cannot be removed from memory if, after you initially
  277.                     installed it, you loaded other memory-resident software
  278.                     which is activated by any of the same hardware or
  279.                     software interrupts which GR4AI uses.  If you are using
  280.                     GR4AI and GRABBER simultaneously, both programs can be
  281.                     removed from memory, but only in the reverse order in
  282.                     which they were initially installed.  In other words,
  283.                     "last in, first out."
  284.  
  285.  
  286.  
  287.           Option:   SOUND  and  NOSOUND
  288.  
  289.           Purpose:  To enable and disable, respectively, GR4AI's use of
  290.                     sounds through the computer's speaker.  When enabled,
  291.                     the sounds accompany the on-screen filename prompts,
  292.                     and are also issued to indicate the successful comple-
  293.                     tion of a screen capture operation.
  294.  
  295.           GR4AI(tm)        Documentation & Technical Notes      Page 7 of 9
  296.  
  297.  
  298.  
  299.  
  300.  
  301.           Option:   PROMPT  and  NOPROMPT
  302.  
  303.           Purpose:  To enable and disable, respectively, GR4AI's on-screen
  304.                     filename prompts.  When the prompts are disabled, GR4AI
  305.                     creates offspring files on your disk without asking you
  306.                     first what each file should be called.  Instead, the
  307.                     program assigns a sort of "serial number" name to each
  308.                     file that is created.  These files are named
  309.                     AISCRN00.EXE, AISCRN01.EXE, and so forth up to
  310.                     AISCRN99.EXE, at which point they return again to
  311.                     AISCRN00.EXE.  Please consult the description of the
  312.                     PROMPT and NOPROMPT options on page 17 of the GRAB-
  313.                     BER.DOC manual for more important information.
  314.  
  315.  
  316.  
  317.           Option:   SWAPMODE
  318.  
  319.           Purpose:  To enable "DOS Swap Mode" of operation, which can
  320.                     eliminate some of the delays you may experience in
  321.                     getting GR4AI to pop up after you press the hotkey. 
  322.                     The SWAPMODE switch is valid only when you are initial-
  323.                     ly installing GR4AI in memory, and has no effect after
  324.                     the program is already resident.  For more information
  325.                     about this option, see page 19 of the GRABBER.DOC file.
  326.  
  327.  
  328.  
  329.  
  330.           "THANKS FOR TRYING GRABBER" MESSAGES
  331.           -------------------------------------
  332.  
  333.           Because this is an unregistered, shareware version of GRABBER,
  334.           the images which you capture using this version will all contain
  335.           a small message in the lower right corner of the screen which
  336.           expresses our "Thanks for trying GRABBER."  These messages will
  337.           appear each time you execute a high-resolution graphic offspring
  338.           file, such as those created by GR4AI.EXE.
  339.  
  340.           By including these messages, we only hope to remind you that this
  341.           version of GRABBER is shareware, and to encourage you to register
  342.           the program if you continue to find it useful.
  343.  
  344.           Users who register with the publisher (for the full $59.00
  345.           version) will find that the registered version of GR4AI.EXE which
  346.           they receive creates offspring files that do not include this or
  347.           any other message superimposed on captured screens.
  348.  
  349.           GR4AI(tm)        Documentation & Technical Notes      Page 8 of 9
  350.  
  351.  
  352.  
  353.           OFFSPRING FILE COMPATIBILITY WITH OTHER SYSTEMS
  354.           ------------------------------------------------
  355.  
  356.           As mentioned above on page 4, GR4AI can capture four different
  357.           types of images from AI-compatible video adapters.  The four
  358.           types are:
  359.  
  360.                *  640 x 480, 16 colors       *  1024 x 768, 16 colors
  361.                *  640 x 480, 256 colors      *  1024 x 768, 256 colors
  362.  
  363.           Each type of image can be displayed on a different system than
  364.           the one from which it was originally captured, if the destination
  365.           system has an AI driver (such as IBM's or ATI's HDILOAD.EXE)
  366.           resident in memory.
  367.  
  368.           In addition, each type of image can be displayed on a system
  369.           which is compatible with the VESA video BIOS extension, even if
  370.           no AI driver is loaded.
  371.  
  372.           A 16-color, 640 x 480 offspring image can be ported to any VGA-
  373.           compatible system -- even one which does not have an AI driver
  374.           loaded and is not VESA-compatible.
  375.  
  376.           Some types of screens have special video memory requirements:
  377.  
  378.           *  1024 x 768 x 256 images require at least 1 Mb of video memory
  379.           *  1024 x 768 x 16 images require at least 512 Kb of video memory
  380.           *  640 x 480 x 256 images require at least 512 Kb of video memory
  381.  
  382.  
  383.  
  384.           OFFSPRING FILE COMMAND-LINE OPTIONS
  385.           ------------------------------------
  386.  
  387.           GR4AI offspring files support the same command-line options as
  388.           are supported by GRABBER.EXE offspring files.  This includes the
  389.           /? help option, the "FADEIN" and "FADEOUT" options, the /Tn
  390.           option for timed execution, the /F and /N options for exiting
  391.           without erasing, and the /K keylist option.  Each of these
  392.           options is fully explained in the main GRABBER program documenta-
  393.           tion (GRABBER.DOC), starting at page 24.
  394.  
  395.           Including the /? switch on the GR4AI offspring file's command
  396.           line will display on-screen help and other useful information
  397.           about the image and the current hardware setup.
  398.  
  399.           GR4AI(tm)        Documentation & Technical Notes      Page 9 of 9
  400.  
  401.  
  402.  
  403.           OFFSPRING FILE COMMAND-LINE OPTIONS (continued)
  404.           ------------------------------------------------
  405.  
  406.           However, you should note that for technical reasons it is not
  407.           always safe to use the /F and /N command-line options with GR4AI
  408.           offspring files.  These two options can cause a system crash when
  409.           you are executing a GR4AI offspring at the DOS prompt or within a
  410.           batch file, and should not be used in those situations.  You may
  411.           use these two options when executing a GR4AI offspring from
  412.           inside another program by way of a SHELL or EXEC-type function,
  413.           but only if the parent program re-initializes the AI (with the
  414.           AI's HINIT or HSYNC functions) or closes the AI (with the HCLOSE
  415.           function) immediately upon return from the child program.
  416.  
  417.  
  418.           CONVERTING GR4AI OFFSPRING TO .PCX and .GIF
  419.           --------------------------------------------
  420.  
  421.           GR4AI is supplied along with two companion utilities which
  422.           convert captured AI screens to the PCX and GIF file formats.  The
  423.           utilities are called GRAI2PCX and GRAI2GIF.  These utilities
  424.           function in exactly the same way as the GR2PCX and GR2GIF pro-
  425.           grams which are also included in this GRABBER package.  However,
  426.           here is the difference:  GRAI2PCX and GRAI2GIF are designed to
  427.           convert only offspring screens created by GR4AI.EXE, while GR2PCX
  428.           and GR2GIF are designed to convert only screens created by
  429.           GRABBER.EXE.
  430.  
  431.           For instructions on using GRAI2PCX and GRAI2GIF, consult the
  432.           CONVERT.DOC documentation file.
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.                           * * *    End of GR4AI.DOC   * * *
  455.