home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / DemoApps / Graphics / Viewers / Movie / Source / README < prev    next >
Encoding:
Text File  |  1994-06-08  |  6.9 KB  |  145 lines
  1. Movie 2.51.1: Even more improved TIFF sequence animator 
  2.  
  3. Modifications by Andreas Windemuth
  4. Columbia University
  5. 630 West 168th St. BB-221
  6. New York, NY 10032
  7. windemut@cumbnd.bioc.columbia.edu
  8.  
  9. Using some code from MPEGPlay2.3 by
  10. Brian Willoughby        Software Design Engineer, BSEE NCSU
  11. BrianW@SoundS.WA.com    Sound Consulting: Software Design and Development
  12. NeXTmail welcome
  13.  
  14. Original code (mostly intact) by
  15. Patrick J. Flynn, School of EE&CS, Washington State University,
  16. Pullman, WA, USA 99164-2752.  Email: flynn@eecs.wsu.edu
  17.  
  18. Credit also belongs to anybody else who contributed to the code
  19. without my knowledge.
  20.  
  21. New features:
  22.     reads and plays mpeg encoded videos
  23.     displays frames, frame size and frame number while loading
  24.     memory saving play-from-disk mode (no speed control)
  25.     reenabled tiff-sequence input
  26.  
  27. New user interace elements:
  28.     Open has been replaced by Load and Play, where Load is just
  29.     like the old Open, and Play plays the movie directly from disk,
  30.     with minimum memory usage for arbitrarily large movies, but
  31.     no control panel, limited speed and no smoothing.
  32.  
  33.     An additional switch on the control panel for displaying the
  34.     frame number in the picture, without the overhead associated
  35.     with slider update.
  36.  
  37. This is a modified Movie (version 2.51), the original of which
  38. was written by Patrick J. Flynn and posted to the net quite some
  39. time ago. This improved version is capable of loading and
  40. displaying MPEG video files. The other application for
  41. doing that, MPEGPlayer by Brian Willoughby, does not
  42. use the window server efficiently and is much slower
  43. than Movie as a consequence. I stole the mpegDecode program
  44. and very little source code from that application to include in
  45. this version of Movie. Some sample MPEG movies are included,
  46. They are from the network, I don't remember where I got them.
  47.  
  48. Movie.app runs on black or white hardware, both in black&white
  49. or color. Longer movies take a lot of memory, the movies included
  50. as examples all run without swapping on my 40Mb ALR Evolution
  51. V/60 Pentium machine. Playback will only be smooth if all frames
  52. fit into memory. I have observed very high frame rates, up to more
  53. than 100fps, on both the Pentium color machine and black and white
  54. NeXTstations. This is depending on frame size, of course. 30fps is
  55. possible with all movies I have tried, if no zoom is used.
  56.  
  57. Movies can be played directly from disk, to allow for low memory
  58. and long movies. No frame rate control is available with that feature.
  59. If you don't have a Pentium or if the frame size is more than 20000
  60. pixels decoding is likely to be too slow for smooth playback.
  61.  
  62. If you want to see mpeg movies, you have to have the mpegDecode
  63. program. I don't have the source for that anymore, but it is freely
  64. available with the MPEGPlay software. Look for it on the archives.
  65. A fat executable is also included in the Movie-2.51.1 binary distribution.
  66.  
  67. The README files of the original Movie-2.51 and MPEGPlay2.6
  68. are reproduced below. Don't use this code for commercial purposes
  69. without asking the people who wrote it how much they want for their
  70. share.
  71.  
  72. Enjoy!
  73.  
  74. Andreas Windemuth
  75.  
  76. +--------------------------------------------------------------------
  77. |Columbia University, Department of Biochemistry and Biophysics
  78. |630 West 168th St. BB-221 | tel: (212)-305-6884, fax: 6926, NeXTmail
  79. |New York, NY 10032        | email: windemut@cumbnd.bioc.columbia.edu
  80. +--------------------------------------------------------------------
  81.  
  82.  
  83. Improvements from 2.5 to 2.51:
  84.  - fixed bug in IB.proj that kept preferences from working.
  85.  - fixed bug(s) in save: method (MovieView.m)
  86.  - made the text in the Help window selectable so users can copy the
  87.    tiff2anim shell script.
  88.  
  89. Movie is a TIFF sequence animator.
  90.  
  91. The widely-used standard file structure for a movie is a directory
  92.  
  93. NAME.anim
  94.  
  95. with contents
  96.  
  97. NAME.1.tiff, NAME.2.tiff, ...
  98.  
  99. Where NAME is the name of the movie.  The base name of the directory
  100. (less `.anim') must be the same as the bane names of the TIFF files.
  101. Each TIFF file should contain one TIFF image.  The TIFF files must be
  102. numbered consecutively starting from 1.  The program is smart enough
  103. to figure out how many frames there are.
  104.  
  105. I also recommend that all .anim directories contain a README file
  106. giving the origins of the movie, any special hints for viewing it, etc.
  107.  
  108. A sample movie (3aug-6prism.anim) has been included.  You should probably
  109. run it in bounce mode.
  110.  
  111. How to install Movie:
  112.  
  113. Copy it to ~/Apps or /LocalApps or wherever you would like.
  114.  
  115. Copyright: none.
  116.  
  117. Author: Patrick J. Flynn, School of EE&CS, Washington State University,
  118.         Pullman, WA, USA 99164-2752.  Email: flynn@eecs.wsu.edu
  119.  
  120.  
  121. |===============================================
  122.  
  123.  
  124. This is a new release of MPEG_Play.  A FAT binary version has been requested by many, and is finally available now that I have 3.1 and limited access to an Intel machine running NS486 for test purposes.  Intel performance is not as good as Black hardware, but we all know who makes better machines!
  125. ---
  126. Brian Willoughby        Software Design Engineer, BSEE NCSU
  127. BrianW@SoundS.WA.com    Sound Consulting: Software Design and Development
  128. NeXTmail welcome
  129.  
  130.  
  131. From the Info Panel:
  132.  
  133. MPEG Play is in the process of evolving from a bare-bones MPEG animation viewer into a full-fledged NeXT application.  The current version is multi-threaded and supports the simultaneous loading and playback of multiple "mini-videos" at different rates as high as 28 frames per second.  There is a group of "live controls" which can be manipulated even while the video is playing.  MPEG Play will keep track of different settings for each window, reflecting the current values in the Window Settings panel whenever you select a new main window.  When playback is complete, a few interesting performance statistics are shown.
  134.  
  135. Notes:
  136. You may have to wait some time after opening a new file before it will be shown.  The frames will be counted as they are loaded.  This version is not recommended for NeXT systems without substantial system RAM and swap space.  I have not personally used this software on anything other than a NeXTdimension with 88 MB of RAM, but future versions of MPEG Play will be adjusted for any problems with other systems.  I have updated to version 2.0 of the mpeg_play code from Berkeley.  B&W support is temporarily disabled.  You can reach me as brianw@sounds.wa.com
  137.  
  138. Original Version:
  139. MPEG Play is a bare-bones MPEG animation viewer.  It's free, subject to the standard GNU copyright restrictions and those in the X-windows MPEG viewer software out of which I hacked the mpegDecoder code.  If you make any improvements, especially in speed and/or image quality, please share the code and drop me a note at  warozzi@3m.com.
  140.  
  141. Using MPEG Play:  
  142. Open an MPEG document using the menu item.  The filename must end in ".mpg" for the file to be recognized.  A window will appear and the animation will start after a few seconds.  Hit the Play Again menu item to restart at frame 1.  Use the Colorspace and Zoom radio buttons to set the window's attributes.
  143.  
  144. Enjoy.
  145.