home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / GR / GR084.ZIP / SHOWGIF.DOC < prev    next >
Text File  |  1990-03-09  |  12KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                              Documentation for:
  21.  
  22.  
  23.                                SHOWGIF  4.1B
  24.  
  25.  
  26.  
  27.  
  28.                                      by
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                Bill  Parquet
  36.  
  37.  
  38.                                     and
  39.  
  40.  
  41.                                Dave Sharpless
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                Copyright 1989-90
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                 Introduction
  74.  
  75.             How many times have you downloaded a GIF file from your
  76.        favorite BBS only to discover you wasted maybe 15 minutes and
  77.        50,000 bytes of download credits on an array of dots that doesn't
  78.        really deserve to be called a picture, or had a "bad code in
  79.        file" after the first 10 lines?  Wouldn't it be nice to be able
  80.        to see the picture as you are getting it, and if you don't like
  81.        it, just abort the transfer, saving your time and ratios for
  82.        something more worthwhile?  If so, SHOWGIF is just the program
  83.        for you!  It is a TSR which sits in memory, quietly waiting for
  84.        the system to begin writing a GIF file.  Once the write begins,
  85.        SHOWGIF switches to the appropriate EGA/VGA video mode, and shows
  86.        the picture as it is coming over.  It is compatible with most
  87.        download protocols available.
  88.  
  89.  
  90.                             System Requirements
  91.  
  92.             SHOWGIF makes several requirements on your video hardware.
  93.        For SHOWGIF to function properly, your system must be equipped
  94.        with EGA or higher.  SHOWGIF also requires about 64k of memory.
  95.  
  96.  
  97.  
  98.                            Operation Instructions
  99.  
  100.             SHOWGIF should be installed sometime before you load your
  101.        terminal program.  This installation can be performed simply by
  102.        typing "SHOWGIF" just before loading your terminal program, or
  103.        inserting "SHOWGIF" in the batch file for your terminal.
  104.        "SHOWGIF" will remain quiet in memory until a file with the
  105.        extension ".GIF" is created on your disk.  "SHOWGIF" will go into
  106.        high resolution mode as soon as it gets enough information to
  107.        begin drawing.  (usually after the second Ymodem block)  From
  108.        that point, data will be put up on the screen just before it goes
  109.        to disk.  If you want to abort this viewing process, press the
  110.        backspace key ("<-").   Note that this will abort the file
  111.        viewing process, and not the download itself.   Aborting the
  112.        download (With ESC, ^C, ^X, or likewise) will also abort the
  113.        viewing, and bring up the "Incomplete picture" message.
  114.        Similarly, if the picture data is garbled, a "Bad code in
  115.        picture" will appear, aborting the viewing, but not the download
  116.        itself.  Once you are done downloading and have left your
  117.        terminal program, type SHOWGIF /u (note the 'u' is lowercase).
  118.        This will remove SHOWGIF from your computer, returning all of
  119.        about 64k.
  120.  
  121.        NOTE:  Since SHOWGIF is activated on the creation of a GIF file
  122.        on your disk,  COPYing a GIF file around will also kick in the
  123.        viewer.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                     Hints and Tips on the use of SHOWGIF
  140.  
  141.  
  142.             SHOWGIF can be put in your AUTOEXEC.BAT, but we don't
  143.        recommend it.  If you have not done so already, create a batch
  144.        file which installs SHOWGIF, runs your favorite terminal program
  145.        and then uninstalls SHOWGIF.  This method is better for two
  146.        reasons, one (1) because SHOWGIF is not constantly taking up
  147.        memory when it is not needed, and two (2) because you don't risk
  148.        installing something on top of SHOWGIF, which could lock up the
  149.        computer on SHOWGIF's removal.
  150.  
  151.  
  152.                             Configuring SHOWGIF
  153.  
  154.             If you have ever configured VPIC by Bob Montgomery, you
  155.        already know how to configure SHOWGIF.  If not, then here is a
  156.        simple explaination.  SHOWGIF (and VPIC) come with 10 or so
  157.        definition files which contain the name of your card, the amount
  158.        of memory, the plane switching strategy, and parameters for all
  159.        of the resolutions.  Find the definition file which best matches
  160.        your card, and say CSHOWGIF <def-filename> -- For example
  161.        CSHOWGIF ORCHIDES.CFG.  Typeing CSHOWGIF on its own will list the
  162.        current card name, resolution, and plane switching strategy.
  163.        These definition files can be modified if you want to
  164.        add/subtract resolutions
  165.  
  166.  
  167.                     Which Protocols Work Best With ShowGIF?
  168.  
  169.  
  170.             It will take some experimentation to determine exactly which
  171.        protocols jive well with ShowGIF, but we can give you a few
  172.        suggestions on what to use and what not to use.  Zmodem (DSZ) by
  173.        Omen Technologies has been found to work excellently with ShowGIF
  174.        at speeds up to 19200 baud.  Qmodem 4.0/4.1 (-r- the Forbin
  175.        Project) internal protocols work all right, except at the very
  176.        beginning, where they will temporary activate SHOWGIF, the
  177.        deactivate, then restart.  It sounds confusing, and looks fouled
  178.        up, but everything ends up working fine.  Some protocols write to
  179.        disk before sending their ACK code will be hurt the most (as
  180.        ShowGIF dramatically increases drive access time) are not
  181.        recommended.  Protocols such as SeaLink (CLINK 1.20) by System
  182.        Enhancement Associates which create a temporary file then rename
  183.        it are least recommended because they will never activate
  184.        ShowGIF.  (The temporary file does not have the .GIF extension)
  185.        You should not notice any significant drop in CPS in protocols
  186.        which work well with ShowGIF.  External modem users should not
  187.        notice any lengthy propagations between blocks (the RD light
  188.        staying off for more than second and half or more)
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                              Update Information
  206.  
  207.  
  208.        1.0 α: First version of SHOWGIF <Not released>
  209.  
  210.        1.0 ß: Several features added:  <Not released>
  211.  
  212.             * Status report at the end of viewing (Not a gif, bad code,
  213.                    etc.)
  214.             * Support for ATI, separate versions of the program
  215.             * Switch back normal video if d/l is aborted before
  216.                    viewer is aborted.
  217.             * Squeezing pictures to fit 320x200 (MCGA version)
  218.  
  219.        2.0  : Several problems fixed: <Beta Test>
  220.  
  221.             * Code parsing routine completely re-written for speed
  222.             * Rest of the main loop translated into machine language *
  223.             Lockup after "Picture is not a GIF" message resolved
  224.             * Picture information put up while drawing
  225.             * Stack frame is normalized after each picture -- no more
  226.                    lockup's after viewing 'too many' pictures
  227.             * 500% overall increase in speed! (benchmark 20 seconds in
  228.                  1.0 to 4 seconds in 2.0)
  229.  
  230.  
  231.        3.0  : Improvements made <Beta Test>
  232.  
  233.             * Support for EGA
  234.             * X axis scaling for pictures larger than 320 MCGA,EGA
  235.  
  236.        3.5  : Improvements made <First release>
  237.  
  238.             * One program can handle various video cards
  239.             * Internal configuration for video hardware
  240.             * Support for 10 more video cards
  241.  
  242.        3.7  : Improvements made <Beta Test>
  243.  
  244.             * 16 color (EGA) modes supported in standard VGA
  245.                  configuration (640x350 and 640x480)
  246.             * Offset picture difficulties corrected.
  247.  
  248.        4.1  : Improvements made <Limited Second release>
  249.  
  250.             * User definable resolutions (compatible with VPIC)
  251.             * Better judgement is used when choosing video modes.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.        4.1B : Addendum to second release <Second Release>
  272.  
  273.             * Added two new plane switching modes TRIDENT,CHIPSN'TECH
  274.             * New Intro.
  275.             * Fixed a problem in VGA.CFG that slipped through in 4.1
  276.               (Oops)
  277.             * Made sure it puts the information at the bottom of that
  278.               screen
  279.             * Minor revisions to the documentation
  280.  
  281.  
  282.                               Shareware notice
  283.  
  284.  
  285.             Like most authors of Shareware, we do not seriously believe
  286.        that you are going to send money.  However, if you wish to make a
  287.        donation, it will be greatly appreciated.  If you have any
  288.        comments, leave them to Bill Parquet on one of these fine boards,
  289.        us at The GIF Cache (419/531-2693) 9p-9a EST [invalid after MAY
  290.        1990!] or our favorite boards -- The Henrietta Outhouse (216/965-
  291.        5463), or N.O.I.S.E.  BBS (419/473-8651 --FidoNet 234/17) Enjoy!
  292.  
  293.  
  294.  
  295.                       Specifications for the Config Files
  296.  
  297.  
  298.             If you have ever seen the video card configurations for
  299.        VPIC**, these should look fairly familiar.  The top line of the
  300.        file is the name of the card being defined.  You name the card
  301.        anything you wish.  This particular parameter is just for future
  302.        identification.  The line contains the plane switching
  303.        methodology*.  If in doubt, just leave it alone.  The next two
  304.        lines are not used by ShowGIF and are included just for
  305.        compatibility.  The subsequent lines define all of the pertinent
  306.        video modes for your card.  It consists of several numbers which
  307.        are defined as follows:  1) Mode type (0 for EGA, 1 for VGA -
  308.        this is related to the number of colors available) 2) Palette
  309.        definition (0 for EGA, 1 for VGA.  VGA Palette definition is
  310.        considerably more precise.  Use EGA palette definition only if
  311.        you are operating an EGA card!)  3-6) The values for AX,BX,CX,DX
  312.        required to switch the card into that particular mode (for
  313.        instance VGA 320x200 would be 0x13 0 0 0) 7) X resolution 8) Y
  314.        resolution 9) Number of colors available in this resolution.
  315.  
  316.  
  317.  
  318.        *Not all of the plane switching techniques are supported.  Those
  319.        cards which use CIRRUS will generate the Unidentified plane
  320.        switching technique warning and default to NONE.  Either leave us
  321.        some mail on how to do it or stick with Plain Vanilla.  (NONE,
  322.        TSENG, ATI, VIDEO7, PARADISE, EVEREX, TRIDENT, and CHIPSNTECH ARE
  323.        supported).
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.        **VPIC is a first rate picture file viewer.  2.4 is the newest
  338.        version at the time of this writing.  VPIC may
  339.        be obtained from
  340.             BOB MONTGOMERY
  341.             132 PARSONS RD
  342.             LONGWOOD FL 32779
  343.        for the price of about $15 for registration (I think).
  344.  
  345.  
  346.                                Acknowledgments:
  347.  
  348.  
  349.        I'd like the following people for their contributions to ShowGIF:
  350.  
  351.  
  352.        Dave Sharpless - For originally coming up with the idea (...A
  353.             Zmodem that views .GIF's while downloading...), Writing the
  354.             original plane switching routines (pre-version 4.1B), the
  355.             intro, and convincing me to make this do EGA, support,
  356.             inspiration, and to take credit.
  357.  
  358.        John Sharpless - For spreading this program around the country.
  359.  
  360.        John Bridges - For releasing "VGAKIT.ZIP" from which the plane
  361.             switching routines in 4.1B on originated from.
  362.  
  363.  
  364.  
  365.                                 360 x 480 mode:
  366.  
  367.             I've seen several implementations of this bastard mode.  As
  368.        far as I'm concerned, its a Super-VGA mode, i.e. only extended
  369.        VGA cards can do it.  Besides, if you do own an extended vga
  370.        card, why not use 640x480?  If you can find a really compelling
  371.        reason for us to put this in, let us know.
  372.  
  373.  
  374.                         Thank you for using ShowGIF!
  375.  
  376.  
  377.        Send comments, complaints, complements, ideas, etc. to
  378.  
  379.             BILL PARQUET
  380.             30231 BATES RD.
  381.             PERRYSBURG, OHIO  43551-3827
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.