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