home *** CD-ROM | disk | FTP | other *** search
/ Becoming a Computer Animator / COMPANIMATE.ISO / pc / utils / starflic / sflic.exe / pak / STFL.DOC < prev    next >
Encoding:
Text File  |  1994-04-15  |  11.3 KB  |  265 lines
  1.  
  2. STARFLIC 1.20 - Flic File Compiler and Player, (C) 1994, TRIUS, Inc.       
  3. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5. Unmodified copies of the Shareware version of this program may be 
  6. distributed for a 30-day evaluation, provided no payment or any other 
  7. consideration is charged.  Distribution of this program in combination 
  8. with any other software or hardware, requires written permission from 
  9. TRIUS, Inc.
  10.  
  11. This is NOT a free program! (See the text file LICENSE.DOC for more 
  12. details)  Use beyond a 30-day evaluation period requires purchase of 
  13. License (Registration).  To register and get the License to use the 
  14. program, receive the latest version, printed documentation, technical 
  15. support, etc., send $29.00 US (plus $6 for S&H) to:    
  16.  
  17.          TRIUS,Inc.
  18.          P.O. Box 249
  19.          N. Andover, MA 01845-0249          
  20.  
  21. You may also order a registered copy of the program (using VISA,   
  22. MasterCard, or AMEX), by calling:             
  23.                    
  24.          1-800-468-7487 Orders ONLY!         
  25.  
  26. You may contact TRIUS, Inc. for information at:
  27.  
  28.          Tel:  508-794-9377
  29.          Fax:  508-688-6312
  30.          BBS:  508-794-0762  (2400/9600/14400,N,8,1)
  31.          CIS:  71333,103  (PCVENF forum, Section 16)
  32.          Internet:  71333.103@compuserve.com
  33.                
  34.  
  35.  
  36. General
  37. ~~~~~~~
  38. STARFLIC is a program designed to perform the following functions:
  39.  
  40.        -  View Individual TGA files (produced by 
  41.            ProtoCAD 3D or other programs)
  42.  
  43.        -  Compile sets of TGA files into a flic (FLI) file
  44.  
  45.        -  Play flic (FLI, FLC) animation files (created by 
  46.           STARFLIC or other programs)
  47.  
  48. FLI and FLC file formats were developed by Autodesk and have become 
  49. a standard in file animation.  They are used by a number of animation 
  50. programs including Autodesk 3D Studio and Autodesk Animator Pro.  The 
  51. two file structures are similar the basic difference being that FLI 
  52. files use Byte Oriented Differential Data Compression, while FLC files 
  53. use Word Oriented Differential Data Compression. 
  54.  
  55.  
  56.                     
  57. Installation
  58. ~~~~~~~~~~~~
  59. STARFLIC is distributed as a Self-Extract (SFX) executable file 
  60. (SFLIC.EXE).  This SFX contains the program, the documentation (as a 
  61. plain ASCII file), and sample TGA, FLI and FLC files. 
  62.  
  63. To install the program, simply copy the SFX into the desired directory 
  64. on your disk (hard disk recommended), then log into that directory, 
  65. type SFLIC and press ENTER.  The program will extract the files, 
  66. giving you a continuous status display.  When the extraction is 
  67. finished and you are presented with the DOS prompt, you are ready to 
  68. start the program.
  69.  
  70.  
  71. Using the program
  72. ~~~~~~~~~~~~~~~~~
  73. STARFLIC is started by typing the program name (FLMK), followed by a 
  74. file name and any desired options and pressing ENTER.
  75.  
  76. Usage:    STFL filename [options]     
  77.  
  78.  
  79.   filename    - The filename(s) on which STARFLIC is supposed to 
  80.                 operate, including the appropriate file extension.  
  81.                 Legal DOS file name wildcards are permitted (where 
  82.                 applicable).  Some of the options (see below) are 
  83.                 automatically inferred by the file extension 
  84.                 specified.   
  85.  
  86.                 (a) Example:   STFL  FILE?.TGA
  87.                   
  88.                   Based on the extension (TGA) the program assumes 
  89.                   you want to compile a set of TGA files 
  90.                   (FILE0.TGA,... FILE9.TGA), into a flick (FLI) 
  91.                   file.  Note that the TGA files will be processed 
  92.                   (compiled) in alphabetical order. 
  93.  
  94.  
  95.                 (b) Example:   STFL  FILE.FLI
  96.  
  97.                   Based on the extension (FLI) the program assumes 
  98.                   you want to play the animation (FLI) flic file, 
  99.                   named FILE.FLI.
  100.  
  101.  
  102.                 (C) Example:   STFL  FILE?.PCX
  103.  
  104.                   Based on the extension (PCX) the program assumes 
  105.                   you want to compile a set of PCX files (16-clolor PCX 
  106.                   files, only!), (FILE0.PCX,... FILE9.PCX), into a 
  107.                   flick (FLI) file.  The image size will be half the 
  108.                   original PCX size.  The 16 original colors may be 
  109.                   mapped onto more that 256 colors in the FLI file, by 
  110.                   intensity averaging.  Note that the PCX files will be 
  111.                   processed (compiled) in alphabetical order. 
  112.  
  113.                   **  It should be pointed out that although StarFlic 
  114.                       is capable of compiling and playing FLI/FLC files 
  115.                       of various sizes, other flick players are ONLY 
  116.                       capable of playing FLI files that are 320x200!  
  117.                       As a consequence, these other players might NOT 
  118.                       be able to play FLI files created by StarFlic, 
  119.                       using PCX files!
  120.  
  121.  
  122.   Available options
  123.   ~~~~~~~~~~~~~~~~~
  124.  
  125.   /D#         - Delay between frames (milliseconds) (Ex. /D50, /D100)
  126.                 May be specified when compiling or playing a file.
  127.  
  128.   /F#         - Anti-Alias & Scale Down by # using a 3x3 Bartlett 
  129.                 filter.  This option is used when compiling the FLI 
  130.                 file.
  131.                  
  132.   /G          - Use gray scale.  This option can be used both 
  133.                 when creating a flic file and when playing it.  
  134.                 
  135.                 (a) If /G is used when the  flic file is created,
  136.                     then the TGA colors are mapped onto a 0-63 gray scale 
  137.                     palette using the following formula:
  138.                 
  139.                     gray shade = (11*B + 59*R + 30*G)/100
  140.  
  141.                     where R,G,B  are the TGA file Red, Green and Blue 
  142.                     values, respectively (each 0-63).
  143.  
  144.                     Using /G when compiling the flic file tends to 
  145.                     provide better shade differentiation
  146.  
  147.                 (b) If /G is specified while playing the flic file, 
  148.                     then the FLI/FLC palette is mapped onto a 0-63 gray 
  149.                     scale.  This would not usually give you as 
  150.                     good quality gray scale, as (a), since you might be 
  151.                     trying to map a large number of colors in the 
  152.                     TGA file (thousands) onto 64 shades.
  153.  
  154.                 If not specified, a color palette is used (stored 
  155.                 in the FLI or FLC file). 
  156.  
  157.   /H#         - Pause execution of the flic file at frame number #, until 
  158.                 the user takes some action.  Note the frames, internally, 
  159.                 start with frame #1.
  160.  
  161.   /I#         - Adjust Intensity of Image (1-63).  This integer is 
  162.                 added to each color intensity stored in the file.
  163.  
  164.   /K          - Kill (erase) TGA files after the FLI flic file has 
  165.                 been compiled.  User is prompted to confirm deletion.
  166.  
  167.   /L            Loop the input TGA files when compiling a flic file. For 
  168.                 example, if files MYFILE1.TGA, MYFILE2.TGA, MYFILE3.TGA
  169.                 and MYFILE4.TGA are specified as the input, then the 
  170.                 Flic file will contain 6 frames in the sequence:  
  171.                 
  172.                      Frame #1  -  MYFILE1.TGA
  173.                      Frame #2  -  MYFILE2.TGA
  174.                      Frame #3  -  MYFILE3.TGA
  175.                      Frame #4  -  MYFILE4.TGA
  176.                      Frame #5  -  MYFILE3.TGA
  177.                      Frame #6  -  MYFILE2.TGA
  178.                   
  179.   /M          - Make a FLI animation using *.TGA input files.  This 
  180.                 command option may be omitted if the file extension is 
  181.                 specified in 'filename' above.  Useful when the files 
  182.                 processed do not have the TGA extension (Note that 
  183.                 they STILL have to be TGA format files!). 
  184.  
  185.   /N          - Display the frame number (lower left corner of the 
  186.                 screen) as a flic file is played.
  187.  
  188.   /O[ ... ]   - Name of output file.  Used with the /M or the /V 
  189.                 command options.  IF a name is not specified, 
  190.                 MOVIE.FLI is used as the output file.
  191.                                                    
  192.   /P          - Play flic file animation (*.FLI or *.FLC).  This 
  193.                 command option may be omitted if the file extension is 
  194.                 specified in 'filename' above.  Useful when the file 
  195.                 processed does not have the FLI or FLC extension (Note that 
  196.                 it STILL have to be an FLI or FLC format files!). 
  197.   
  198.   /R#         - Resolution option.  #  can be a value from 1 to 6
  199.                 
  200.                 1=320x200,  256 colors  Default (if R# is not specified)
  201.                 2=320x400,  256 colors
  202.                 3=640x350,   16 colors  (Standard EGA)
  203.                 4=640x480,  256 colors  (VESA mode $101)
  204.                 5=800x600,  256 colors  (VESA mode $103)
  205.                 6=1024x768, 256 colors  (VESA mode $105)
  206.  
  207.                 ** Note that modes 4,5, and 6 require a VESA driver, 
  208.                    or BIOS VESA support.  Check your Video adapter 
  209.                    user's manual to see if VESA modes are supported.
  210.           
  211.   /S          - Play frames once and stop.  If this command option is 
  212.                 not specified, the program will continuously play the 
  213.                 FLI or FLC file, until ESC is pressed.
  214.  
  215.   /V          - Create a flic file and immediately view it.  Useful for 
  216.                 viewing single TGA files.
  217.  
  218.              
  219.  
  220.                                                                                 
  221. While Viewing
  222. ~~~~~~~~~~~~~                
  223. The following keys are active while viewing a flic file:
  224.  
  225.    1..9   -    Delay between each frame
  226.  
  227.       0   -    Pause for single frame action (pressing 0 repeatedly, 
  228.                permits you to view a flic file a frame at a time). 
  229.  
  230.     PgDn  -    Decrease intensity of palette
  231.  
  232.     PgUp  -    Increase Intensity of palette
  233.  
  234.     ESC   -    Stop the animation and terminate the program.
  235.  
  236.                                                                                 
  237.  
  238. SFLIC.EXE contents
  239. ~~~~~~~~~~~~~~~~~~
  240. The SFLIC.EXE (SFX) compressed file should contain the following:
  241.  
  242.         STFL.EXE  -  The main executable Program 
  243.         STFL.DOC  -  This plain ASCII file 
  244.      LICENSE.DOC  -  Information regarding the License to 
  245.                      Evaluate/Use the program 
  246.        ORDER.DOC  -  Information on how to order this or other 
  247.                      TRIUS programs 
  248.       VENDOR.DOC  -  Information regarding distribution of the 
  249.                      shareware version of this program.
  250.        FR001.TGA  -  : ------
  251.        FR002.TGA  -  : Sample TGA and PCX files created with ProtoCAD 3D
  252.        FR003.TGA  -  : You can use these files to compile and play 
  253.        FR001.PCX  -  : your own simple FLI files using StarFlic
  254.        FR002.PCX  -  : .....
  255.        FR003.PCX  -  : ------
  256.        MOVIE.FLI  -  Sample flic file created using ProtoCAD 3D TGA images
  257.                      (15 frames, compiled with:  /F3 /L /D100 )
  258.        ARROW.FLI  -  A simple example of a Flic file (Public Domain)
  259.     INBASKET.FLI  -  A simple example of a Flic file (Public Domain) 
  260.       ANIMAL.FLI  -  A simple example of a Flic file (Public Domain) 
  261.  
  262. -------------------------------------------------------------------- End
  263.  
  264.  
  265.