home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / d / disneysanimationstudio.dms / disneysanimationstudio.adf / Tools / tanim.doc < prev   
Text File  |  1990-05-02  |  3KB  |  71 lines
  1.  
  2.                                 TAnim
  3.  
  4.     TAnim is a program that applies timing information to ANIM files.
  5. It does not add duplicate frames to the ANIM file, but rather uses an
  6. underused timing feature present in all ANIM files. Some ANIM player
  7. programs may not support this (documented) feature.
  8.  
  9.     The general format for invoking TAnim is:
  10.  
  11.     TAnim [-OI <timefile> | -Cn,tttt] <in.anim> [expo] [out.anim]
  12.  
  13.     Where:
  14.  
  15.     "in.anim" is the input ANIM file to be processed,
  16.     "out.anim" is the output ANIM file,
  17.     "expo" is an optional input Disney Animation Studio exposure sheet,
  18.     "timefile" is a file containing timing information.
  19.  
  20.     TAnim may only be invoked from the CLI.
  21.  
  22. Specific Examples:
  23.  
  24.     TAnim -O timefile in.anim
  25.  
  26.     This reads the file "in.anim" and outputs its timing information to
  27. the file "timefile."  If "timefile" is given as "-", the standard output is
  28. used.  The output format of the -O option is one line of text for each
  29. frame:  a frame number, followed by a comma, followed by the time the frame
  30. is to remain on screen in milliseconds.
  31.  
  32.     TAnim -I timefile in.anim out.anim
  33.  
  34.     Applies the timing information in "timefile" to "in.anim,"
  35. generating "out.anim."  The output file will contain the same number of
  36. frames as the input file.  If "timefile" is given as "-", the standard
  37. input is used.  The input format for "timefile" is identical to the output
  38. generated by the -O option.
  39.  
  40.     TAnim -Cn,tttt [-Cn,tttt ...] in.anim out.anim
  41.  
  42.     Applies the timing information given on the command line to
  43. "in.anim," generating "out.anim."  The output file will contain the same
  44. number of frames as the input file.  You may supply any number of -C
  45. options.  'n' is the frame number, 'tttt' is the time the frame is to
  46. remain on screen in milliseconds.
  47.  
  48.     TAnim in.anim expo out.anim
  49.  
  50.     Using the information in the Disney Animation Studio exposure sheet
  51. file, TAnim will take the images in the input ANIM file and generate a
  52. completely new output ANIM file, using the timing and frame rates specified
  53. in the exposure sheet.
  54.  
  55. Note:
  56.  
  57.     Due to a design limitation in the ANIM file format, the timing of
  58. frame number one cannot be changed, and will always report as zero
  59. milliseconds.
  60.  
  61.     When writing an ANIM file, TAnim will throw away all the IFF chunks
  62. it doesn't directly need.  The only chunks it considers necessary are BMHD,
  63. ANHD, CMAP, and CAMG;  everything else is discarded.
  64.  
  65.     TAnim only operates on op-5 anims.  The op-5 format includes .anim
  66. files created by most current animation programs.
  67.  
  68.     Some ANIM player programs may not support the use of the "reltime"
  69. feature present in ANIM files.  ShowANIM 5.30 by Gary Bonham is known to
  70. work correctly.
  71.