home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / graphics / viewers / agmsfilm / agmsbreakfilm.doc < prev    next >
Text File  |  1993-01-05  |  4KB  |  97 lines
  1. AGMSBreakFilm breaks film files created by AGMSMakeFilm into separate IFF
  2. image files and sound files.  I wrote it after I lost the original files for
  3. one of my cartoons, you may find it useful for the same reasons :-).
  4.  
  5. Here are the command line parameters:
  6.  
  7.  
  8. From/A
  9.  
  10. The name of the film file to break up.  Required!  Contrary to the
  11. description the program, the film file isn't actually broken up.  It will be
  12. left intact.
  13.  
  14.  
  15. FileNamePrefix=Prefix=To/K
  16.  
  17. This string (enclose in double quotes if it has spaces) will be prepended to
  18. all output file names generated.  The default is "BF".  For example, if you
  19. want the output files to end up in DH1:Cartoons with a common file name of
  20. "Happy", you would use a prefix of "DH1:Cartoons/Happy".  The frame number
  21. or frame time will be appended to the prefix to generate the full file name.
  22. The sound files will have a file name made from <prefix><start>-<end>.<side>
  23. where <start> and <end> are frame numbers or time, and <side> is "left" or
  24. "right".
  25.  
  26. By the way, the output files will be standard IFF files with no
  27. embelishment.  No annotation chunks.  No channel indicators for sound (a
  28. separate monophonic file is used for left and right, with file names to show
  29. which channel it is).  Images and sound will be uncompressed.  If you want
  30. compressed files, load the images into your paint program and save them out.
  31.  
  32.  
  33. StartFrame=Start/K
  34.  
  35. The number of the first frame to break out of the film.  Frame numbers start
  36. at zero.  The default is 0.
  37.  
  38.  
  39. EndFrame=End/K
  40.  
  41. The number of the last frame you want to break out.  The default is
  42. 1,000,000,000.  If you don't specify a start or end then the whole film will
  43. be broken out.
  44.  
  45.  
  46. TimePostfix=Time/S
  47.  
  48. If you don't specify this switch (the default) then all your frames will be
  49. numbered with a 5 digit frame number.  For example: Happy00000, Happy00001,
  50. Happy00002 and so on.  Those numbers are useful for Deluxe Paint IV (by
  51. Electronic Arts) users since they can read in a sequence of image files to
  52. make an animation file.  Similarly you can do the opposite and use Deluxe
  53. Paint to convert an ANIM to a bunch of numbered files which you could then
  54. feed into AGMSMakeFilm.
  55.  
  56. If you do specify the TIME switch then the file names will be numbered with
  57. the time of the start of each frame, in seconds.  For example: Happy000.000,
  58. Happy000.100, Happy000.200 in the case of a film that runs at 10 frames per
  59. second.  Time numbering is useful if you are working with audio files and
  60. are trying to figure out the times where sound effects should go.
  61.  
  62. If you want to get fancy, you can save your film as image files with time
  63. names. Then remake the film with a large dummy image as the first one.
  64. AGMSMakeFilm will put the file name at the bottom of each frame, and because
  65. the film is being made with cells the size of the large dummy frame, the
  66. smaller images won't overwrite the file name at the bottom.  You can then
  67. easily move backwards and forwards in the film to find out the times for
  68. events that need sound effects.  Hmmm, maybe I should put in an option in
  69. AGMSMakeFilm to stamp the time at the bottom of each frame?  Well, if there
  70. is demand for it...
  71.  
  72.  
  73. Verbose/S
  74.  
  75. Used for debugging.  Displays various status messages, mostly just the frame
  76. number and time of the frame being written out.
  77.  
  78.  
  79. Control-C
  80.  
  81. Stops the program.
  82.  
  83.  
  84. Distribution
  85.  
  86. AGMSBreakFilm is FreeWare.  Copyright (c) 1993 by Alexander G. M. Smith.
  87. That means that you can use it freely, can't blame me for anything that goes
  88. wrong (there might be a few bugs because it is a fairly new and untried
  89. program), and you shouldn't expect more from it than you paid for it.
  90.  
  91.  
  92. Bugs
  93.  
  94. Let me know if you find any.  My E-mail addresses are in the program credits
  95. (use "?" as the command line argument and then a second "?" at the prompt to
  96. see the credits).
  97.