home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 20 / AACD20.BIN / AACD / Graphics / PerfectPaint / Tools / mkanim.man < prev    next >
Text File  |  1993-01-05  |  4KB  |  130 lines
  1.  
  2.  
  3.  
  4.     MKANIM 1.1                                                05.01.93
  5.  
  6.  
  7.  
  8.     ABOUT
  9.  
  10.     MKANIM is a program that packs ILBM picture files into an IFF ANIM
  11.     file, based on a list given in a control file. This is a KS2.0
  12.     program.
  13.  
  14.     MKANIM is Copyright © 1993 by John Bickers.
  15.  
  16.  
  17.     REQUIREMENTS
  18.  
  19.     KS2.0 and Christian Weber's iff.library are essential. The latter
  20.     is available from amiga.physik.unizh.ch and its mirrors, or from
  21.     Fish disk #674.
  22.  
  23.  
  24.     USAGE
  25.  
  26.     The usage template is:
  27.  
  28.     USING/A,TO/A,HAM/S,HALFBRITE/S,HIRES/S,LACE/S,CAMG/K,JIFFIES/K/N,
  29.     ANNO/K
  30.  
  31.     The USING option specifies the control file to build the animation
  32.     from. It is a normal text file, with one line per frame. The first
  33.     word on the line must be the jiffy value for the frame, while the
  34.     rest of the line must contain the filename for the picture that
  35.     represents the frame. For example, a control file could contain:
  36.  
  37.             3 j01.iff
  38.             3 j02.iff
  39.             3 j03.iff
  40.             3 j04.iff
  41.  
  42.     If you want the animation to loop seamlessly, you can do so by
  43.     repeating the first two lines at the end of the file. For example:
  44.  
  45.             3 j01.iff
  46.             3 j02.iff
  47.             3 j03.iff
  48.             3 j04.iff
  49.             # repeated to make the animation loop smoothly
  50.             3 j01.iff
  51.             3 j02.iff
  52.  
  53.     The use of the jiffy value is a little tricky. Some players treat
  54.     it as the delay before displaying the associated frame, while
  55.     other's treat it as the delay after displaying the frame. I
  56.     personally think the former action is the correct one. In the
  57.     latter case, it is impossible to insert a pause between frame 1
  58.     and frame 2, because the jiffy value for frame 1 is always
  59.     ignored.
  60.  
  61.     The TO option gives the name that you want the animation created
  62.     with.
  63.  
  64.     The HAM, HALFBRITE, HIRES and LACE options specify which if any of
  65.     these modes you want to use in the animation. The corresponding
  66.     bits will be saved in the CAMG chunk of the anim. If you use none
  67.     of these modes, and you also do not use the CAMG option, then the
  68.     animation will use the same mode as the first picture in the
  69.     control file.
  70.  
  71.     The CAMG option gives more direct control of the modes used by the
  72.     animation. The word CAMG must be followed by a hexidecimal number
  73.     representing the modes you want to use. For example, "CAMG 800" is
  74.     equivalent to "HAM". CAMG can also be used to force no modes at
  75.     all, with "CAMG 0".
  76.  
  77.     The JIFFIES option can be used to override the jiffy values in the
  78.     control file.
  79.  
  80.     Finally, the ANNO option lets you define what comment to place in
  81.     the animation file. If you do not use this option, then MKANIM
  82.     will write its own version string into the file. To prevent any
  83.     ANNO chunk being written, use an empty string, as in 'ANNO ""'.
  84.  
  85.  
  86.     CREDITS
  87.  
  88.     MKANIM is written by John Bickers using SAS C 6.1.
  89.  
  90.     Jim Kent's public domain code module "skip.c" from Fish disk #185
  91.     is used to do the compression of DLTA chunks.
  92.  
  93.     Christian A. Weber's iff.library is used for loading ILBM files.
  94.  
  95.     Dr. Gerald Hull's code module "apack.asm" from the NewIFF archive
  96.     is used for compressing rows of data.
  97.  
  98.  
  99.     DISTRIBUTION
  100.  
  101.     MKANIM is Copyright © 1993 by John Bickers.
  102.  
  103.     Distribution is via normal channels. That is, distribute it for
  104.     free, or for Fred Fish like costs, but not more. And remember to
  105.     include the documentation.
  106.  
  107.     This program is not shareware in the sense that you should pay for
  108.     it if you use it a lot, but suggestions or demands will be
  109.     received in a spirit of pronounced no-enthusiasm unless
  110.     accompanied by a donation of some sort.
  111.  
  112.     If you have one lying around, why not send me an R18 animation?
  113.  
  114.  
  115.     CONTACT INFO
  116.  
  117.     If you're having problems, I can be reached at:
  118.  
  119.         John Bickers
  120.         214 Rata St
  121.         Naenae 6301
  122.         New Zealand
  123.  
  124.     Or: jbickers@templar.actrix.gen.nz
  125.  
  126.  
  127.     DISCLAIMER
  128.  
  129.     It works on my machine.
  130.