home *** CD-ROM | disk | FTP | other *** search
/ Dream 44 / Amiga_Dream_44.iso / Linux / Apps / xanim.tgz / xanim / xanim27064 / cinepak.readme < prev    next >
Text File  |  1997-01-26  |  11KB  |  289 lines
  1.  
  2. FILE: cinepak.readme
  3. DATE: 16Oct96
  4. AUTH: Mark Podlipec
  5.  
  6.  
  7. /* Cinepak Decompression Module for XAnim
  8.  *
  9.  * Revision History
  10.  *----------------------
  11.  *  Rev 1.0 02Oct95  Podlipec (podlipec@BayNetworks.com)
  12.  *                   Initial release. For use with XAnim 2.70.1 or higher.
  13.  *  Rev 2.0 01Dec95  Podlipec (podlipec@BayNetworks.com)
  14.  *                   Permission from Radius to remove the TimeBomb.
  15.  */
  16.  
  17. -------------------------------------------------------------------------------
  18.               Copyright and Licensing Notice
  19.  
  20.   Cinepak (r) and the Cinepak logo are trademarks of Radius Inc and may be
  21.   registered in certain jurisdictions.  Copyright 1995 Radius Inc.  All rights
  22.   reserved.
  23.  
  24.   For more information on tools for creating Cinepak and other video content,
  25.   please contact Radius.
  26.  
  27.   Cinepak@radius.com
  28.   http://www.radius.com
  29.  
  30. ----
  31.  
  32.   The Cinepak Decompression Modules for Xanim are owned by Radius and 
  33.   are licensed to the user, not sold or given away.  
  34.  
  35.   These modules may not be distributed without this readme file. Or in
  36.   other words, any distribution of these modules must be accompanied
  37.   by this readme file.
  38.  
  39.                     !!!!!!!!IMPORTANT!!!!!!!!
  40.   The rev xa1.0_cvid* modules contain a Time Bomb that disables Cinepak
  41.   support after July 31st, 1996.  Radius has allowed me to remove this
  42.   Time Bomb from the xa2.0_cvid* modules.
  43.  
  44. -------------------------------------------------------------------------------
  45.  
  46.   XAnim is owned and copyrighted by Mark Podlipec.
  47.   Copyright (C) 1990,1991,1992,1993,1994,1995,1996 Mark Podlipec.
  48.   All rights reserved.
  49.  
  50.   podlipec@BayNetworks.com
  51.   http://xanim.va.pubnix.com/home.html
  52.   http://smurfland.cit.buffalo.edu/xanim/home.html
  53.   
  54. -------------------------------------------------------------------------------
  55.  
  56. NOTE: XAnim 2.70.1 OR GREATER IS REQUIRED FOR CINEPAK SUPPORT!!!
  57.  
  58. Cinepak support for XAnim is being provided as an optional machine
  59. specific object module that is linked into XAnim at compile time.
  60.  
  61. These modules will add AVI and Quicktime support for the following
  62. Video Codecs:
  63.  
  64.             + Radius Cinepak    (CVID)      depth 24. 
  65.             + Radius Cinepak    (CVID)      depth  8.
  66.  
  67.  
  68.  1) The first step is figuring out which XAnim Cinepak decompression
  69.     library module you need to obtain for your machine.
  70.  
  71.     Below is a table that matches your machine/OS to which library
  72.     you need to download(ok, they're really object files). 
  73.  
  74.       Machine/OS                        Library Name(LIB_NAME)  Size(bytes)
  75.     ------------                        ----------------------------------
  76.      Sun 3's(SunOS 4.x)            xa2.0_cvid_sun3.o     5411
  77.     cross-compiler provided to me
  78.     by Sebastien C. Roy (Sebastien.Roy@unh.edu)
  79.     ------------                        ----------------------------------
  80.      Sun Sparcs(SunOS 4.x)        xa2.0_cvid_sparcCOFF.o     7832
  81.      Sun Sparcs(SunOS 5.x)        xa2.0_cvid_sparcELF.o     8568
  82.      Sun Sparcs(Solaris X)        xa2.0_cvid_sparcELF.o     8568
  83.     ------------                        ----------------------------------
  84.      Sun Solaris x86             xa2.0_cvid_sol86.o     7308
  85.     cross-compiler provided to me 
  86.     by Daniel Rock (rock@wurzelausix.CS.Uni-SB.DE)
  87.     ------------                        ----------------------------------
  88.      HP 9000/7xx                  xa2.0_cvid_parisc.o     6716
  89.     ------------                        ----------------------------------
  90.      HP 68k                       xa2.0_cvid_hp68k.o     5503
  91.     cross-compiler provided to me 
  92.     by Stan Brown
  93.     ------------                        ----------------------------------
  94.      AIX Power PC            xa2.0_cvid_aix.o    10772
  95.     cross-compiler provided to me
  96.     by Kay Nettle
  97.     ------------                        ----------------------------------
  98.      DEC Alpha OSF/1(v3.x only)        xa2.0_cvid_alphaOSF1.o    14208
  99.                     Avoid Revs 27052-27053
  100.     ------------                        ----------------------------------
  101.      x86 Esix 4.03a            xa2.0_cvid_sol86.o     7308
  102.      x86 Unixware 2.1            xa2.0_cvid_sol86.o     7308
  103.     ------------                        ----------------------------------
  104.      x86 386/NetBSD            xa2.0_cvid_netbsd386.o     6563
  105.     cross-compiler provided to me 
  106.     by Roland C Dowdeswell(roland@imrryr.org)
  107.     ------------                        ----------------------------------
  108.      x86 BSDI 2                xa2.0_cvid_netbsd386.o     6563
  109.     ------------                        ----------------------------------
  110.      x86 FreeBSD            xa2.0_cvid_netbsd386.o   6563
  111.     ------------                        ----------------------------------
  112.      x86 Linux AOUT            xa2.0_cvid_linuxAOUT.o     6755
  113.      x86 Linux ELF            xa2.0_cvid_linuxELF.o     7584
  114.     both cross-compilers provided to me 
  115.     by Mark Nordberg(mark@catt.ncsu.edu) 
  116.     ------------                        ----------------------------------
  117.      PowerPC Linux            xa2.0_cvid_linuxPPC.o     8528
  118.     cross-compiler provided to me
  119.     by Tom Rini
  120.     ------------                        ----------------------------------
  121.      SGI Irix 5.x and 6.x               xa2.0_cvid_sgi.o        11688
  122.     cross-compiler provided to me
  123.     by Paul Close
  124.     ------------                        ----------------------------------
  125.      Pyramid Nile DC/OSx d087        xa2.0_cvid_sgi.o        11688
  126.     There are some warnings that you can ignore.
  127.     Might also work with MIS series DC/OSx c087.
  128.     ------------                        ----------------------------------
  129.  
  130.     yeah, I know it's a short list, but these are the only machines
  131.     that I have physical access to.
  132.  
  133.     NOTE: SunOS 4.1.3 uses AOUT and Sun Solaris used ELF. They're not
  134.     compatible.
  135.  
  136.     NOTE: If your machine is not supported, it's because I don't have physical
  137.     access to that type of machine. There are a handful of options
  138.     available to you(not all of them may be feasible)
  139.  
  140.     a) Ask Radius about supporting your machine type.
  141.  
  142.         b) Permanently loan me that type of machine so that I may
  143.            compile a library module for that machine type. Please
  144.            contact me first and yes, I'd be surprised if someone
  145.            chose this option. :^) 
  146.  
  147.         c) Send me a cross-compiler for your machine type. Must
  148.            be a Sparc SunOS 4.1.x executable or more specifically
  149.            it must run on my machine.  I'll do the compile and then
  150.            you'll need to verify that the resulting library module
  151.            works on your machine.
  152.  
  153.        Yes, I know gcc can be a cross-compiler. No, I don't currently
  154.        have the time to setup it up for all the various
  155.        platforms.
  156.            
  157.      Since I'm not allowed to distribute the source code I can't login
  158.      to an account on a remote machine in order to do the compile.
  159.  
  160.      Also, I personally can't give you a non-disclosure, because I
  161.      don't own the Cinepak code. You need to contact Radius about that.
  162.  
  163.  2) Obtaining the object files. Follow the steps below:
  164.  
  165.     EITHER
  166.  
  167.     1) Download the modules from one of the XAnim Web Pages
  168.  
  169.         http://xanim.va.pubnix.com/home.html
  170.         http://smurfland.cit.buffalo.edu/xanim/home.html
  171.  
  172.         OR
  173.  
  174.     1) cd into the XAnim directory on your machine
  175.     2) ftp xanim.va.pubnix.com     OR  ftp 199.170.0.28
  176.     3) user is "anonymous"
  177.     4) passwd is your email address
  178.     5) "type binary"            VERY IMPORTANT
  179.     6) "cd modules"
  180.     7) "get LIB_NAME.Z"            NOTE: the .Z at the end
  181.     8) "quit"
  182.  
  183.     NOTE: LIB_NAME is obtained from the table in section 1 based
  184.      on the type of machine and OS you are running. If you don't
  185.      know, contact your system administrator or a coworker who
  186.      does know. 
  187.  
  188.  3) "uncompress LIB_NAME.Z"
  189.  
  190.      This will create LIB_NAME from LIB_NAME.Z
  191.  
  192.  3a) NOTE: if you want to prevent "make clean" from removing this
  193.      file you should do the following:
  194.  
  195.      "chmod -w LIB_NAME"
  196.  
  197.      Do a "man chmod" for more info on this unix command.
  198.  
  199.  4) Edit Section III of either your Imakefile or Makefile(derived
  200.     from Makefile.unx).  If you are not sure which one to
  201.     use then read the compile.help that came with xanim.
  202.       
  203.     a) In Section III of either the Imakefile or Makefile
  204.  
  205.        Uncomment out the following define:
  206.  
  207.         XA_CVID_DEF = -DXA_CINEPAK
  208.  
  209.       and add LIB_NAME to the XA_CVID_LIB define. For example
  210.       if you have Sun Sparc running SunOS 4.1.3 then you would
  211.       use the following:
  212.  
  213.         XA_CVID_LIB = xa2.0_cvid_sparcCOFF.o
  214.  
  215.       For other machine/OS types, use the approriate xa2.0_cvid_*.o file
  216.       listed in the table at the top of this readme.
  217.  
  218.       NOTE:  There is no "-" or anything other prefix. Just the object
  219.              file name.
  220.  
  221.     b) If and ONLY if you are using the Imakefile(in other
  222.        words DON'T do this if you are using the Makefile(derived
  223.        from Makefile.unx)) then do the following:
  224.  
  225.       "xmkmf" 
  226.    
  227.     c) Now(regardless of which makefile)
  228.  
  229.       "touch xanim.h" 
  230.       "make xanim"
  231.  
  232.     NOTE: make sure you see -DXA_CINEPAK on the compile command lines
  233.     and make sure both xa_avi.c and xa_qt.c get recompiled.
  234.  
  235.     d) You should use "make xaclean" instead of "make clean" if you
  236.        want to preserve the decompression modules.
  237.    
  238.  5)  Have fun.
  239.  
  240. -------------------------------------------------------------------------
  241. NOTES on how XAnim options affect Cinepak on 8 bit Color displays/visuals.
  242.  
  243. None of these options matter on monochrome/TrueColor/DirectColor displays
  244. and visuals.
  245.  
  246.   With no options, XAnim will create a 256 entry RGB332 colormap
  247.   and dither to that. 
  248.  
  249.      xanim  free_fall.avi
  250.  
  251.   -F will turn off this dithering and XAnim will instead truncate
  252.   the 24bit RGB values down to the RGB332 colormap.(I see no real
  253.   advantage to this, which is why +F is on by default)
  254.  
  255.      xanim  -F free_fall.avi
  256.  
  257.   The +CF4 option will TURN OFF the dithering by default. +CF4 causes
  258.    XAnim to scan the animation ahead of time and the select the
  259.    "best" 256 colors from the possible thousands sampled. These colors
  260.    may be further reduced depending on how many colors are still 
  261.    available(ie not in use by other X11 applications).
  262.  
  263.      xanim +CF4 free_fall.avi
  264.  
  265.   If you specify +F AFTER the +CF4 option, dithering will be used
  266.   with the +CF4 option.
  267.  
  268.      xanim +CF4 +F free_fall.avi
  269.  
  270.  
  271.   The -Cn option may be used with all of the above examples. -Cn tells
  272.    XAnim to create it's own colormap, giving it FULL USE of those
  273.    256 colors. Please note that it is up to your X11 Window Manager(NOT
  274.    XAnim) to install this colormap based on which window the Color Focus
  275.    is on. Normally, Color Focus follows the mouse pointer, but not
  276.    always.
  277.  
  278.  
  279.       xanim -Cn free_fall.avi
  280.  
  281.       xanim -Cn +CF4 free_fall.avi
  282.  
  283.  
  284.  
  285. Mark Podlipec
  286. podlipec@BayNetworks.com
  287.  
  288.  
  289.