home *** CD-ROM | disk | FTP | other *** search
/ Dream 44 / Amiga_Dream_44.iso / Linux / Apps / xanim.tgz / xanim / xanim27064 / indeo.readme < prev    next >
Text File  |  1997-01-26  |  12KB  |  307 lines
  1.  
  2. FILE: indeo.readme
  3. DATE: 16Oct96
  4. AUTH: Mark Podlipec
  5.  
  6. /* Indeo Decompression Module for XAnim
  7.  *
  8.  * Revision History
  9.  *----------------------
  10.  *  Rev 0.0   Aug95  Podlipec (podlipec@BayNetworks.com)
  11.  *             ported/modified from Intel Indeo SDK.
  12.  *  Rev 1.0 06Nov95  Podlipec (podlipec@BayNetworks.com)
  13.  *                   Initial release. For use with XAnim 2.70.3 or higher.
  14.  *  Rev 2.0 09Feb96  Podlipec (podlipec@BayNetworks.com)
  15.  *                   Fixed bug that caused corruption with anims
  16.  *             of width less than a certain value.
  17.  *  Rev 2.2 01May96  Podlipec (podlipec@BayNetworks.com)
  18.  *                   On machines where  "long int" is 64 bits, I
  19.  *                   need to modify the Indeo code to use
  20.  *                   "int" and not "long int".
  21.  *                   This is known to affect some Alpha machines.
  22.  */
  23.  
  24. -------------------------------------------------------------------------------
  25.               Copyright and Licensing Notice
  26.  
  27.   Indeo (r) and the Indeo logo are trademarks of Intel Corporation.
  28.  
  29.   By Using this Software, you are agreeing to be bound by the terms of
  30.   this agreement. Do not use this software until you have carefully
  31.   read and agreed to the following terms and conditions. If you do
  32.   not agree to the terms of this agreement, then remove all copies.
  33.  
  34.   Restrictions:
  35.  
  36.   You MAY:
  37.       1: Freely use this Software in conjunction with XAnim.
  38.  
  39.   You MAY NOT:
  40.       1: Use this Software for any application other than XAnim.
  41.       2: Sell or distribute this Software without direct written
  42.          permission from the Author.
  43.       3: Sublicense this Software.
  44.       4: Reverse engineer, decompile, or disassemble this Software.
  45.  
  46.   WARRANTY: This Software is provided "AS IS". There are no warranties
  47.   of any kind either express or implied including warranties of
  48.   merchantability or fitness for any particular purpose.
  49.  
  50.   LIMITATION OF LIABILITY: Neither Intel nor the Author shall be liable
  51.   for any loss of profits, loss of use, loss of data, interruptions
  52.   of business, nor for indirect, special, incidental or consequential
  53.   damages of any kind whether under this agreement or otherwise, even
  54.   if advised of the possibility of such damages.
  55.   
  56.   EXPORT LAWS: You agree that this Software is not intended to be shipped
  57.   either directly or indirectly to country groups Q,S,W,Y,Z,Afghanistan
  58.   or the People's Republic of China, unless a validated export license
  59.   is obtained from the U.S. Department of Commerce.
  60.  
  61.   Definitions:
  62.      Software: XAnim Indeo decompression modules precompiled for various
  63.                machine platforms and OS. 
  64.      Author:   Mark Podlipec (podlipec@baynetworks.com)
  65.  
  66. -------------------------------------------------------------------------------
  67.  
  68.   XAnim is owned and copyrighted by Mark Podlipec.
  69.   Copyright (C) 1990,1991,1992,1993,1994,1995,1996 Mark Podlipec.
  70.   All rights reserved.
  71.  
  72.   podlipec@BayNetworks.com
  73.   http://xanim.va.pubnix.com/home.html
  74.   http://smurfland.cit.buffalo.edu/xanim/home.html
  75.  
  76. -------------------------------------------------------------------------------
  77.  
  78. NOTE: XAnim 2.70.3 OR GREATER IS REQUIRED FOR INDEO SUPPORT!!!
  79.  
  80. These modules will add AVI and Quicktime support for the following
  81. Video Codecs:
  82.  
  83.             + Intel Indeo R3.1  (IV31)      depth 24
  84.             + Intel Indeo R3.2  (IV32)      depth 24
  85.             + Intel RAW         (YVU9)      depth 24
  86.  
  87. Indeo support for XAnim is being provided as an optional machine
  88. specific object module that is linked into XAnim at compile time.
  89.  
  90.  1) The first step is figuring out which XAnim Indeo decompression
  91.     library module you need to obtain for your machine.
  92.  
  93.     Below is a table that matches your machine/OS to which library
  94.     you need to download(ok, they're really object files). 
  95.  
  96.       Machine/OS                        Library Name(LIB_NAME)  Size(bytes)
  97.     ------------                        ----------------------------------
  98.      Sun 3's(SunOS 4.x)            xa2.0_iv32_sun3.o    102298
  99.     cross-compiler provided to me
  100.     by Sebastien C. Roy (Sebastien.Roy@unh.edu)
  101.     ------------                        ----------------------------------
  102.      Sun Sparcs(SunOS 4.x)        xa2.0_iv32_sparcCOFF.o    112656
  103.      Sun Sparcs(SunOS 5.x)        xa2.0_iv32_sparcELF.o    113428
  104.      Sun Sparcs(Solaris X)        xa2.0_iv32_sparcELF.o    113428
  105.     ------------                        ----------------------------------
  106.      Sun Solaris x86                    xa2.0_iv32_sol86.o    107872
  107.          cross-compiler provided to me
  108.          by Daniel Rock (rock@wurzelausix.CS.Uni-SB.DE)
  109.     ------------                        ----------------------------------
  110.      HP 9000/7xx                    xa2.0_iv32_parisc.o    108872
  111.     ------------                        ----------------------------------
  112.      HP 68k                         xa2.0_iv32_68k.o    109632
  113.     cross-compiler provided to me
  114.     by Stan Brown
  115.     ------------                        ----------------------------------
  116.      DEC Alpha OSF/1            xa2.2_iv32_alphaOSF1.o    154872
  117.                     Avoid Revs 27052-27053
  118.     ------------                        ----------------------------------
  119.      x86 Esix 4.03a            xa2.0_iv32_sol86.o      107872
  120.      x86 Unixware 2.1            xa2.0_iv32_sol86.o      107872
  121.     ------------                        ----------------------------------
  122.      x86 386/NetBSD            xa2.0_iv32_netbsd386.o    108370
  123.          cross-compiler provided to me
  124.          by Roland C Dowdeswell(roland@imrryr.org)
  125.     ------------                        ----------------------------------
  126.      x86 BSDI 2                xa2.0_iv32_netbsd386.o    108370
  127.     ------------                        ----------------------------------
  128.      x86 FreeBSD 2.1.0            xa2.0_iv32_netbsd386.o    108370
  129.     ------------                        ----------------------------------
  130.      x86 Linux AOUT            xa2.0_iv32_linuxAOUT.o    108310
  131.      x86 Linux ELF            xa2.0_iv32_linuxELF.o    109152
  132.          both cross-compilers provided to me 
  133.          by Mark Nordberg(mark@catt.ncsu.edu) 
  134.     ------------                        ----------------------------------
  135.      PowerPC Linux             xa2.0_iv32_linuxPPC.o    124464
  136.     cross-compiler provided to me
  137.     by Tom Rini
  138.     ------------                        ----------------------------------
  139.      SGI Irix 5.x and 6.x        xa2.0_iv32_sgi.o    118388
  140.          cross-compiler provided to me 
  141.          by Paul Close
  142.     ------------                        ----------------------------------
  143.      Pyramid Nile DC/OSx d087        xa2.0_iv32_sgi.o    118388
  144.         There are some warnings that you can ignore.
  145.         Might also work with MIS series DC/OSx c087.
  146.     ------------                        ----------------------------------
  147.  
  148.  
  149.  
  150.     yeah, I know it's a short list, but these are the only machines
  151.     that I have physical access to or cross-compilers for.
  152.  
  153.     NOTE: SunOS 4.1.3 uses AOUT and Sun Solaris used ELF. They're not
  154.     compatible.
  155.  
  156.     NOTE: If your machine is not supported, it's because I don't have physical
  157.     access to that type of machine. There are a handful of options
  158.     available to you(not all of them may be feasible)
  159.  
  160.         a) Permanently loan me that type of machine so that I may
  161.            compile a library module for that machine type. Please
  162.            contact me first and yes, I'd be surprised if someone
  163.            chose this option. :^) 
  164.  
  165.         b) Send me a cross-compiler for your machine type. Must
  166.            be a Sparc SunOS 4.1.x executable or more specifically
  167.            it must run on my machine.  I'll do the compile and then
  168.            you'll need to verify that the resulting library module
  169.            works on your machine.
  170.  
  171.        Yes, I know gcc can be a cross-compiler. No, I don't currently
  172.        have the time to setup it up for all the various platforms.
  173.            
  174.      Since I'm not allowed to distribute the source code I can't login
  175.      to an account on a remote machine in order to do the compile.
  176.  
  177.      Also, I personally can't give you a non-disclosure. You need
  178.      to contact Intel about licensing Indeo(I believe the email address
  179.      is  "developer_support@intel.com", but I'm not sure).
  180.  
  181.  2) Obtaining the object files. Follow the steps below:
  182.  
  183.         EITHER
  184.  
  185.         1) Download the modules from one of the XAnim Web Pages
  186.  
  187.                 http://xanim.va.pubnix.com/home.html
  188.                 http://smurfland.cit.buffalo.edu/xanim/home.html
  189.  
  190.         OR
  191.  
  192.     1) cd into the XAnim directory on your machine
  193.     2) ftp xanim.va.pubnix.com     OR  ftp 199.170.0.28
  194.     3) user is "anonymous"
  195.     4) passwd is your email address
  196.     5) "type binary"            VERY IMPORTANT
  197.     6) "cd modules"
  198.     7) "get LIB_NAME.Z"            NOTE: the .Z at the end
  199.     8) "quit"
  200.  
  201.     NOTE: LIB_NAME is obtained from the table in section 1 based
  202.      on the type of machine and OS you are running. If you don't
  203.      know, contact your system administrator or a coworker who
  204.      does know. 
  205.  
  206.  3) "uncompress LIB_NAME.Z"
  207.  
  208.      This will create LIB_NAME from LIB_NAME.Z
  209.  
  210.  3a) NOTE: if you want to prevent "make clean" from removing this
  211.      file you should do the following:
  212.  
  213.      "chmod -w LIB_NAME"
  214.  
  215.      Do a "man chmod" for more info on this unix command.
  216.  
  217.  4) Edit Section III of either your Imakefile or Makefile(derived
  218.     from Makefile.unx).  If you are not sure which one to
  219.     use then read the compile.help that came with xanim.
  220.       
  221.     a) In Section III of either the Imakefile or Makefile
  222.  
  223.        Uncomment out the following define:
  224.  
  225.          XA_IV32_DEF = -DXA_INDEO
  226.  
  227.       and add LIB_NAME to the XA_IV32_LIB define. For example
  228.       if you have Sun Sparc running SunOS 4.1.3 then you would
  229.       use the following:
  230.  
  231.         XA_IV32_LIB = xa2.0_iv32_sparcCOFF.o
  232.  
  233.       For other machine/OS types, use the approriate xa_iv32_*.o file
  234.       listed in the table at the top of this readme.
  235.  
  236.       NOTE:  There is no "-" or anything other prefix. Just the object 
  237.              file name.
  238.  
  239.     b) If and ONLY if you are using the Imakefile(in other
  240.        words DON'T do this if you are using the Makefile(derived
  241.        from Makefile.unx)) then do the following:
  242.  
  243.       "xmkmf" 
  244.    
  245.     c) Now(regardless of which makefile)
  246.  
  247.       "touch xanim.h" 
  248.       "make xanim"
  249.  
  250.       NOTE: make sure you see -DXA_INDEO on the compile command lines
  251.       and make sure both xa_avi.c and xa_qt.c get recompiled.
  252.  
  253.     d) You should use "make xaclean" instead of "make clean" if you
  254.        want to preserve the decompression modules.
  255.    
  256.  5)  Have fun. :^)
  257.  
  258. -------------------------------------------------------------------------
  259. NOTES on how XAnim options affect Indeo on 8 bit Color displays/visuals.
  260.  
  261. None of these options matter on monochrome/TrueColor/DirectColor displays
  262. and visuals.
  263.  
  264.   With no options, XAnim will create a 256 entry RGB332 colormap
  265.   and dither to that. 
  266.  
  267.      xanim  free_fall.avi
  268.  
  269.   -F will turn off this dithering and XAnim will instead truncate
  270.   the 24bit RGB values down to the RGB332 colormap.(I see no real
  271.   advantage to this, which is why +F is on by default)
  272.  
  273.      xanim  -F free_fall.avi
  274.  
  275.   The +CF4 option will TURN OFF the dithering by default. +CF4 causes
  276.    XAnim to scan the animation ahead of time and the select the
  277.    "best" 256 colors from the possible thousands sampled. These colors
  278.    may be further reduced depending on how many colors are still 
  279.    available(ie not in use by other X11 applications).
  280.  
  281.      xanim +CF4 free_fall.avi
  282.  
  283.   If you specify +F AFTER the +CF4 option, dithering will be used
  284.   with the +CF4 option.
  285.  
  286.      xanim +CF4 +F free_fall.avi
  287.  
  288.  
  289.   The -Cn option may be used with all of the above examples. -Cn tells
  290.    XAnim to create it's own colormap, giving it FULL USE of those
  291.    256 colors. Please note that it is up to your X11 Window Manager(NOT
  292.    XAnim) to install this colormap based on which window the Color Focus
  293.    is on. Normally, Color Focus follows the mouse pointer, but not
  294.    always.
  295.  
  296.  
  297.       xanim -Cn free_fall.avi
  298.  
  299.       xanim -Cn +CF4 free_fall.avi
  300.  
  301.  
  302.  
  303. Mark Podlipec
  304. podlipec@BayNetworks.com
  305.  
  306.  
  307.