home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / viewer / MPEGCGFX.LHA / aMiPEG05 / docs / AMIGA next >
Encoding:
Text File  |  1996-01-24  |  7.1 KB  |  203 lines
  1.  
  2. aMiPEG - a MPEG video stream player for the Commodore Amiga
  3. -----------------------------------------------------------
  4. This is version 0.5 (24-Jan-96), ©1996 Michael Rausch & Miloslaw Smyk
  5. This version is based on aMiPEG 0.4 ©1994 Michael Rausch
  6.  
  7. The CyberGraphX support is based on the CyberGraphX software ©1995-96
  8. Vision Factory Development.
  9.  
  10. See the file COPYRIGHT for the copyrights accompanied with the sources
  11. this work is based upon.
  12.  
  13.  
  14.  
  15.  
  16. NOTE FROM Milek:
  17.  
  18.   The only difference between versions 0.4 and 0.5 is the addition of
  19.   CyberGraphX code done by me. I have contacted Michael and he allowed
  20.   me to release this version to Aminet, so here it goes. Documentation
  21.   is based on the one which comes with v0.4 with only small changes
  22.   applied.  I am not completely done with the testing, but so many people
  23.   asked me to release this version that I decided to do it anyway.
  24.  
  25.  
  26. INTRODUCTION
  27.  
  28.   aMiPEG is a player for MPEG video streams for the Commodore Amiga. It
  29.   is based upon the Berkeley X-Windows player version 2.0, with major
  30.   changes in speed and size.
  31.   Main advantages are much faster decoding of the streams compared with
  32.   other products based on the Berkeley sources, and a real-time scaling
  33.   to fit on a complete HAM screen (no thumbnail animations anymore!).
  34.   If you are using CyberGraphX software from Vision Factory Development
  35.   you can also play MPEG streams in resizeable, true color window on an
  36.   Intuition screen.
  37.  
  38.   In addition, aMiPEG comes with full source code supplied for the 
  39.   technical interested. Extensive technical information will be written
  40.   for the next release, if there's enough interest (on your and my side).
  41.  
  42.  
  43.   (Apparently there wasn't ;). Seriously, I doubt if Michael will write
  44.   these docs anytime soon, as he is now doing version of aMiPEG for Linux,
  45.   and, as I understand it, he has not much time for the Amiga. - Milek)
  46.  
  47.  
  48. DISCLAIMER
  49.  
  50.   This software is provided as-is, without warranty of any kind, either
  51.   expressed or implied. In no event will the authors be liable for direct,
  52.   indirect, incidental or consequential damages or data loss resulting 
  53.   from the use or application of this software. The entire risk as to the
  54.   results and performance of this software is assumed by the user.
  55.  
  56.  
  57. REQUIREMENTS
  58.  
  59.   AGA chipset is recommended, OS 2.04 or up required. With version 0.3,
  60.   rendering to a HAM6 screen is supported. From version 0.5 CyberGraphX is
  61.   supported. Versions optimized for 68020 and 68040 are provided.
  62.  
  63.   Implied with the usage of MPEG is some speedy processor as well. 68020
  64.   will do, but don't expect too much. "DebbieHarry.mpeg", which I use for
  65.   testing purposes, is played with 1.0 fps on my chipmem-only A1200 (PAL
  66.   screen), compared with 6.5 fps on the A4000/040 (Euro72 screen) and
  67.   3.1 fps on an A2000 with 28Mhz 2630 (PAL screen). On the A4000/040 with
  68.   CyberVision64 and CyberGraphX 2.15 it managed 7.1 fps on 24-bit screen
  69.   in color and 11.0 fps on the same screen in gray.
  70.   People with 68060s are asked to share information about performance on
  71.   their machines.  And while we are at the speed demons - does it work ok on
  72.   PowerUp boards?
  73.  
  74.   For recompilation, SAS/C and Devpac assembler is required. Other compilers
  75.   and/or assemblers may work with some fiddling.
  76.  
  77.  
  78. CYBERGRAPHICS
  79.  
  80.   You can choose true color output by specifing -dither cybergfx option on
  81.   the command line, or gray output on the "deep" screen using -dither
  82.   cybergfxgray.  ScreenMode requester will pop up and ask you for exact
  83.   screenmode, unless you specify -modeid followed by modeid number.  ModeID
  84.   used  for  display is always printed in the end of successful run, so you
  85.   know where to look for it.
  86.  
  87.   Window which appears on CyberGraphX screen can be resized using standard
  88.   gadget in the right-bottom corner. If you resize the window, output will
  89.   be slowed down, because player switches from WritePixelArray() to
  90.   ScalePixelArray(). If you want it to get back to the original size (and
  91.   speed) you can just double-click in the window and it will be done
  92.   automatically.
  93.  
  94.  
  95. BACKGROUND
  96.  
  97.   The main work with aMiPEG was done in about one week, mainly with modular
  98.   usage from within other productions in mind. In fact, it is thought to be
  99.   used in my next game for some background animation.
  100.   This implies that it is far from being perfect, but you are free to modify
  101.   and use the source, as long as you are so kind and report bugs and post
  102.   your improvements to me, if possible.
  103.  
  104.   CyberGraphX interface has been added in free time between the exams, so
  105.   it can contain bugs, too. Please report them and other suggestions for
  106.   improvements to Milek. Also, sMakefile was modified to suit my needs. The
  107.   original one is included as sMakefile.old
  108.  
  109.  
  110. ADDITIONAL INFORMATION
  111.  
  112.   An optimized JPEG codec is also available. Mail Michael if you are interested
  113.   in it and want it to be released like this one.
  114.  
  115.  
  116. LOOKING FOR
  117.  
  118.   Information on MPEG system streams or complete (CD-I) movies in general. If
  119.   you got any of those ... please contact Michael asap.
  120.  
  121.  
  122. CONTACT
  123.  
  124.   You can reach Michael via email at
  125.  
  126.     linux@uni-koblenz.de
  127.  
  128.   In fact, my account is rausch@uni-koblenz.de; but with this, I'm not allowed
  129.   to receive/send any mail from/to outside the campus.
  130.   Alternatively, you might try FidoNet
  131.  
  132.     2:245/5618.3
  133.  
  134.   or snail-mail:
  135.  
  136.     Michael Rausch
  137.     Schanzenpforte 33-35
  138.     D-56068 Koblenz
  139.  
  140.  
  141.  
  142.   Milek's email is
  143.  
  144.   smykm@felix.univ.szczecin.pl
  145.  
  146.   snail-mail:
  147.  
  148.   Miloslaw Smyk
  149.   ul. Orawska 22/34
  150.   70-131 Szczecin
  151.   POLAND
  152.  
  153.  
  154. HISTORY
  155.  
  156.   V0.1    * First public release
  157.     * Some cosmetic changes to be done.
  158.  
  159.   V0.2  * Oops, wrong ZIP code in the snail-mail address
  160.     * Bug with scaling of animations >200 pixel vertical is fixed.
  161.     * Little bit faster & tighter
  162.  
  163.   V0.3  * HAM6 rendering
  164.     * Somehow, the times got mixed up. NOW it renders to HAM8 with
  165.       6.5 fps (was 6.3) on the A4000/040 as the code is somewhat
  166.       streamlined and more parts are moved to assembler.
  167.     * Uses default public screen's mode ID now instead of default monitor's.
  168.  
  169.   V0.4  * Forgot the Multiscan monitor ID (several people mailed me about this;
  170.       really sorry guys)
  171.     * Autodetect non-AGA chipset, force HAM6 in this case
  172.     * Minor speed-up in the iDCT (in fact not worth mentioning)
  173.     * This is an intermediate release; 0.5 will contain the TODO stuff
  174.       listed down there.
  175.  
  176.   V0.5    by Miloslaw Smyk
  177.     * CyberGraphX support
  178.     * TODO stuff is still "to do"
  179.  
  180. BUGS
  181.  
  182.     * When dragging the screen on a Kick 2 machine, the copper stuff gets
  183.       messed up and it displays video in the vblank. No idea why, but who
  184.       cares anyway.
  185.     * Problems with large anims on a PAL screen; don't know why and don't
  186.       care either.
  187.     * Scaling under CyberGraphX 2.15 in 15-bit mode is broken and
  188.       displays trash. In CyberGraphX < 2.14 scaling might not work at all
  189.       (due to bugs), so upgrade now.
  190.  
  191. TODO    (sorted by priority)
  192.  
  193.     * playing in Window on Workbench or other user-selected "deep" screen.
  194.     * asynch I/O
  195.     * better (AmigaGuide?) documentation.
  196.     * 96 pixels or 80 pixels wide animations look awful.
  197.       New scaling modes are not ready yet.
  198.     * MPEG audio is on its way. The demo codec from DEC is running,
  199.       Tobias Bading's maplay is ported to Amiga and rewritten for integer
  200.       arithmetic ...
  201.  
  202.  
  203.