home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / mpeg_encode-1.5 / INSTALL < prev    next >
Encoding:
Text File  |  1995-07-14  |  3.0 KB  |  59 lines
  1. This file describes how to install the Berkeley MPEG encoder.  Installation
  2. should be a quick and painless task.  Just do the following in order:
  3.  
  4.     1)  The encoder uses jpeg code.  You don't have to use this if you don't
  5.     want.  The jpeg code is only useful if you have images stored in JPEG
  6.     format.  And even if you do, you don't have to use it (you can use
  7.     the INPUT_CONVERT option); but it's faster and better if you do use it.
  8.     Here's what you do:  cd into the jpeg/ directory and type 'make' there.
  9.     That should create libjpeg.a.  That's it.  If you have problems
  10.     making it, or don't want to bother, you'll have to go into the Makefile
  11.     in THIS directory and change all the JPEG stuff.  Look for the comment
  12.     "JPEG STUFF" and make everythin there = nothing, except do this:
  13.         MP_JPEG_OBJS = nojpeg.o
  14.         MP_JPEG_SRCS = nojpeg.c
  15.  
  16.     2)  If your machine does not have UNIX sockets, then you cannot use
  17.     the parallel version of the encoder.  The default is to not
  18.     have a parallel version.  If you wish to run on several machines,
  19.     Edit the Makefile, changing MP_PARALLEL_OBJS and MP_PARALLEL_SRCS.
  20.     Instead of noparallel.c and noparallel.o, they should be parallel.c
  21.     and parallel.o.
  22.     
  23.     3)  We assume that right shift corresponds to signed division by 2 with
  24.     rounding towards minus infinity.  This is correct for typical "arithmetic
  25.     shift" instructions that shift in copies of the sign bit.  But some
  26.     C compilers implement >> with an unsigned shift.  For these machines you
  27.     must define RIGHT_SHIFT_IS_UNSIGNED.  To do so, add
  28.     -DRIGHT_SHIFT_IS_UNSIGNED to your CFLAGS line.
  29.  
  30.     4)  Edit the Makefile.  Set CC accordingly.  Set CFLAGS
  31.     accordingly.  Some sample CFLAGS lines for several different
  32.     compilers/machines are given in the Makefile.  If long's on your
  33.     machine are 32 bits but int's are NOT 32 bits, then you must include
  34.     the -DLONG_32 option in your CFLAGS line.  If your system does not
  35.     have the netinet/in.h header, then you must add either -DFORCE_BIG_ENDIAN
  36.     or -DFORCE_LITTLE_ENDIAN to the CFLAGS line (which you use depends on
  37.     your machine).
  38.  
  39.     5)  Set the LIBS lines appropriately.  For most machines you don't need
  40.     to change this.  However, for some machines you'll need to include
  41.     additional libraries to use sockets.
  42.  
  43.     6)  If you are using a NON-ANSI compiler, then your CFLAGS should
  44.     include -DNON_ANSI_COMPILER
  45.  
  46.     7)  Type 'make clean all'
  47.  
  48. If all is well, you should get the executable file 'mpeg_encode.'  To
  49. test it, try 'make test.'  At the end of the test, it should say SUCCESS
  50. or FAILURE.  If it says FAILURE, please let us know!
  51.  
  52. Note: if you get warnings about certain C library procedures not being
  53. defined before being called, that's not our fault.  Prototypes
  54. *should* exist in the appropriate system header files in /usr/include,
  55. but on some systems they don't.  None of this should affect the
  56. correctness of the program, but if you get tired of the warnings, you
  57. can probably stop them by setting PROTOFLAG = -DMISSING_PROTOTYPES in
  58. the Makefile.
  59.