home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Graphics / graphics-16000.iso / msdos / animutil / hcplay / hcplay.doc < prev    next >
Text File  |  1993-05-23  |  12KB  |  313 lines
  1.  
  2.   
  3.  
  4.                            H C P L A Y 
  5.  
  6.                            Version 1.2
  7.                           May 20 , 1993
  8.       
  9.       A 32,768 Color Animation Player for HiColor SuperVGA
  10.            Copyright 1990,1993 Synergrafix Consulting 
  11.                        All right reserved.  
  12.     
  13.      HCPLAY is produced by: 
  14.  
  15.            Steve Enns                    Dan Magosse 
  16.         44 Macdermid Cres.    and       1321 14th St. 
  17.           Saskatoon, Sk.                Saskatoon, Sk.  
  18.           Canada S7J 2R2                   Canada  
  19.   
  20.      in association with:
  21.  
  22.         Synergrafix Consulting
  23.           44 Macdermid Cres.
  24.             Saskatoon, Sk.
  25.             Canada S7J 2R2
  26.  
  27.  
  28. SYNOPSIS
  29.  
  30.      HCPLAY will play ordinary VGA FLI animations, SuperVGA FLI
  31.      animations, and new 32,768 colour (HiColor) animations
  32.      produced from a series of Targa images using our HCMAKE
  33.      program.
  34.  
  35.  
  36. ACKNOWLEDGEMENTS 
  37.  
  38.      Continued good karma to John Bridges for the enlightening
  39.      information and code contained in his VGAKIT kit package. 
  40.      Trademarks like GIF(tm) and PC(tm) are held by their
  41.      respective companies.  
  42.  
  43.  
  44. DISCLAIMER 
  45.  
  46.      The HCPLAY program is provided without warranty of any       
  47.      kind.  The user of HCPLAY assumes complete responsibility
  48.      for any and all incidental or consequential damages which may
  49.      occur during normal or abnormal use of the HCPLAY program. 
  50.      Use the HCPLAY program at your own risk. 
  51.  
  52.  
  53.  
  54.  
  55. LICENSE  
  56.   
  57.      The entire HCPLAY package, including the HCPLAY, HCMAKE and
  58.      HCSHOW programs, documentation and sample files are Copyright
  59.      1990,1992 Synergrafix Consulting.  All rights reserved.  The 
  60.      unregistered shareware versions of the programs may be freely 
  61.      distributed to others by any means, as long the following 
  62.      (three) conditions are met: 
  63.  
  64.           1) HCPLAY is distributed in a "package" containing the
  65.           following files: 
  66.  
  67.                               HCPLAY.EXE 
  68.                               HCPLAY.DOC
  69.                               HCPLAY.ME 
  70.            
  71.           2) HCPLAY 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 HCPLAY         
  76.           package or for the service of providing the package,    
  77.           except Computer Bulletin Board Systems, which may       
  78.           distribute the HCPLAY package even though they may      
  79.           charge a membership or service fee.   
  80.  
  81.      You can use the "shareware" version of HCPLAY for personal,
  82.      non-commercial use for as long as you want, although your
  83.      support will directly contribute to its further development
  84.      and improvement.  Commercial users, and those wishing to
  85.      produce longer animations may purchase an unrestricted
  86.      (see below) kit containing registered versions of HCPLAY,
  87.      HCMAKE and HCSHOW.  Send $30.00 U.S. to:
  88.  
  89.                Synergrafix Consulting
  90.                44 Macdermid Cres.
  91.                Saskatoon, Sk.
  92.                Canada  S7J 2R2
  93.  
  94.      and you will receive a 5 1/4" disk containing the latest
  95.      unlimited versions of HCPLAY and HCMAKE, along with the HCSHOW
  96.      bonus program. 
  97.  
  98.  
  99.      Look for the shareware version of HCMAKE wherever you found
  100.      HCPLAY.  HCMAKE will produce 32,768 colour (HiColor)
  101. animations     for HCPLAY from a series of 15,16 or 24 bit Targa
  102. images.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110. COMPULSORY ADVERTISING AND GENERAL BEGGING
  111.  
  112.      The following programs are also available from Synergrafix
  113.      Consulting: 
  114.  
  115.  
  116.           GIFEXE         Make you GIF's self-displaying.  Make
  117.                          automatic slideshows with fades, etc.
  118.                          VGA/SVGA.
  119.  
  120.           GIFWARP!       Warp, bend stretch your GIFs for 
  121.                          interesting effects. 
  122.  
  123.           GIFCLIP        Clip/crop your GIFs, add text or your 
  124.                          own GIF logo or signature. 
  125.            
  126.           GIFSIZE        Resize all or part of your GIFs.  Shrink 
  127.                         an entire screen to the size of an icon.
  128.  
  129.      (These programs are available in licensed SuperVGA versions  
  130.      for $8.00 U.S. each, or get all four for $23.00 U.S. or more.
  131.      These registered versions may not be distributed to others, or
  132.      distributed with, or as part of any other product.  These
  133.      programs support modes like 640x480, 800x600 with 256 colours
  134.      on 512K and 1024K SuperVGA cards from ATI, Ahead, Cirrus,
  135.      Chips and Technologies, Everex, OAK, Paradise, Trident, Tseng,
  136.      Video7, Compaq, NCR, Genoa and VESA. 
  137.  
  138.  
  139. REQUIREMENTS 
  140.  
  141.      HCPLAY currently requires the following: 
  142.  
  143.           -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer (386/486
  144.                     strongly recommended.)
  145.           -    About 300K of free RAM 
  146.           -    DOS 3.0, 3.1, 3.2, 3.3, 4.0 (others untested) 
  147.           -    1 Mb or more of XMS memory, or RAM disk or disk
  148.                     cache is recommended.
  149.           -    A Tseng 4000 based SuperVGA card with 1Mb of
  150.                     video memory, and a HiColor (32,000 colour)
  151.                     compatible DAC chip, or an ATI XL with HiColor
  152.                     capability, or a VESA compliant HiColor capable
  153.                     board, such as an S3 based board (with a
  154.                     bug-free bios!)
  155.  
  156.  
  157. INSTALLATION 
  158.  
  159.      Simply copy the HCPLAY program (and this helpful document of 
  160.      course!) to any directory that you want - perhaps somewhere in
  161.      the DOS path. 
  162.       
  163.  
  164. USAGE 
  165.  
  166.      Syntax for HCPLAY is as follows: 
  167.  
  168.           HCPLAY [?] infilename[.FLI] /mode=0,1,2..  /speed=n
  169.                /n=m /stay /key=c /force /time /debug
  170.  
  171.      The options are as follows: 
  172.  
  173.  
  174.      /mode is used to force a particular video mode.  Generally,
  175.      the option SHOULD NOT BE used for HiColor animations, unless
  176.      it seems that HCPLAY is playing your animation in an incorrect
  177.      mode.  For SuperVGA type FLIs, the /mode switch may be used to
  178.      specify the size of the screen.
  179.  
  180.      /mode=code     /mode=0        Ordinary 320x200 mode 
  181.                     /mode=1        Low resolution SVGA 
  182.                                         640x400 or 640x350 
  183.                                         depending on your card. 
  184.                     /mode=2        Medium resolution 640x480 
  185.                     /mode=3        High resolution 800x600  
  186.                     /mode=4        Higher resolution 1024x768 
  187.                                         is supported on some 
  188.                                         1024K cards.) 
  189.                     /mode=5        Highest resolution 1280x1024
  190.                                         supposedly available on 
  191.                                         a VESA card out there 
  192.                                         somewhere...
  193.                      
  194.      /speed=n       This switch is used to specify the speed at
  195.                     which the animation is to be played.  This
  196.                     option overrides the speed value contained in
  197.                     the animation file.
  198.  
  199.  
  200.      /n=m           Play the animation "m" times.  The default is
  201.                     to play the animation until a key is pressed
  202.                     (see /key=c below).                           
  203.               
  204.      /stay          Do not clear the screen after the animation has
  205.                     played.  The graphics from the current frame
  206.                     will be left on the screen, and the screen will
  207.                     be left in HiColor mode.
  208.  
  209.      /key=c         Play the animation until the "c" key is
  210.                     pressed. "c" may be a character such as /key=a
  211.                     to specify the "a" key or it may be the ascii
  212.                     code of a character such as /key=27 to specify
  213.                     the ESC key.
  214.  
  215.      /force         Do not check video hardware before attempting
  216.                     to play the animation.  If you have a new
  217.                     HiColor compatible video card, but HCPLAY says
  218.                     "Can't set HiColor mode!" then try /force to
  219.                     avoid the hardware checking that may not detect
  220.                     your type of HiColor compatible chip.
  221.  
  222.      /time          Print the time required to play the animation.
  223.                     (This option can be used as a benchmark when
  224.                     combined with the /n=m switch.  Check the speed
  225.                     of new HiColor hardware.)
  226.  
  227.      /debug         This switch will print information about the
  228.                     XMS memory, VGA and DAC type, and the current
  229.                     animation.  This information may be helpful if
  230.                     HCPLAY won't work for you.  If you write me
  231.                     about a problem, try to include a screen print
  232.                     of this debug information.  Press a key to
  233.                     continue after displaying this information.
  234.  
  235.      For example, try: 
  236.  
  237.           C> HCPLAY ?              to see the help/brag screen 
  238.  
  239.           C> HCPLAY anim           to play the file "anim.fli"
  240.      
  241.           C> HCPLAY demo /n=10 /force /speed=0 /stay
  242.  
  243.                                    to play the file "demo.fli"
  244.                                    10 times, without checking
  245.                                    the video hardware, playing as
  246.                                    fast as possible (/speed=0), and
  247.                                    remaining on the screen when a
  248.                                    key is pressed.
  249.  
  250.  
  251.           C> HCPLAY demo.fli /key=27
  252.                                    
  253.                                    to play the file "demo.fli"
  254.                                    until the ESC key is pressed.
  255.  
  256.      
  257.      During playback, the keys '1' through '9' may be used to
  258.      change the speed of the animation.  '1' is fastest, '9' is
  259.      slowest.
  260.  
  261.  
  262. RESTRICTIONS AND CAVEATS
  263.  
  264.      This is a beta version of the software!
  265.  
  266.      HCPLAY is currently limited to SuperVGA and HiColor animation
  267.      at 640x480 resolution.
  268.  
  269.      Support for large 256 color SuperVGA FLI's is currently
  270.      incomplete.
  271.  
  272.      The shareware versions of HCPLAY and HCMAKE are currently
  273.      limited to animations of 25 or fewer frames.
  274.  
  275.      
  276. THE FUTURE
  277.  
  278.      We intend to make the following improvements to HCPLAY.  We
  279.      need your support to continue development!
  280.  
  281.      - Improved speed and support for ordinary SuperVGA FLI's.
  282.  
  283.      - Extract frames from animations as GIF(tm) and Targa(tm)
  284.           images.
  285.  
  286.      - Play animations with sound support. (?)
  287.  
  288.      - More commands available during animation playing.
  289.  
  290.      
  291. HISTORY 
  292.  
  293.      - Version 0.5b Completed Oct. 6 1992
  294.  
  295.           First public release.  
  296.  
  297.      - Version 0.7b Completed Oct. 15 1992
  298.  
  299.           Better SuperVGA FLI playing and support.
  300.           Keys '1' through '9' now specify speed during playing.
  301.           /MODE switch now applies to SuperVGA FLIs.
  302.           /DEBUG switch for computer hardware info.
  303.           
  304.      - Version 1.0  Completed Nov. 1 1992
  305.  
  306.      - Version 1.2  Completed May. 20 1993
  307.  
  308.           Support for more graphics hardware, including
  309.           ATI XL and VESA compliant HiColor boards such
  310.           as S3 based accelerator boards.
  311.           
  312.           
  313.