summaryrefslogtreecommitdiff
path: root/TAO/orbsvcs/tests/AVStreams/mpeg/INSTALL.UCB
diff options
context:
space:
mode:
Diffstat (limited to 'TAO/orbsvcs/tests/AVStreams/mpeg/INSTALL.UCB')
-rw-r--r--TAO/orbsvcs/tests/AVStreams/mpeg/INSTALL.UCB105
1 files changed, 105 insertions, 0 deletions
diff --git a/TAO/orbsvcs/tests/AVStreams/mpeg/INSTALL.UCB b/TAO/orbsvcs/tests/AVStreams/mpeg/INSTALL.UCB
new file mode 100644
index 00000000000..38a656a538b
--- /dev/null
+++ b/TAO/orbsvcs/tests/AVStreams/mpeg/INSTALL.UCB
@@ -0,0 +1,105 @@
+These are the instructions for compiling mpeg_play, the software MPEG
+decoder and player.
+
+1) Untar the file mpeg_play.tar.Z. This is best done by creating a new
+directory for the files involved, moving the tar file into this directory
+and invoking the command:
+
+ zcat mpeg_play-2.0.tar.Z | tar xvf -
+
+2) Create and customize the Makefile. Do this by copying the file
+Makefile.proto to Makefile. Then edit Makefile for your particular needs.
+
+In the makefile the CFLAGS definition is multiply defined for a couple of
+different machines, uncomment the one you want to use, or define your own
+if necessary.
+
+The INCLUDEDIR variable should be set to include the paths leading to the
+standard header files such as stdio.h as well as to X11/Xlib.h (on most
+systems, this is /usr/include). To do this set the INCLUDEDIR variable to
+-I followed by the pathname. For example, if the path is /usr/local/include,
+edit the Makefile to look like this:
+
+ INCLUDEDIR = -I/usr/local/include
+
+If more than one pathname is necessary, simply prepend -I to each path.
+For example if you needed to include /usr/local/include and /usr/X11/include,
+the variable definition would look like:
+
+ INCLUDEDIR = -I/usr/local/include -I/usr/X11/include
+
+Finally, make sure the LIBS variable is set to the path and name of your X11
+library. For example:
+
+ LIBS = /usr/lib/X11/libX11.a
+
+3) Type make all.
+
+4) To remove .o files, type make clean
+
+5) Add yourself to the mailing list by sending mail to
+ mpeg-list-request@roger-rabbit.cs.berkeley.edu with the subject line
+ "ADD" (you can delete yourself by sending the subject line "DEL").
+ If you are a uunet user, you can use the mail path
+ 'uunet!ucbvax!roger-rabbit.cs!mpeg-list-request'
+
+ mail mpeg-list-request@roger-rabbit.cs.berkeley.edu
+ Subject: ADD
+ ^D
+
+6) Try it out! You can ftp some sample data files from the same site
+ you got this player from. Data files usually end in .mpg or .mpeg
+ The command line for the player is described in the man page, but
+ is basically:
+
+ mpeg_play [options] [file_name]
+
+7) If you want the player to collect statistics on size of frames,
+ macroblocks, time to decode, etc., add the following to the
+ definition of CFLAGS in the Makefile:
+ -DANALYSIS
+ Remove all .o files with "make clean" and remake with "make all"
+ The player will now print summarized statistics at the end of the
+ video clip and can be made to print frame by frame statistics with
+ the use of the -eachstat flag. Read man page for more info.
+------------------------------------------------------------------------
+
+Using Imake
+
+We have included an Imakefile for use with Imake. Since we do not use
+Imake ourselves and the file was provided by someone else, we can not
+give any specific instructions on how to use it. Please, consult
+someone more experienced with Imake.
+Thanks.
+
+------------------------------------------------------------------------
+NOTES
+
+It seems that much of the time is spent converting the 24 bit MPEG image
+to an 8 bit color space. This process is called "dithering". We've included
+several dithering algorithms. Read the man pages for more instructions.
+
+The data files available are produced by XING. These images are
+usually small (~160X120). XING data does not take advantage
+of P or B frames (ie, frames with motion compensation). The data is simply
+a series of I frames. Performance of the player on XING data is
+significantly lower (half or less) of the performance when motion compensated
+MPEG data is decoded.
+
+Reporting bugs:
+ If you find any bugs in this software, please send them to
+ mpeg-bugs@roger-rabbit.cs.berkeley.edu. Since this software
+ is unsupported, we make no guarantees about how long it will
+ take to fix the bug, or if it will be fixed at all. Bug fixes
+ will be cheerfully accepted. Please include as much detailed
+ information as possible, including:
+
+ 1) the version number of the program you are using (cf. VERSION)
+ 2) the data file that caused the bug (if possible)
+ 3) the OS version and machine type you ran the program on
+ 4) the compiler used to compile the program
+
+
+
+
+