home *** CD-ROM | disk | FTP | other *** search
/ Computerspiele Selbermachen / computerspieleselbermachen.iso / dta / dta.doc < prev    next >
Text File  |  1993-09-29  |  17KB  |  471 lines
  1.                    DTA (Dave's .TGA Animation Program)
  2.                           Rel 2.0.7 (09/30/93)
  3.                Copyright (c) 1991, 1992, 1993 by David K. Mason
  4.  
  5.   DTA is a command-line utility for creating Autodesk Animator .FLI
  6.   and .FLC animation files from:
  7.  
  8.   o .TGA files as created by the POV-Ray and POLYRAY ray-tracers.
  9.   o .IMG files as created by the Vivid ray-tracer.
  10.   o .PCX files.
  11.   o .GIF files.
  12.   o Other .FLI or .FLC files.
  13.   o Presidio .ANI animation files
  14.  
  15.   DTA can also perform a wide range of post-processing functions
  16.   on image files including:
  17.  
  18.   o Creating a single optimal 256-color palette from a series of
  19.     truecolor pictures, and then creating an Autodesk Animator .FLI
  20.     file out of them.
  21.   o Rescaling.
  22.   o Multi-layer compositing.
  23.   o Saving the palette as a .COL file, readable by either Autodesk
  24.     Animator or the TGAFLI animation utility.
  25.   o Saving the palette as a .MAP file, readable by the PICLAB and
  26.     IMPROCES image processors, and the FRACTINT fractal generator.
  27.   o Reading in a palette file in either .COL or .MAP format
  28.     and animating a bunch of pictures using that palette.
  29.   o Animating a bunch of pictures using grayscale.
  30.   o Convert pictures to .GIF, .TGA, and graycale .TIF files.
  31.   o Averaging images together for a variety of effects, including
  32.     simulated motion blur and red/blue 3D.
  33.   o And more.
  34. ----------------------------------------------------------------------
  35. **** IF YOU ARE HAVING MEMORY PROBLEMS WITH DTA, READ THIS ****
  36.  
  37. Real mode vs. Protected mode:
  38.  
  39.   DTA used to come in two varieties: a real mode version and
  40.   a protected mode version.  From now on there's only a
  41.   protected mode version.  There's no more DTAX.EXE.
  42.  
  43.   DTA will let you access up to 16MB of extended memory (either raw
  44.   or configured as XMS with HIMEM.SYS or QEMM386.SYS or whatever).
  45.   It requires at least 1 or 2 MB of RAM to run at all.
  46.  
  47.   Don't delete the files DPMI16BI.OVL, RTM.EXE, and DPMIINST.EXE.
  48.   These make up the protected mode drivers for Borland Pascal 7.0
  49.   (the compiler used to build DTA).  DTA won't run without them.
  50.  
  51. ----------------------------------------------------------------------
  52. The Rules:
  53.  
  54.   Feel free to re-upload this program to other bulletin board
  55.   systems in its *original, unmodified* form.  You may not
  56.   repackage it with other programs.  You may not repackage it with
  57.   your own tutorial.  I feel like an idiot having to make these
  58.   demands, but I've been finding archives on BBSs going by
  59.   names like MORPHPAK.ZIP which are collections of DTA, my other
  60.   program DMorf, sometimes also Richard Godoeken's program
  61.   RMORPH, plus Trilobyte's PLAY.  That's not kosher.  I and those
  62.   other folks distributed our programs the way we did for
  63.   reasons.
  64.     Do not include this program on a disk along with any magazine,
  65.   book, hardware product, or other software product without my
  66.   permission.
  67.  
  68. ----------------------------------------------------------------------
  69. Syntax:
  70.  
  71.   DTA (filenames) (switches)
  72.  
  73. ----------------------------------------------------------------------
  74. Input Formats:
  75.  
  76.   .TGA        Targa 16-,24-,32-bit compressed/uncompressed,
  77.               or 8-bit grayscale uncompressed.
  78.   .GIF        GIF (87a or 89a, but NO interlacing).
  79.   .PCX        PC Paintbrush 256-color or 24-bit PCX images.
  80.   .IMG        Vivid raytracer 24-bit RLE output.
  81.   .FLI and
  82.   .FLC        Autodesk Animator/Animator Pro animation files.
  83.   .ANI        Presidio PC Animate Plus animation files.
  84.  
  85.   .LZH        LHArc compressed archive containing files in the above
  86.               picture formats.
  87.   .ZIP        PKZIP compressed archive containing files in the above
  88.               picture formats.
  89.   .ARJ        ARJ compressed archive containing files in the above
  90.               picture formats.
  91.  
  92.   @afile      Process all files listed in a text file "afile".
  93.  
  94. ----------------------------------------------------------------------
  95. Switches:
  96.  
  97. (Output options)
  98.  
  99.   /O[name]    Specify an output filename.
  100.  
  101.   /FF         Create a .FLI animation file. [default]
  102.   /FM         Create a PICLAB .MAP palette file.
  103.   /FC         Create an Autodesk Animator .COL palette file.
  104.   /FG         Create .GIF file[s].
  105.   /FT         Create new .TGA file[s].
  106.   /FI         Create grayscale TIFF files
  107.  
  108. (Targa Output options)
  109.  
  110.   /NC         Do NOT compress .TGA file
  111.   /B##        Number of bits per pixel in TGA ( 8/16/*24*/32 )
  112.               or FLIC (*8/16).  (If you specify /b16 for a flic
  113.               you'll get a Tempra FLX instead of a FLI or FLC.)
  114.  
  115. (.FLI output options)
  116.  
  117.   /P           Play in ping-pong, or pendulum, oscillation order.
  118.   /Snnn        Specify display speed of animation playback (default=0).
  119.   /R[#]        Specify resolution:
  120.                  1 = 320x200 [default]
  121.                  2 = 320x240
  122.                  3 = 320x400
  123.                  4 = 320x480
  124.                  5 = 360x480
  125.                  6 = 640x480
  126.                  7 = N/A
  127.                  8 = 800X600
  128.                  9 = N/A
  129.                 10 = 1024x768
  130.                 11 = N/A
  131.                 12 = 1280x1024
  132.   /RA          Base resolution on the size of the first input
  133.                file.
  134.  
  135. (Palette options)
  136.   /G           Use 64-level greyscale instead of a palette.
  137.   /G32         Use 32-level greyscale insted of a palette.
  138.   /332         Use 3/3/2 palette.
  139.   /Upalname    Use existing .MAP or .COL file for palette.
  140.   /M#          Set maximum internal colors.
  141.   /MN          Do NOT remap colormapped input.
  142.   /PO          Force single optimal palette generation even when
  143.                creating GIF files.
  144.   /C#          Scan only one frame per # for palette.
  145.  
  146. (Dithering options)
  147.   /DF          Dither with Floyd-Steinberg filter.
  148.   /DS          Dither with Sierra-Lite filter.
  149.   /DO[1-6]     Ordered dither  (digit represents dither strength).
  150.   /DR#         Random noise dither (digit represents dither strength).
  151.  
  152. (Other options)
  153.   /L           Separates output layers.  Picture files specified
  154.                in later layers get overlayed on top of previous
  155.                layers.  If the overlayed pictures contain transparency
  156.                informations (32-bit TGA files only), then the
  157.                pictures underneath will show through.
  158.   /K#          Use only one frame per # picture files.  Skip the rest.
  159.   /3D          Create red/blue 3D picture.
  160.   /A[#|A]      Average <number> TGAs per output frame (A=All).
  161.   /T[#|A]      Trail   <number> TGAs per output frame (A=All).
  162.   /X[num]      eXpand <number>. Create and insert <number> averaged.
  163.                frames between each pair of regular frames.
  164.   /GA#         Gamma-correct picture.  Try specifying a number
  165.                between 1.0 and 2.0 to brighten, between 0.5 and
  166.                1.0 to darken.
  167.   /SC[#,#]     Rescale pictures to screen resolution.
  168.   /CL[#,#,#,#] Clip the input picture.  The first two numbers
  169.                specify the top-left, and the other two numbers
  170.                control the width and depth.
  171.   /CH#,#,#     Chroma-key, to make all occurrences of a color
  172.                transparent for compositing.  The three numbers
  173.                represent the red,green, and blue components
  174.                of the key color.
  175.   /CT#         Chroma-key tolerance.  Specifies how close to the
  176.                key color a pixel has to be to make it transparent.
  177.  
  178. ----------------------------------------------------------------------
  179. Revision History:
  180.  
  181.   (see WHATSNEW.DTA)
  182.  
  183. ----------------------------------------------------------------------
  184. Averaging/Trailing/Expansion modes (/A /T /X switches) examples:
  185.  
  186.   Averaging 5 input pictures with "/A2" option:
  187.  
  188.     Average:    To produce:
  189.  
  190.     file 1      frame 1
  191.     file 2
  192.  
  193.     file 3      frame 2
  194.     file 4
  195.  
  196.     file 5      frame 3
  197.     file 1
  198.  
  199.   Trailing 4 input pictures with "/T2" option:
  200.  
  201.     Average:    To produce:
  202.  
  203.     file 1      frame 1
  204.     file 2
  205.  
  206.     file 2      frame 2
  207.     file 3
  208.  
  209.     file 3      frame 3
  210.     file 4
  211.  
  212.     file 4     frame 4
  213.     fi