home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Graphics / movie / Movie.2.51.2.s.README < prev    next >
Encoding:
Text File  |  1995-01-10  |  7.5 KB  |  164 lines
  1.  
  2. 30-Dec-1994 Mike Carlton (carlton@isi.edu)
  3.  
  4. Made a few minor changes:
  5.     Added support for file extension ".mpeg" (in MovieView.m and 
  6.     ProjectBuilder attributes) to work more gracefully with OmniWeb
  7.  
  8.     Included the source to mpegDecode (obtained from the MPEGPlay
  9.     2.3 source by Brian Willoughby).  The MPEGPlay source is
  10.     available via anonymous ftp from
  11.         sonata.cc.purdue.edu:3.0/src/MPEGPlay2.3.tar.Z
  12.  
  13.     Recompiled triple fat ('cause I wanted an MPEG player on my HP)
  14.  
  15.     Bumped version number to 2.51.2
  16.  
  17. The original README follows.
  18. --------------------------------------------------------------------------------
  19.  
  20. Movie 2.51.1: Even more improved TIFF sequence animator 
  21.  
  22. Modifications by Andreas Windemuth
  23. Columbia University
  24. 630 West 168th St. BB-221
  25. New York, NY 10032
  26. windemut@cumbnd.bioc.columbia.edu
  27.  
  28. Using some code from MPEGPlay2.3 by
  29. Brian Willoughby        Software Design Engineer, BSEE NCSU
  30. BrianW@SoundS.WA.com    Sound Consulting: Software Design and Development
  31. NeXTmail welcome
  32.  
  33. Original code (mostly intact) by
  34. Patrick J. Flynn, School of EE&CS, Washington State University,
  35. Pullman, WA, USA 99164-2752.  Email: flynn@eecs.wsu.edu
  36.  
  37. Credit also belongs to anybody else who contributed to the code
  38. without my knowledge.
  39.  
  40. New features:
  41.     reads and plays mpeg encoded videos
  42.     displays frames, frame size and frame number while loading
  43.     memory saving play-from-disk mode (no speed control)
  44.     reenabled tiff-sequence input
  45.  
  46. New user interace elements:
  47.     Open has been replaced by Load and Play, where Load is just
  48.     like the old Open, and Play plays the movie directly from disk,
  49.     with minimum memory usage for arbitrarily large movies, but
  50.     no control panel, limited speed and no smoothing.
  51.  
  52.     An additional switch on the control panel for displaying the
  53.     frame number in the picture, without the overhead associated
  54.     with slider update.
  55.  
  56. This is a modified Movie (version 2.51), the original of which
  57. was written by Patrick J. Flynn and posted to the net quite some
  58. time ago. This improved version is capable of loading and
  59. displaying MPEG video files. The other application for
  60. doing that, MPEGPlayer by Brian Willoughby, does not
  61. use the window server efficiently and is much slower
  62. than Movie as a consequence. I stole the mpegDecode program
  63. and very little source code from that application to include in
  64. this version of Movie. Some sample MPEG movies are included,
  65. They are from the network, I don't remember where I got them.
  66.  
  67. Movie.app runs on black or white hardware, both in black&white
  68. or color. Longer movies take a lot of memory, the movies included
  69. as examples all run without swapping on my 40Mb ALR Evolution
  70. V/60 Pentium machine. Playback will only be smooth if all frames
  71. fit into memory. I have observed very high frame rates, up to more
  72. than 100fps, on both the Pentium color machine and black and white
  73. NeXTstations. This is depending on frame size, of course. 30fps is
  74. possible with all movies I have tried, if no zoom is used.
  75.  
  76. Movies can be played directly from disk, to allow for low memory
  77. and long movies. No frame rate control is available with that feature.
  78. If you don't have a Pentium or if the frame size is more than 20000
  79. pixels decoding is likely to be too slow for smooth playback.
  80.  
  81. If you want to see mpeg movies, you have to have the mpegDecode
  82. program. I don't have the source for that anymore, but it is freely
  83. available with the MPEGPlay software. Look for it on the archives.
  84. A fat executable is also included in the Movie-2.51.1 binary distribution.
  85.  
  86. The README files of the original Movie-2.51 and MPEGPlay2.6
  87. are reproduced below. Don't use this code for commercial purposes
  88. without asking the people who wrote it how much they want for their
  89. share.
  90.  
  91. Enjoy!
  92.  
  93. Andreas Windemuth
  94.  
  95. +--------------------------------------------------------------------
  96. |Columbia University, Department of Biochemistry and Biophysics
  97. |630 West 168th St. BB-221 | tel: (212)-305-6884, fax: 6926, NeXTmail
  98. |New York, NY 10032        | email: windemut@cumbnd.bioc.columbia.edu
  99. +--------------------------------------------------------------------
  100.  
  101.  
  102. Improvements from 2.5 to 2.51:
  103.  - fixed bug in IB.proj that kept preferences from working.
  104.  - fixed bug(s) in save: method (MovieView.m)
  105.  - made the text in the Help window selectable so users can copy the
  106.    tiff2anim shell script.
  107.  
  108. Movie is a TIFF sequence animator.
  109.  
  110. The widely-used standard file structure for a movie is a directory
  111.  
  112. NAME.anim
  113.  
  114. with contents
  115.  
  116. NAME.1.tiff, NAME.2.tiff, ...
  117.  
  118. Where NAME is the name of the movie.  The base name of the directory
  119. (less `.anim') must be the same as the bane names of the TIFF files.
  120. Each TIFF file should contain one TIFF image.  The TIFF files must be
  121. numbered consecutively starting from 1.  The program is smart enough
  122. to figure out how many frames there are.
  123.  
  124. I also recommend that all .anim directories contain a README file
  125. giving the origins of the movie, any special hints for viewing it, etc.
  126.  
  127. A sample movie (3aug-6prism.anim) has been included.  You should probably
  128. run it in bounce mode.
  129.  
  130. How to install Movie:
  131.  
  132. Copy it to ~/Apps or /LocalApps or wherever you would like.
  133.  
  134. Copyright: none.
  135.  
  136. Author: Patrick J. Flynn, School of EE&CS, Washington State University,
  137.         Pullman, WA, USA 99164-2752.  Email: flynn@eecs.wsu.edu
  138.  
  139.  
  140. |===============================================
  141.  
  142.  
  143. 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!
  144. ---
  145. Brian Willoughby        Software Design Engineer, BSEE NCSU
  146. BrianW@SoundS.WA.com    Sound Consulting: Software Design and Development
  147. NeXTmail welcome
  148.  
  149.  
  150. From the Info Panel:
  151.  
  152. 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.
  153.  
  154. Notes:
  155. 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
  156.  
  157. Original Version:
  158. 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.
  159.  
  160. Using MPEG Play:  
  161. 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.
  162.  
  163. Enjoy.
  164.