home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 25 / CD_ASCQ_25_1095.iso / dos / graphic / dta22b19 / buildsv.doc < prev    next >
Text File  |  1995-06-14  |  9KB  |  261 lines
  1.                BUILDSV (Dave's Self-Viewing Flic Builder)
  2.                         Rel 1.2 beta (06/14/95)
  3.               Copyright (c) 1994, 1995, 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 special
  8.   version of the DFV (Dave's Flic-Viewer) program.  You don't have to
  9.   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] [/G]
  57.  
  58.    /Q      Quiet (no display copyright notice before playing).
  59.    /L#     Specify the number of times to play a flic
  60.            (default=forever).
  61.    /S#     Force the flic to play at the specified speed (in 1/1000
  62.            second).
  63.    /G      Remain in graphics mode afterward.
  64.    /SF#    Force the first frame to display for a minumum of # ms.
  65.    /SL#    Force the last frame to display for a minumum of # ms.
  66.    /NOXMS  Force the viewer to read from disk a frame at a time as
  67.            it plays instead of preloading the whole thing into XMS
  68.            memory.
  69.  
  70.    For example, if you used BUILDSV to create BLOB.EXE, you would
  71.    just type:
  72.  
  73.      BLOB
  74.  
  75.    to make it play.  If you wanted to make it play just once, slowly,
  76.    you could type, instead,
  77.  
  78.      BLOB /S100 /L1
  79.  
  80.    While playing BLOB.EXE, you can change the speed by pressing
  81.    the numbers on your keyboard.  0 causes it to play as fast
  82.    as it can.  1 sets the speed to 30 frames per second, 2 to
  83.    24fps.  The other numbers change the speed to assorted other
  84.    preset speeds.
  85.  
  86.    To exit an animation, just press the escape key.
  87.  
  88.  
  89. Shareware information
  90. ---------------------
  91.  
  92.  BUILDSV is a shareware programs.  If you continue to use it after a
  93.  one-month trial period, or if you distribute self-viewing flics
  94.  created with them, you're expected to pay a $35 registration fee
  95.  to the author:
  96.  
  97.    David K. Mason
  98.    P.O. Box 181015
  99.    Boston, MA  02118
  100.  
  101.  
  102. Miscellaneous advertisements
  103. ----------------------------
  104.  
  105.  Other shareware programs:
  106.  
  107.    o Dave's TGA Animator (DTA), a flexible graphics conversion image
  108.      processing, composition, and animation utility that runs from
  109.      the DOS command line.  Among other uses, it can convert your
  110.      still images to .FLI, .FLC, .FLH, and .FLT animation files
  111.      and back.
  112.  
  113.    o Dave's Morphing program (DMorf), the first shareware morphing
  114.      program for the PC.
  115.  
  116.    o Dave's Flic Viewer (DFV), a command-line flic animation viewer.
  117.      It can handle all of the varieties of flic files that DTA
  118.      can create, and also those from Autodesk Animator, Autodesk
  119.      Animator Pro, and Tempra Turbo Animator.
  120.  
  121.  If you've already registered any of these programs, no additional
  122.  registration fee is required for BUILDSV.
  123.  
  124.  Books:
  125.  
  126.    o Making Movies on Your PC, by David K. Mason and Alexander
  127.      Enzmann, Waite Group Press, 1993, ISBN 1-878739-41-7, $34.95 USA.
  128.      This book teaches you how to create 3d animation sequences
  129.      using the Polyray raytracer and DTA.
  130.  
  131.    o Morphing on Your PC, Waite Group Press, 1994, ISBN 1-878739-53-0,
  132.      $29.95 USA.  This book teaches you how to create cool morphing
  133.      animations using DMorf and DTA.
  134.  
  135.  
  136. Support
  137. -------
  138.  
  139.  If you've got any requests, bug reports, suggestions, or
  140.  comments, send a message to:
  141.  
  142.    "76546,1321" on Compuserve.
  143.  
  144.    From the Internet, that's "76546.1321@compuserve.com".
  145.  
  146.    "David Mason" on the "The Graphics Alternative", (510) 524-2780,
  147.    and on "Channel 1" BBS, (617) 354-8873.
  148.  
  149.    (I sometimes log on to the "You Can Call Me Ray" BBS,
  150.    (708) 358-5611, but not often these days because of
  151.    communications problems.)
  152.  
  153.  You'll probably get some kind of a response (maybe sooner, maybe later).
  154.  
  155.  You could also send paper mail to the address listed elsewhere in
  156.  this document, but I'm *terrible* at answering my mail.  I much
  157.  prefer electronic mail.
  158.  
  159.  
  160. The Rules
  161. ---------
  162.  
  163.   Feel free to re-upload this program to other bulletin boards or
  164.   online systems or to give copies to friends.  Just keep it in
  165.   its  *original, unmodified*  form.  Don't change the name of the
  166.   ZIP file.  It's supposed to be called BLDSV10.ZIP except on
  167.   Compuserve, where it's just called BLDSV.ZIP.
  168.  
  169.   Do not include this program on a floppy disk or CD along with
  170.   any magazine, book, hardware product, or other software product
  171.   without my permission.
  172.  
  173.   Do not include this program inside an archive along with any
  174.   shareware or freeware program unless you have my permission.
  175.  
  176.   The big exception: I claim no rights at all over any self-viewing
  177.   flics that you build with BUILDSV.  You retain all rights
  178.   to your own animations.  This does *not* mean, however, that
  179.   you suddenly gain any new rights over other people's animations
  180.   just because you converted them to self-viewing flics.
  181.  
  182.  
  183. Version History
  184. ---------------
  185.  
  186. Rel. 1.2 (06/14/95)
  187.   Fixed some timing problems.
  188.   Fixed problems with truecolor modes with some video cards
  189.   (including Diamond Stealth 64 and some from #9).
  190.   Previously the player would only stop if you pressed the
  191.   escape key.  Now it also recognizes the spacebar and Enter.
  192.  
  193. Rel. 1.1.3 (12/31/94) -
  194.   Removed GIF support because of Compuserve/Unisys's
  195.   new licensing plan.
  196.     Added /G (stay in graphics mode) switch to the viewer.
  197.     Skipped some release numbers to synch with DFV's release
  198.   number.
  199.  
  200. Rel. 1.0.7 (06/06/94) -
  201.   BUILDSV now supports GIF files in addition to flics.
  202.   Fixed a bug that prevented the player from reading some
  203.   unusual FLC files correctly.
  204.     If you set the speed value in the header of a flic to
  205.   44444, then the player will wait until the user hits the
  206.   spacebar before advancing to the next frame instead of
  207.   waiting on a timer.  (useful for slideshows, not
  208.   animations.)  Thanks to Thomas Webber for this idea.
  209.     If you set the speed value to 55555 then the player
  210.   will wait for a spacebar (as with 44444) and also it
  211.   will only play the flic once, just as if the user had
  212.   specified the /L1 switch.
  213.  
  214. Rel. 1.0.6 (05/16/94) -
  215.   BUILDSV refused to recognize FLH and FLT files as flics.
  216.   Fixed.
  217.  
  218. Rel. 1.0.5 (05/13/94) -
  219.   If the player was running at midnight, the timer would get
  220.   confused and go into an endless loop.  Fixed.
  221.  
  222. Rel. 1.0.4 (05/06/94) -
  223.   The built-in viewer will now preload the whole flic into
  224.   XMS memory before it starts playing, if you've got enough
  225.   extended memory.  Otherwise, it'll play directly from
  226.   disk like it used to.
  227.     If you run BUILDSV against an .EXE flic that was created
  228.   with an earlier version of BUILDSV, it will update the
  229.   built-in viewer with the latest version.
  230.     The built-in viewer is now compressed with LZEXE... so
  231.   it'll add only 21K to the size of your flic, instead of
  232.   37k like 1.0.3 did.
  233.  
  234. Rel. 1.0.3 (04/20/94) -
  235.   Because I compiled using the wrong library file, BUILDSV
  236.   and its player would only run on machines with '386 or
  237.   higher processors.  Now it should play just fine on
  238.   '286s too.
  239.     BUILDSV's player choked on the sample flic that from
  240.   Kavik Software's SNDFLI sample.  It still won't play the
  241.   sound portion of the flic, but it now won't choke on it
  242.   either.
  243.     If BUILDSV ran out of disk space while writing a flic, it
  244.   would keep trying to write.  The result would be a corrupt
  245.   EXE file.  Now, it'll abort with an error and erase the
  246.   unfinished EXE.
  247.  
  248. Rel. 1.0.2 (04/06/94) -
  249.   Fixed a bug which caused the built-in flic player to be unable
  250.   to correctly identify the name of the .EXE file on some machines,
  251.   resulting in a "Runtime Error 002" message.
  252.  
  253. Rel. 1.0.1 (04/03/94) -
  254.   Fixed a bug which prevented the player from issuing some
  255.   error messages when it was unable to play an animation.
  256.   Fixed some bugs in .FLI-reading.
  257.  
  258. Rel. 1.0 (03/29/94) -
  259.   Initial release.
  260.  
  261.