home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / dos / graphic / buildsv / buildsv.doc next >
Text File  |  1994-05-12  |  8KB  |  225 lines
  1.                BUILDSV (Dave's Self-Viewing Flic Builder)
  2.                          Rel 1.0.5 (05/13/94)
  3.                  Copyright (c) 1994, by David K. Mason
  4.  
  5.  
  6.   BUILDSV converts a Flic animation file (.FLI/.FLC/.FLX/.FLH/.FLT)
  7.   into an executable program by appending a copy of the flic to
  8.   special version of the DFV (Dave's Flic-Viewer) program.
  9.   You don't have to have DFV to get BUILDSV to work.
  10.  
  11.   It should be able to handle any 320x200 .FLI you throw at it.
  12.   If you've got a VESA-compliant SVGA or are running a VESA driver,
  13.   then the player will be able to display .FLC files with
  14.   dimensions up to and including 1024x768 (in 640x480, 800x600,
  15.   or 1024x768 mode).
  16.  
  17.   If you've got a VESA 1.2 hicolor SVGA, or a hicolor SVGA with
  18.   a VESA 1.2 driver, then it can also handle .FLX and .FLH files
  19.   up to 800x600 (in 640x480 or 800x600 mode).
  20.  
  21.   The player can handle .FLT files up to 640x480, only if you've
  22.   got a VESA 1.2 truecolor SVGA, or truecolor SVGA with a VESA 1.2
  23.   driver.
  24.  
  25.   The viewer runs in real-mode DOS but can access XMS memory
  26.   if you've got it.  If it can fit a whole flic into XMS memory
  27.   it will do so and play from memory.  If it's too big to
  28.   fit in XMS or if you specify the /NOXMS switch, then
  29.   it will read from disk as it plays.
  30.  
  31.   Neither BUILDSV nor the self-viewing flics that it builds require
  32.   any DOS-extender files.
  33.  
  34.  
  35. Syntax for BUILDSV
  36. ------------------
  37.  
  38.    BUILDSV flic-filename [exec-filename]
  39.  
  40.    If you don't specify an exec-filename, one will be selected for you.
  41.  
  42.    For example, if you've got a flic called BLOB.FLI, type:
  43.  
  44.      BUILDSV BLOB.FLI
  45.  
  46.    and BUILDSV will construct a program file called BLOB.EXE.
  47.    If you want to call it something else, type a second parameter
  48.    on the command line, like this:
  49.  
  50.      BUILDSV BLOB.FLI BLOBANIM.EXE
  51.  
  52.  
  53. Syntax for Self-viewing Flic
  54. ----------------------------
  55.  
  56.    flic-filename [/L#] [/S#] [/NOXMS]
  57.  
  58.    /L      Specify the number of times to play a flic
  59.            (default=forever)
  60.    /S      Force the flic to play at the specified speed (in 1/1000
  61.            second)
  62.    /NOXMS  Force the viewer to read from disk a frame at a time as
  63.            it plays instead of preloading the whole thing into XMS
  64.            memory.
  65.  
  66.    For example, if you used BUILDSV to create BLOB.EXE, you would
  67.    just type:
  68.  
  69.      BLOB
  70.  
  71.    to make it play.  If you wanted to make it play just once, slowly,
  72.    you could type, instead,
  73.  
  74.      BLOB /S100 /L1
  75.  
  76.    While playing BLOB.EXE, you can change the speed by pressing
  77.    the numbers on your keyboard.  0 causes it to play as fast
  78.    as it can.  1 sets the speed to 30 frames per second, 2 to
  79.    24fps.  The other numbers change the speed to assorted other
  80.    preset speeds.
  81.  
  82.    To exit an animation, just press the escape key.
  83.  
  84.  
  85. Shareware information
  86. ---------------------
  87.  
  88.  BUILDSV is a shareware programs.  If you continue to use it after a
  89.  one-month trial period, or if you distribute self-viewing flics
  90.  created with them, you're expected to pay a $35 registration fee
  91.  to the author:
  92.  
  93.    David K. Mason
  94.    P.O. Box 181015
  95.    Boston, MA  02118
  96.  
  97.  
  98. Miscellaneous advertisements
  99. ----------------------------
  100.  
  101.  Other shareware programs:
  102.  
  103.    o Dave's TGA Animator (DTA), a flexible graphics conversion image
  104.      processing, composition, and animation utility that runs from
  105.      the DOS command line.  Among other uses, it can convert your
  106.      still images to .FLI, .FLC, .FLH, and .FLT animation files
  107.      and back.
  108.  
  109.    o Dave's Morphing program (DMorf), the first shareware morphing
  110.      program for the PC.
  111.  
  112.    o Dave's Flic Viewer (DFV), a command-line flic animation viewer.
  113.      It can handle all of the varieties of flic files that DTA
  114.      can create, and also those from Autodesk Animator, Autodesk
  115.      Animator Pro, and Tempra Turbo Animator.
  116.  
  117.  If you've already registered any of these programs, no additional
  118.  registration fee is required for BUILDSV.
  119.  
  120.  Books:
  121.  
  122.    o Making Movies on Your PC, by David K. Mason and Alexander
  123.      Enzmann, Waite Group Press, 1993, ISBN 1-878739-41-7, $34.95 USA.
  124.      This book teaches you how to create 3d animation sequences
  125.      using the Polyray raytracer and DTA.
  126.  
  127.    o Morphing on Your PC, Waite Group Press, 1994, ISBN 1-878739-53-0,
  128.      $29.95 USA.  This book teaches you how to create cool morphing
  129.      animations using DMorf and DTA.
  130.  
  131.  
  132. Support
  133. -------
  134.  
  135.  If you've got any requests, bug reports, suggestions, or
  136.  comments, send a message to:
  137.  
  138.    "76546,1321" on Compuserve.
  139.  
  140.    From the Internet, that's "76546.1321@compuserve.com".
  141.  
  142.    "David Mason" on the "The Graphics Alternative", (510) 524-2780,
  143.    and on "Channel 1" BBS, (617) 354-8873.
  144.  
  145.    (I sometimes log on to the "You Can Call Me Ray" BBS,
  146.    (708) 358-5611, but not often these days because of
  147.    communications problems.)
  148.  
  149.  You'll probably get some kind of a response (maybe sooner, maybe later).
  150.  
  151.  You could also send paper mail to the address listed elsewhere in
  152.  this document, but I'm *terrible* at answering my mail.  I much
  153.  prefer electronic mail.
  154.  
  155.  
  156. The Rules
  157. ---------
  158.  
  159.   Feel free to re-upload this program to other bulletin boards or
  160.   online systems or to give copies to friends.  Just keep it in
  161.   its  *original, unmodified*  form.  Don't change the name of the
  162.   ZIP file.  It's supposed to be called BLDSV10.ZIP except on
  163.   Compuserve, where it's just called BLDSV.ZIP.
  164.  
  165.   Do not include this program on a floppy disk or CD along with
  166.   any magazine, book, hardware product, or other software product
  167.   without my permission.
  168.  
  169.   Do not include this program inside an archive along with any
  170.   shareware or freeware program unless you have my permission.
  171.  
  172.   The big exception: I claim no rights at all over any self-viewing
  173.   flics that you build with BUILDSV.  You retain all rights
  174.   to your own animations.  This does *not* mean, however, that
  175.   you suddenly gain any new rights over other people's animations
  176.   just because you converted them to self-viewing flics.
  177.  
  178.  
  179. Version History
  180. ---------------
  181.  
  182. Rel. 1.0.5 (05/13/94) -
  183.   If the player was running at midnight, the timer would get
  184.   confused and go into an endless loop.  Fixed.
  185.  
  186. Rel. 1.0.4 (05/06/94) -
  187.   The built-in viewer will now preload the whole flic into
  188.   XMS memory before it starts playing, if you've got enough
  189.   extended memory.  Otherwise, it'll play directly from
  190.   disk like it used to.
  191.     If you run BUILDSV against an .EXE flic that was created
  192.   with an earlier version of BUILDSV, it will update the
  193.   built-in viewer with the latest version.
  194.     The built-in viewer is now compressed with LZEXE... so
  195.   it'll add only 21K to the size of your flic, instead of
  196.   37k like 1.0.3 did.
  197.  
  198. Rel. 1.0.3 (04/20/94) -
  199.   Because I compiled using the wrong library file, BUILDSV
  200.   and its player would only run on machines with '386 or
  201.   higher processors.  Now it should play just fine on
  202.   '286s too.
  203.     BUILDSV's player choked on the sample flic that from
  204.   Kavik Software's SNDFLI sample.  It still won't play the
  205.   sound portion of the flic, but it now won't choke on it
  206.   either.
  207.     If BUILDSV ran out of disk space while writing a flic, it
  208.   would keep trying to write.  The result would be a corrupt
  209.   EXE file.  Now, it'll abort with an error and erase the
  210.   unfinished EXE.
  211.  
  212. Rel. 1.0.2 (04/06/94) -
  213.   Fixed a bug which caused the built-in flic player to be unable
  214.   to correctly identify the name of the .EXE file on some machines,
  215.   resulting in a "Runtime Error 002" message.
  216.  
  217. Rel. 1.0.1 (04/03/94) -
  218.   Fixed a bug which prevented the player from issuing some
  219.   error messages when it was unable to play an animation.
  220.   Fixed some bugs in .FLI-reading.
  221.  
  222. Rel. 1.0 (03/29/94) -
  223.   Initial release.
  224.  
  225.