home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / graphvew / gifwrp15.arj / GIFWARP.DOC < prev    next >
Text File  |  1993-05-22  |  15KB  |  350 lines
  1.  
  2.                          G I F W A R P ! 
  3.  
  4.                            Version 1.5
  5.                           May 20 , 1993
  6.      
  7.      A Transformation Program for Your GIF(tm) Pictures
  8.        Copyright 1990,1993 Steve Enns and Dan Magosse,
  9.                        All right reserved. 
  10.  
  11.      GIFWARP! is produced by:
  12.  
  13.            Steve Enns                     Dan Magosse 
  14.         44 Macdermid Cres.             1321 14th St. East 
  15.           Saskatoon, Sk.                 Saskatoon, Sk. 
  16.           Canada S7J 2R2                 Canada S7H 0A6 
  17.  
  18.      Our motto:
  19.      
  20.      "We endeavour to pursue faithfully the highest principles in
  21.      sophisticated program design and development - until we're
  22.      offered more money or more exciting jobs."
  23.  
  24.      Top Ten Phrases heard around this lab:
  25.  
  26.                "What does `File Allocation Table Bad' mean?"
  27.                "Where was that bottle?"
  28.                "Sure it's weird, but will it sell?"
  29.                "Are these deductions right?"
  30.                "Where's that Stones tape?"
  31.                "Yah, C is okay, but can you do it in FORTRAN?"
  32.                "Where was that bottle?"
  33.                "I thought YOU fed the sled dogs!"
  34.                "Error handling?  What's that?"
  35.                "Where was that bottle?"
  36.  
  37.      Okay, here's the boring stuff, but don't worry, it's better
  38.      than chewing tinfoil:
  39.  
  40. ACKNOWLEDGEMENTS
  41.  
  42.      Kudos, thanks, and good karma to John Bridges for the
  43.      enlightening information and code contained in his VGAKIT
  44.      package.  Trademarks like GIF(tm) and PC(tm) are held by
  45.      their respective companies. 
  46.  
  47. DISCLAIMER
  48.  
  49.      The GIFWARP! program is provided without warranty of any
  50.      kind.  The user of the GIFWARP! assumes complete
  51.      responsibility for any and all incidental or consequential
  52.      damages which may occur during normal or abnormal use of the
  53.      GIFWARP! program.  Use the GIFWARP! program at your own
  54.      risk.
  55.  
  56. LICENSE 
  57.  
  58.      The entire GIFWARP! package, including the GIFWARP! program,
  59.      documentation, and sample files are Copyright 1990,1993
  60.      Steve Enns and Dan Magosse.  All rights reserved.  The      
  61.      unregistered shareware version of the GIFWARP! may be freely
  62.      distributed to others by any means, as long the following
  63.      (three) conditions are met:
  64.  
  65.           1) GIFWARP! is distributed in a "package" containing
  66.           the following three files:
  67.                               GIFWARP.EXE
  68.                               GIFWARP.DOC
  69.                               GW-READ.ME
  70.           
  71.           2) GIFWARP! is not distributed as part of any other    
  72.           product, except with specific written permission from
  73.           the authors.
  74.  
  75.           3) NO fee of any kind is charged for the GIFWARP!
  76.           package or for the service of providing the package,
  77.           except Computer Bulletin Board Systems, which may
  78.           distribute the GIFWARP! package even though they may
  79.           charge a membership or service fee.
  80.  
  81.      You can use the "shareware" version for as long as you want,
  82.      even until you're well into your nineties, but you are of
  83.      course encouraged to send us lots of money, too. (I'm
  84.      struggling to pay for my violin lessons, and Dan needs a new
  85.      fishing rod.)  On the other hand, a "registered" version of
  86.      GIFWARP! is available from the authors for $8.00 U.S.  The
  87.      registered version provides support for 512K and 1024K
  88.      SuperVGA cards from most manufacturers (see  REQUIREMENTS
  89.      below).  The registered version is licensed to the          
  90.      purchaser exclusively, and may not be distributed to others. 
  91.      To order the SuperVGA version of GIFWARP!, send $8.00 U.S.  
  92.      to the "Steve Enns" guy mentioned above.  You will receive a
  93.      5.25" (sorry NO 3.5" disks!) disk with the latest SuperVGA  
  94.      version of GIFWARP!  If you send $23.00 or more, you will   
  95.      also the receive licensed SuperVGA versions of:
  96.  
  97.           GIFCLIP   Crop the borders from your GIF(tm) pictures -
  98.                     cut pieces from GIFs, add text or GIF logos
  99.                     or taglines.
  100.  
  101.           GIFSIZE   Resize your GIFs.  Resize parts of your GIFs,
  102.                     or shrink the entire picture to the size of
  103.                     an icon.
  104.  
  105.           GIFEXE    Make your GIF(tm) into an executable program. 
  106.                     Just run the program to display the picture. 
  107.                     Special effects for demos or displays, or
  108.                     title screens for your programs.  Supports
  109.                     SuperVGA.
  110.  
  111.      Look for the unlicensed shareware versions of GIFCLIP,
  112.      GIFSIZE and GIFEXE on your favourite bulletin board system.
  113.  
  114. REQUIREMENTS
  115.  
  116.           GIFWARP! requires the following:
  117.  
  118.                -    A strange desire to warp GIF(tm) pictures
  119.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing
  120.                -    About 280K of free RAM
  121.                -    DOS 3.0, 3.1, 3.2, 3.3, 4.0 (others untested)
  122.                -    A mouse that at least claims to be
  123.                          compatible with something
  124.                -    A VGA or SuperVGA card
  125.                -    Some GIF(tm) pictures to warp!
  126.  
  127.           and optionally:
  128.  
  129.                -    Really artsy attitude with a preference for
  130.                          Dali or Cubist Picasso
  131.                -    Those chips that do that strange math stuff
  132.                          (8087/80287 or 80387 Especially helpful
  133.                          for big, high res transformations)
  134.                -    SuperVGA - The registered SuperVGA version of
  135.                     GIFWARP! supports modes like 640x480, 800x600
  136.             and 1024x768 with 256 colours on 512K SuperVGA
  137.             cards from ATI, Ahead, Cirrus, Chips and
  138.             Technologies, Everex, OAK, Paradise, Trident,
  139.             Tseng, Compaq,  Video7, VESA, NCR, Genoa.
  140.             See the LICENSE section above for ordering
  141.             information.
  142.  
  143. INSTALLATION
  144.  
  145.      Copy the GIFWARP! program (and this helpful document of
  146.      course!) to any directory that you want - perhaps with      
  147.      your favourite GIF(tm) viewer somewhere in the DOS          
  148.      path.
  149.  
  150. USAGE
  151.  
  152.      Syntax for GIFWARP! is as follows:
  153.  
  154.           GIFWARP [?] infilename[.GIF] [outfilename[.GIF]]
  155.                          /autoscale
  156.      or
  157.  
  158.           GIFWARP [?] infilename[.GIF] [outfilename[.GIF]]
  159.                          /mode={0,1,2,3} /autoscale
  160.  
  161.      for the registered version.  ( The /mode=n parameters are as
  162.      follows:       /mode=0        Ordinary 320x200 mode
  163.                     /mode=1        Low resolution SVGA
  164.                                         640x400 or 640x350
  165.                                         depending on your card.
  166.                     /mode=2        Medium resolution 640x480
  167.                     /mode=3        High resolution 800x600 
  168.  
  169.                     /mode=4        Higher resolution 1024x768
  170.                                         is supported on some
  171.                                         1024K cards. Try a VESA driver!)
  172.                                                   
  173.      The /autoscale switch will try to scale the GIF to fit on
  174.      the screen when the specified screen mode is much larger
  175.      than the image.
  176.  
  177.      For example, try:
  178.  
  179.           C> GIFWARP               to see the title screen
  180.  
  181.           C> GIFWARP ?             to see the help/brag screen
  182.  
  183.           C> GIFWARP house         to view/warp the file
  184.                                    HOUSE.GIF writing the warped
  185.                                    picture (if any) to the 
  186.                                    default name GIFWARP.GIF
  187.  
  188.           C> GIFWARP house house2  view/warp the file HOUSE.GIF,
  189.                                    writing output to HOUSE2.GIF
  190.  
  191.      With the registered version:
  192.  
  193.           C> GIFWARP car /mode=2   View/warp CAR.GIF using medium
  194.                                    resolution SuperVGA
  195.                               
  196. TUTORIAL
  197.  
  198.      (Just play around with GIFWARP! for a while - you'll get the
  199.      hang of it very quickly...)
  200.  
  201.      Try out the following with your favourite GIF(tm) picture:
  202.  
  203.                C> GIFWARP picturename
  204.  
  205.      GIFWARP! will load the picture and display it one your
  206.      screen.  A rectangle will appear in the centre of the
  207.      picture.  The rectangle is divided into four smaller
  208.      rectangles, and the entire rectangle will move with the
  209.      mouse.  This "target box" allows you to choose areas of the
  210.      picture that you want to warp.  You can change the size of  
  211.      the target box using the arrow keys or number pad.
  212.  
  213.           Choose an area of the picture, and move the target     
  214.      box to that area.  Change the size of the box if you want. 
  215.      Now, press the left mouse button.  After pressing the left
  216.      mouse button, when you move the mouse the target box will no
  217.      longer move, but you will now be changing the shape of the
  218.      four smaller rectangles that make up the target box.  (If
  219.      you want to move the target box to a different area of the
  220.      picture, just press the left mouse button again - you can
  221.      then move the target box again.)  Position the mouse to     
  222.      choose a new shape of the smaller rectangles, and then press
  223.      the right mouse button.
  224.  
  225.           The picture will now be warped according to the new
  226.      shape of the smaller rectangles.  This process may be
  227.      repeated as often as desired.  Just remember that the left
  228.      mouse button is used to select the area to be warped, and
  229.      the shape of the warp, the right mouse button is used to do
  230.      the warp.
  231.      
  232.           After you have warped the picture, press the <ENTER> or
  233.      <RETURN> key to save the warped picture onto disk.  The
  234.      picture will be saved with the name GIFWARP.GIF, or the     
  235.      output name that you specified when you started GIFWARP!. 
  236.      If you don't want to save the picture, then just press the
  237.      <ESC> key, and GIFWARP! will exit without saving the current
  238.      picture.
  239.  
  240.  
  241. HINTS
  242.  
  243.      - Try subtle as opposed to drastic choices when choosing a
  244.      warp.  Subtle changes will usually look more "realistic,"
  245.      although dramatic changes may also produce interesting
  246.      effects.
  247.  
  248.      - GIF(tm) pictures of faces and animals can be warped to
  249.      produce a variety of interesting effects.  You can do really
  250.      strange things to faces - pinnochio noses and stuff like
  251.      that.  Warps of ordinary pictures like cars, scenery or
  252.      houses can also produce truly bizarre and surreal effects. 
  253.      Upload your best warped GIFs to a local Bulletin Board
  254.      System, or from wherever you got GIFWARP! 
  255.  
  256.      - Some degradation in picture quality is always produced by
  257.      the warping process.  These artifacts can be minimized by
  258.      careful choice of warps, and by not "re-warping" the same
  259.      area over and over again, as the quality will be reduced
  260.      each time the area is processed.  If the warped picture has
  261.      been really messed up, then just hit <ESC>, and start again. 
  262.      (The best solution, is of course to purchase the registered
  263.      SuperVGA version for a measly $8.00 U.S.  The resolution of
  264.      the SuperVGA modes allows for the most  "realistic" and     
  265.      highest quality transformations.)
  266.  
  267. ERRORS
  268.  
  269.      - The following self explanatory error messages may be
  270.      produced by GIFWARP!  The errors involving the GIF(tm) files
  271.      will generally be due to disk errors or faulty image files. 
  272.      Other errors refer to lack of enough free RAM space, or lack
  273.      of required hardware (VGA and Mouse).
  274.  
  275.           Can't initialize VGA graphics!
  276.           Mouse driver not installed.
  277.           Can't allocate mouse memory!
  278.           Unexpected EOF reading GIF!
  279.           Premature end of GIF!
  280.           Not GIF file!
  281.           Invalid GIF format
  282.           Error writing GIF!
  283.           Buffer allocation failure!
  284.           
  285. NOTES
  286.  
  287.      - Look for example images warped by GIFWARP! on your
  288.      favourite Bulletin Board System.  Examples from us will
  289.      probably be named  nGIFWARP.GIF  where "n" is a number or
  290.      letter.   
  291.  
  292.      - GIFWARP! reads both GIF87A standard (the original) and    
  293.      new GIF89A pictures, although most of the extensions in the
  294.      new GIF89A standard like (silly) text windows are ignored. 
  295.      The last image in multi-image GIFs will be the one displayed
  296.      for warping in GIFWARP!
  297.  
  298.      - Although only the registered copy of GIFWARP! provides
  299.      full SuperVGA resolution, all GIF pictures can be decoded
  300.      and displayed on all versions of GIFWARP!  If the image is
  301.      too large for the available resolution, the image will be
  302.      centred on the screen.  You will see the middle 320x200
  303.      pixels of the image when the entire image is larger than
  304.      320x200, for example.  The registered version of GIFWARP!
  305.      will display images at resolutions up to 1024x768 according
  306.      to the size of the picture, or the specified mode.  (When
  307.      specifying a mode with a resolution higher than the image,
  308.      an image will be displayed at the resolution of the screen,
  309.      which allows high resolution warping to be done on lower
  310.      resolution images.)
  311.  
  312. HISTORY
  313.  
  314.      - Version 1.0 Completed Nov.1 1990
  315.  
  316.      - Version 1.2 Completed Sep.15 1991
  317.           Support for some additional SuperVGA cards, and
  318.           1024x768x256 modes on some 1024K cards.  This is
  319.           primarily due to Bridges' new VGAKIT35.
  320.  
  321.      - Version 1.3 Completed Sep.20 1991
  322.           /autoscale is now an option.
  323.  
  324.      - Version 1.4 BIG OL' BUG which disabled SuperVGA in
  325.           registered versions is now fixed.
  326.  
  327.      - Version 1.5 Completed May.20 1993
  328.       Support for more graphics hardware, including much
  329.       better VESA support.  S3 and other Windows accelerator
  330.       cards which support VESA are now supported. 
  331.  
  332. PROPOSED FUTURE ENHANCHMENTS
  333.  
  334.      These enhancments might be encorporated into GIFWARP! at
  335.      some point in the future. (Especially if I lose my job, and
  336.      have lots of free time.)
  337.  
  338.      - "Undo feature" - remove effect of last warp operation.
  339.  
  340.      - Support for other graphics hardware.  Hopefully, we will
  341.      be able to support new hardware and graphics modes as they
  342.      are introduced.
  343.  
  344.      - Support for other file formats?
  345.  
  346.      - Faster GIF(tm) decoding and encoding
  347.  
  348.      - Faster mapping.
  349.  
  350.