home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 3 / CDASC03.ISO / maj / 1758 / convert.doc < prev    next >
Text File  |  1993-04-01  |  30KB  |  617 lines
  1.  
  2.  
  3.  
  4.                                    GR2GIF (tm)
  5.                      GR2PCX (tm)
  6.                                        GRAI2GIF (tm)
  7.                          GRAI2PCX (tm)
  8.                                            GR2ANSI (tm)
  9.                              GR2ASCII (tm)
  10.  
  11.                                       *********
  12.  
  13.                           Conversion Utilities for use with
  14.                         the GRABBER(tm) Screen Capture Program
  15.  
  16.  
  17.                                     DOCUMENTATION
  18.                                   November 26, 1992
  19.  
  20.  
  21.                                Copyright 1991, 1992 by
  22.                                    Gerald A. Monroe
  23.                                  All rights reserved
  24.                             except as expressly provided.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.           YOUR LICENSE TO USE THIS SOFTWARE:
  33.           -----------------------------------
  34.  
  35.           This documentation and the following programs are Copyright 1991,
  36.           1992, by Gerald A. Monroe.  All rights are reserved except as
  37.           expressly provided here:  GR2PCX.EXE, GR2GIF.EXE, GRAI2PCX.EXE,
  38.           GRAI2GIF.EXE, GR2ASCII.EXE, GR2ANSI.EXE.
  39.  
  40.           These files have been distributed as part of the GRABBER(tm)
  41.           screen capture package, under the terms of a shareware license
  42.           that is fully set forth in the file GRABBER.DOC.  (GRABBER.DOC is
  43.           the reference manual for GRABBER.EXE, which is the main program
  44.           module in the package.)
  45.  
  46.           The shareware license terms in the GRABBER.DOC file are incorpo-
  47.           rated here by reference.  This license permits you to copy and
  48.           distribute the files listed in the first paragraph above, provid-
  49.           ed that:  these files are always distributed together with each
  50.           other and with the GRABBER.EXE and GRABBER.DOC files; none of the
  51.           files is modified in any way; and no fee, premium or donation of
  52.           any kind is charged or requested for their distribution except as
  53.           permitted on the terms described in the GRABBER.DOC file.
  54.  
  55.           Continued use of any of these programs for more than a 10-day
  56.           trial period requires you to register your use of the software
  57.           with the author.  For more information about the benefits of
  58.           registration and how to go about registering, please refer to the
  59.           full licensing and ordering information in the GRABBER.DOC file.
  60.  
  61.           GRABBER CONVERSION UTILITIES                         Page 2 of 12
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                   Table of Contents
  69.  
  70.  
  71.  
  72.           Overview .....................................................  3
  73.  
  74.           The GIF file format ..........................................  3
  75.  
  76.           The PCX file format ..........................................  4
  77.  
  78.           What these programs can convert ..............................  4
  79.  
  80.           Special note for Super-VGA graphics ..........................  5
  81.  
  82.           Explanation of GRAI2PCX and GRAI2GIF .........................  5
  83.  
  84.           Interactive vs. Command Line Operation  ......................  6
  85.  
  86.           Using GR2PCX:  Interactive Mode ..............................  6
  87.  
  88.           Using GR2PCX:  Command Line Mode .............................  7
  89.  
  90.           Using GR2GIF:  Interactive Mode ..............................  9
  91.  
  92.           Using GR2GIF:  Command Line Mode ............................. 10
  93.  
  94.           "Thanks for trying GRABBER" messages ......................... 10
  95.  
  96.           Using the Resize feature ..................................... 11
  97.  
  98.           Using GR2ASCII and GR2ANSI ................................... 12
  99.  
  100.           GRABBER CONVERSION UTILITIES                         Page 3 of 12
  101.  
  102.  
  103.  
  104.           OVERVIEW OF THE GRABBER CONVERSION UTILITIES
  105.           ---------------------------------------------
  106.  
  107.           GR2PCX and GR2GIF are companion utilities to the GRABBER screen
  108.           capture program.  GRAI2PCX and GRAI2GIF are companion utilities
  109.           to the GR4AI screen capture program.  You can use them to convert
  110.           graphic images, captured from your video display in the form of
  111.           GRABBER "offspring" files, into the widely recognized image
  112.           formats called PCX and GIF.
  113.  
  114.           In addition, if your computer has an EGA or VGA video graphics
  115.           adapter and a color monitor, the GR2PCX utility can also convert
  116.           80 x 25 text images captured by GRABBER to the PCX graphic
  117.           format.
  118.  
  119.           (If you are unfamiliar with how the GRABBER or GR4AI programs
  120.           work, or what an "offspring" file is, please consult the program
  121.           manuals GRABBER.DOC and GR4AI.DOC before continuing.)
  122.  
  123.  
  124.  
  125.           THE "GIF" FILE FORMAT
  126.           ----------------------
  127.  
  128.           "GIF" (pronounced like "Jif") stands for Graphic Interchange
  129.           Format.  The GIF image format was developed by CompuServe, Inc.,
  130.           as a generalized method of exchanging and displaying graphic
  131.           images on the widest possible variety of computer graphics
  132.           hardware.  GIF is one of the most widely accepted formats for
  133.           exchanging graphics information among all makes and models of
  134.           microcomputers, whether IBM-compatible or not.  One of the
  135.           reasons for the popularity of the GIF format is its very effec-
  136.           tive data compression method.  Generally, there is no other
  137.           widely used file format which can compress a graphic image into a
  138.           smaller space than GIF can.
  139.  
  140.           The GIF format is supported extensively on the CompuServe Infor-
  141.           mation Service and many other on-line BBS services that make
  142.           graphic images available for downloading.  In addition to these
  143.           on-line services, however, there are several PC application
  144.           programs which can employ the GIF format.  These include word
  145.           processing, desktop publishing, and "paint" programs, as well as
  146.           numerous picture viewing utilities. Therefore, you can use GR2GIF
  147.           to convert almost any graphic image captured by GRABBER into GIF
  148.           format, so that the image can be imported into any word process-
  149.           ing, desktop publishing, or paint program which "understands" the
  150.           GIF format.  If you want to find out whether a particular appli-
  151.           cation program you use can work with GIF files, and therefore
  152.           import the files created by GR2GIF, you should consult that
  153.           program's documentation or contact its publisher.
  154.  
  155.           GRABBER CONVERSION UTILITIES                         Page 4 of 12
  156.  
  157.  
  158.  
  159.           THE "PCX" FILE FORMAT
  160.           ----------------------
  161.  
  162.           The PCX image format was developed by Zsoft Corporation, which is
  163.           the publisher of the widely used graphics "paint" programs PC
  164.           Paintbrush and Publisher's Paintbrush.  Both of these programs
  165.           use the PCX format for storing and retrieving graphic images to
  166.           and from disk files. However, many other PC applications which
  167.           involve graphic data, in addition to the two Zsoft products
  168.           mentioned, also employ the PCX format.  These include other paint
  169.           programs, word processors such as WordPerfect Version 5.0 and
  170.           later, desktop publishing programs such as Aldus' PageMaker, and
  171.           picture viewing utilities.  The PCX format uses a data compres-
  172.           sion scheme to reduce the disk space required to store graphic
  173.           images.
  174.  
  175.           You can use GR2PCX to convert almost any graphic image captured
  176.           by GRABBER into PCX format, so that the image can be imported
  177.           into any word processing, desktop publishing, or paint program
  178.           which "understands" the PCX format.  Use GRAI2PCX to do the same
  179.           thing with screens captured by GR4AI.  If you want to find out
  180.           whether a particular application program you use can work with
  181.           PCX files, you should consult that program's documentation or
  182.           contact its publisher.
  183.  
  184.  
  185.           WHAT THE CONVERSION UTILITIES CAN CONVERT
  186.           ------------------------------------------
  187.  
  188.           These programs are able to convert almost any GRABBER offspring
  189.           file containing a graphic image into a separate PCX or GIF file. 
  190.           This includes any image originally captured in any CGA mode, any
  191.           EGA mode, any VGA mode, and the Hercules monochrome graphics
  192.           mode.  Also, the GR2PCX utility can be used to convert text-mode
  193.           images to the PCX graphics format.  To use GR2PCX to convert a
  194.           text-mode image, your computer must be equipped with an EGA or
  195.           VGA adapter and a color monitor, and the text screen must measure
  196.           80 columns by 25 rows.
  197.  
  198.           GRABBER CONVERSION UTILITIES                         Page 5 of 12
  199.  
  200.  
  201.  
  202.  
  203.           SPECIAL NOTE FOR SUPER-VGA GRAPHICS
  204.           ------------------------------------
  205.  
  206.           If you want to use GR2PCX or GR2GIF to convert a high- resolution
  207.           Super-VGA graphic image to another format, you should note that
  208.           the conversion utilities will not work properly unless GRAB-
  209.           BER.EXE is installed in memory, *and* is properly configured for
  210.           your particular type of Super-VGA display adapter.  For more
  211.           information on configuring GRABBER for your type of display
  212.           adapter, consult page 13 of the GRABBER documentation file
  213.           (GRABBER.DOC).
  214.  
  215.  
  216.           WHAT ARE GRAI2PCX and GRAI2GIF?
  217.           --------------------------------
  218.  
  219.           GRAI2PCX is functionally identical to GR2PCX.  GR2PCX is designed
  220.           exclusively for creating PCX files from screens captured by the
  221.           GRABBER.EXE program, while GRAI2PCX is designed exclusively for
  222.           creating PCX files from screens captured by the GR4AI.EXE pro-
  223.           gram.
  224.  
  225.           GRAI2GIF is functionally identical to GR2GIF.  GR2GIF is designed
  226.           exclusively for creating GIF files from screens captured by the
  227.           GRABBER.EXE program, while GRAI2GIF is designed exclusively for
  228.           creating GIF files from screens captured by the GR4AI.EXE pro-
  229.           gram.
  230.  
  231.           You operate GRAI2PCX and GRAI2GIF in exactly the same way as you
  232.           would operate the GR2PCX and GR2GIF programs.  For the sake of
  233.           brevity, the command examples used in this documentation will
  234.           refer only to GR2PCX and GR2GIF.  However, if the screen you wish
  235.           to convert was created by GR4AI and not GRABBER, then you can
  236.           substitute GRAI2PCX wherever you see GR2PCX mentioned here, and
  237.           substitute GRAI2GIF wherever you see GR2GIF.
  238.  
  239.           GRABBER CONVERSION UTILITIES                         Page 6 of 12
  240.  
  241.  
  242.  
  243.           INTERACTIVE vs. COMMAND-LINE OPERATION
  244.           ---------------------------------------
  245.  
  246.           If you run a conversion utility from the DOS prompt or a batch
  247.           file without any command-line parameters, you will be running the
  248.           program in an "interactive" mode.  This means the program will
  249.           prompt you on screen for the answers to several questions,
  250.           detailed below, before it goes to work converting your input
  251.           image file to the desired format.  If you don't like working with
  252.           command-line switches or can't remember them all (there are quite
  253.           a few), you will want to use the interactive mode.
  254.  
  255.           However, if you want to avoid having to answer each question
  256.           individually, you can run each conversion utility in a
  257.           "command-line" mode, by following the program name itself with
  258.           the names of your input and output files, plus any of the option-
  259.           al command-line switches, which are described below.
  260.  
  261.  
  262.           USING GR2PCX:  INTERACTIVE MODE
  263.           --------------------------------
  264.  
  265.           (1)  Enter the command GR2PCX and press <RETURN>.
  266.  
  267.           (2)  Specify the name of the offspring file you wish to convert
  268.                (the "input file").  You may optionally precede the filename
  269.                with a drive and/or pathname if necessary.  If the input
  270.                filename ends with ".EXE" as it should, you may omit this
  271.                extension from the filename.  (E.g., entering SCREENXX is
  272.                the same as entering SCREENXX.EXE.)
  273.  
  274.           (3)  To give the "output file" the same name as the input file
  275.                but with a ".PCX" filename extension, press <RETURN>.  If
  276.                you wish to give it a different name than the default which
  277.                the program shows you, or place it in a different drive or
  278.                directory than your input file, you must enter the full file
  279.                specification, including drive, path, and ".PCX" extension.
  280.  
  281.           (4)  If you want to convert the entire image to PCX, respond to
  282.                the "Resize image?" prompt by pressing <N> or <RETURN>.  The
  283.                resulting output file will contain data for the whole image
  284.                as it is displayed when you execute the offspring image
  285.                file.
  286.  
  287.                If you want to crop out portions of the screen and create an
  288.                output PCX image that is smaller than the original image,
  289.                press <Y> at the "Resize image?" prompt.  If you do this,
  290.                the image will be displayed with a rectangular "resize box,"
  291.                which you can adjust to fit the shape and position of the
  292.                portion of the image you want to convert.  Complete instruc-
  293.                tions for changing the size and positioning of the resize
  294.                box can be found below on page 11.
  295.  
  296.           GRABBER CONVERSION UTILITIES                         Page 7 of 12
  297.  
  298.  
  299.  
  300.           (5)  If the input file contains a graphic image, and you have a
  301.                VGA-compatible system, you will then be asked to specify a
  302.                color or gray-scale output file.  Press <C> or <RETURN> to
  303.                choose color, or press <G> for gray-scale.  If you are
  304.                converting a graphic image, this is the last question you
  305.                will be asked.
  306.  
  307.                If the input file contains a text image, you are given the
  308.                additional choice of monochrome (black-and-white) output. 
  309.                If you choose this option by pressing <B>, most color varia-
  310.                tions will be stripped from the output file.  Some word
  311.                processing and desktop publishing programs do not do a good
  312.                job of displaying or printing imported PCX files which
  313.                contain color or gray-scale information, so you may wish to
  314.                experiment with this option.
  315.  
  316.                If you do choose black-and-white output, you will then be
  317.                asked whether you want to invert the black and white colors
  318.                in the output image.  If the output PCX is destined to be
  319.                printed on paper, you may wish to experiment with this
  320.                option also.
  321.  
  322.           (6)  Finally, for text-mode input files only, one last question: 
  323.                You may choose the size of the screen font into which the
  324.                characters in the input file will be translated.  These are
  325.                the menu choices and the results they produce:
  326.  
  327.                Menu Option    Font Cell    Emulation    Total Image Size
  328.                -----------    ---------    ---------    ----------------
  329.                     A           8 x 8         CGA       640 x 200 pixels
  330.                     B           8 x 14        EGA       640 x 350 pixels
  331.                     C           9 x 14      EGA/MDA/    720 x 350 pixels
  332.                                             Hercules
  333.                     D           9 x 16        VGA       720 x 400 pixels
  334.  
  335.  
  336.  
  337.           USING GR2PCX:  COMMAND-LINE MODE
  338.           ---------------------------------
  339.  
  340.           To avoid the GR2PCX menu prompts described above, you can specify
  341.           the name of your input .EXE image file on the DOS command line
  342.           immediately after the GR2PCX command itself.  To select details
  343.           of program operation, you can follow the input file name with the
  344.           optional switches described here.  Certain default parameters,
  345.           also described here, will take effect for certain program fea-
  346.           tures if no optional switch is specified.  A GR2PCX command line
  347.           looks something like this (optional parameters are shown in
  348.           brackets):
  349.  
  350.                GR2PCX inputfile [outputfile] [/S] [/C] [/G] [/B] [/I] [/8]
  351.                                              [/4] [/9] [/6]
  352.  
  353.           GRABBER CONVERSION UTILITIES                         Page 8 of 12
  354.  
  355.  
  356.  
  357.                GR2PCX inputfile [outputfile] [/S] [/C] [/G] [/B] [/I] [/8]
  358.                                              [/4] [/9] [/6]
  359.  
  360.  
  361.           "inputfile" is the name of your GRABBER offspring .EXE image. 
  362.           The .EXE extension may be omitted.
  363.  
  364.           "outputfile" is the full name of the .PCX file you want to
  365.           create.
  366.  
  367.           You must add the .PCX extension yourself.  The name may be
  368.           preceded by a drive and/or directory path.  If omitted, the
  369.           output file will automatically be named "inputfile.PCX" and will
  370.           be placed on the same drive and directory path as the input file.
  371.  
  372.           /S tells GR2PCX that you will want to crop a portion of the image
  373.           using the resize box before actual conversion takes place.  If
  374.           omitted, the entire image is converted to PCX format.
  375.  
  376.           /C tells GR2PCX to produce a color output file (if the input file
  377.           is also a color image).  If omitted, no big deal.  Color output
  378.           is the default anyway for both graphics and text conversions.
  379.  
  380.           /G tells GR2PCX to produce a gray-scale output file (if the input
  381.           file is a color image).  This option is available only on
  382.           VGA-compatible systems, and is accepted for both graphics and
  383.           text conversions.
  384.  
  385.           /B tells GR2PCX to produce a monochrome (black-and-white) output
  386.           PCX file.  This option is valid only for text screen conversions.
  387.  
  388.           /I tells GR2PCX to produce a monochrome (black-and-white) output
  389.           PCX file, *and* to invert the white and black elements of the
  390.           image.  White becomes black and vice-versa.  This option can be
  391.           useful if you intend to print the PCX output on paper, and is
  392.           valid only for text screen conversions.
  393.  
  394.           All of the remaining optional switches are used to specify screen
  395.           font choices and are valid only for text screen conversions.  For
  396.           more information about the image dimensions associated with these
  397.           fonts, see the chart on the previous page under item (6) in the
  398.           section headed "Using GR2PCX: Interactive Mode."
  399.  
  400.                /8   selects an 8x8 font cell which emulates CGA
  401.                /4   selects an 8x14 font cell which emulates some EGAs
  402.                /9   selects a 9x14 font cell emulating MDA, Hercules and
  403.                     most EGAs
  404.                /6   selects a 9x16 font cell which emulates VGA
  405.  
  406.           GRABBER CONVERSION UTILITIES                         Page 9 of 12
  407.  
  408.  
  409.  
  410.           USING GR2GIF:  INTERACTIVE MODE
  411.           --------------------------------
  412.  
  413.           (1)  Enter the command GR2GIF and press <RETURN>.
  414.  
  415.           (2)  Specify the name of the offspring file you wish to convert
  416.                (the "input file").  You may optionally precede the filename
  417.                with a drive and/or pathname if necessary.  If the input
  418.                filename ends with ".EXE" as it should, you may omit this
  419.                extension from the filename.  (E.g., entering SCREENXX is
  420.                the same as entering SCREENXX.EXE.)
  421.  
  422.           (3)  To give the "output file" the same name as the input file
  423.                but with a ".GIF" filename extension, press <RETURN>.  If
  424.                you wish to give it a different name than the default which
  425.                the program shows you, or place it in a different drive or
  426.                directory than your input file, you must enter the full file
  427.                specification including drive, path, and ".GIF" extension.
  428.  
  429.           (4)  If you want to convert the entire image to GIF, respond to
  430.                the "Resize image?" prompt by pressing <N> or <RETURN>.  The
  431.                resulting output file will contain data for the whole image
  432.                as it is displayed when you execute the offspring image
  433.                file.
  434.  
  435.                If you want to crop out portions of the screen and create an
  436.                output image that is smaller than the original image, press
  437.                <Y> at the "Resize image?" prompt.  If you do this, the
  438.                image will be displayed with a rectangular "resize box,"
  439.                which you can adjust to fit the shape and position of the
  440.                portion of the image you want to convert.  Complete instruc-
  441.                tions for changing the size and positioning of the resize
  442.                box can be found below on page 11.
  443.  
  444.           (5)  If you have a VGA-compatible system, you will then be asked
  445.                to specify a color or grayscale output file.  Press <C> or
  446.                <RETURN> to choose color, or press <G> for grayscale.  This
  447.                is the last question the program will ask you before it goes
  448.                to work.
  449.  
  450.           GRABBER CONVERSION UTILITIES                        Page 10 of 12
  451.  
  452.  
  453.  
  454.           USING GR2GIF:  COMMAND-LINE MODE
  455.           ---------------------------------
  456.  
  457.           To avoid the GR2GIF menu prompts described above, you can specify
  458.           the name of your input .EXE image file on the DOS command line
  459.           immediately after the GR2GIF command itself.  To select details
  460.           of program operation, you can follow the input file name with the
  461.           optional switches described here.  Certain default parameters,
  462.           also described here, will take effect for certain program fea-
  463.           tures if no optional switch is specified.  A GR2GIF command line
  464.           looks something like this (optional parameters are shown in
  465.           brackets):
  466.  
  467.                      GR2GIF inputfile [outputfile] [/S] [/C] [/G]
  468.  
  469.           "inputfile" is the name of your GRABBER offspring .EXE image. 
  470.           The .EXE extension may be omitted.
  471.  
  472.           "outputfile" is the full name of the .GIF file you want to
  473.           create.  You must add the .GIF extension yourself.  The name may
  474.           be preceded by a drive and/or directory path.  If omitted, the
  475.           output file will automatically be named "inputfile.GIF" and will
  476.           be placed on the same drive and directory path as the input file.
  477.  
  478.           /S tells GR2GIF that you will want to crop a portion of the image
  479.           using the resize box before actual conversion takes place.  If
  480.           omitted, the entire image is converted to GIF format.
  481.  
  482.           /C tells GR2GIF to produce a color output file (if the input file
  483.           is also a color image).  If omitted, no big deal.  Color output
  484.           is the default.
  485.  
  486.           /G tells GR2GIF to produce a gray-scale output file (if the input
  487.           file is a color image).  This option is available only on VGA-
  488.           compatible systems.
  489.  
  490.  
  491.           "THANKS FOR TRYING GRABBER" MESSAGES
  492.           -------------------------------------
  493.  
  494.           Because this is an unregistered, shareware version of GRABBER,
  495.           most of the images which you convert using this version will
  496.           contain a small message in the lower right corner of the screen
  497.           expressing our "Thanks for trying GRABBER."  By including these
  498.           messages, we only hope to remind you that this version of GRABBER
  499.           and the conversion utilities are shareware, and to encourage you
  500.           to register the programs if you continue to find them useful.
  501.  
  502.           Users who register with the publisher (for the full $59.00 ver-
  503.           sion) will find that the registered version of GRABBER which they
  504.           receive creates PCX, GIF and PIC files that do not include this
  505.           or any other message superimposed on converted images.
  506.  
  507.           GRABBER CONVERSION UTILITIES                        Page 11 of 12
  508.  
  509.  
  510.  
  511.           USING THE RESIZE FEATURE:  CONTROLLING THE RESIZE BOX
  512.           ------------------------------------------------------
  513.  
  514.           The following keys are available to you when using the resize
  515.           feature within GR2PCX, GR2GIF, GRAI2PCX and GRAI2GIF:
  516.  
  517.  
  518.  
  519.           <Esc> ..................  Abort the conversion process and exit.
  520.  
  521.           <Return> ...............  Accept the area enclosed by the select
  522.                                     box, and begin converting.
  523.  
  524.           <Left Arrow>
  525.           <Right Arrow>             Move the select box in the indicated
  526.           <Up Arrow>                direction, but do not change the shape
  527.           <Down Arrow> ...........  of the box.
  528.  
  529.           <Shift><Left Arrow> ....  Shrink the box horizontally.
  530.  
  531.           <Shift><Right Arrow> ...  Expand the box horizontally.
  532.  
  533.           <Shift><Up Arrow> ......  Shrink the box vertically.
  534.  
  535.           <Shift><Down Arrow> ....  Expand the box vertically.
  536.  
  537.           <Insert> ...............  Toggle between coarse and fine incre-
  538.                                     ments for moving or reshaping the box.
  539.  
  540.           <Home> .................  Move the box to the upper left-hand
  541.                                     corner of the screen.
  542.  
  543.           <End> ..................  Move the box to the lower left-hand
  544.                                     corner of the screen.
  545.  
  546.           <Ctrl><PgUp> ...........  Move the box to the upper right-hand
  547.                                     corner of the screen.
  548.  
  549.           <Ctrl><PgDn> ...........  Move the box to the lower right-hand
  550.                                     corner of the screen.
  551.  
  552.           <PgUp> .................  Move box to top edge of the screen.
  553.  
  554.           <PgDn> .................  Move box to bottom edge of the screen.
  555.  
  556.           <Ctrl><Left Arrow> .....  Move box to left edge of the screen.
  557.  
  558.           <Ctrl><Right Arrow> ....  Move box to right edge of the screen.
  559.  
  560.           GRABBER CONVERSION UTILITIES                        Page 12 of 12
  561.  
  562.  
  563.  
  564.           USING GR2ASCII and GR2ANSI
  565.           ---------------------------
  566.  
  567.           GR2ASCII and GR2ANSI are companion utilities to the GRABBER
  568.           screen capture program.  You can use them to convert text images,
  569.           captured from your video display in the form of GRABBER "off-
  570.           spring" files, into plain ASCII or ANSI formats, respectively.
  571.  
  572.           These programs work only with character-based text images cap-
  573.           tured by GRABBER.  They do not work with pixel-based graphic
  574.           images.
  575.  
  576.           To create an ASCII text file from a captured GRABBER offspring
  577.           image, enter a command similar to the following at the DOS
  578.           prompt:
  579.  
  580.                       GR2ASCII inputfile[.exe] [outputfile.txt]
  581.  
  582.           "inputfile" represents the name of the GRABBER offspring image
  583.           you wish to convert.  The .exe filename extension may be omitted.
  584.  
  585.           "outputfile.txt" represents the name of the new ASCII text file
  586.           you wish to create from the contents of the input file.  This
  587.           output file name is optional.  If you do not specify it, the
  588.           program will create an output file which has the same name as the
  589.           input file, but with an extension of ".TXT".  For example, the
  590.           command
  591.  
  592.                             GR2ASCII C:\PICTURES\SCREEN99
  593.  
  594.           will cause the program to read the SCREEN99.EXE file and generate
  595.           an output ASCII file called C:\PICTURES\SCREEN99.TXT.
  596.  
  597.           To create an ANSI graphics file from a captured GRABBER offspring
  598.           image, follow the first command example shown above, substituting
  599.           GR2ANSI for GR2ASCII.  (Each of these programs is operated the
  600.           same way as the other.)  If you do not specify the optional
  601.           output file name on the GR2ANSI command line, the program will
  602.           create an output file which has the same name as the input file,
  603.           but with an extension of ".ANS".  For example, the command
  604.  
  605.                              GR2ANSI C:\PICTURES\SCREEN99
  606.  
  607.           will create an output ANSI file called C:\PICTURES\SCREEN99.ANS.
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.                            * * *  End of CONVERT.DOC  * * *
  617.