home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1998 June B / Pcwk6b98.iso / Mpeg3 / Dos / MP3 / MPG12304.EXE / README < prev    next >
Text File  |  1997-05-09  |  6KB  |  158 lines
  1.                            mpg123 0.58/dos beta 3 readme
  2.  
  3. This is a dos-port made by Tuomas Leikola, tobo@sci.fi.
  4. Beta testing phase, so don't panic if it won't work. It propably will.
  5. Some day.
  6. please, if you make any modifications of bugfixes, share it with me :)
  7.  
  8. New versions available every now and then at http://www.sci.fi/~tobo/mpg123
  9. ...
  10. currently supporting only sb16 compatibles. GUS will come.
  11.  
  12. ok the port code is messy, and many of the unix-related features
  13. I removed could be done. You're welcome to do so. I am not paid
  14. for doing this. I don't even care about the fame. I just needed something
  15. to play my MP3gs in dos. That is what is happening now.
  16.  
  17. SB support is a lame hack. I know that.
  18.  
  19. GUS support has a funny problem. the DMA never starts. anyone care to tell
  20. what could be the problem? (FYI: PIO is shit slow)
  21.  
  22. Buffering for the SB will come out some day. Or maybe not.
  23.  
  24. Hey i want something like this unix "diff" program.
  25.  
  26. Begin & end not handled properly.
  27.  
  28. Actually, a lot of things not handled properly.
  29.  
  30. No exit. (Ctrl-break)
  31.  
  32. About anything else, read on:
  33. Original mpg123 "readme":
  34. ------------8<-------------------8<---------------------8<------------------
  35.  
  36. **********************************************************************
  37. * MPEG 1.0 _AUDIO_ PLAYER, V0.58                                     * 
  38. * (full?) MPEG 1.0, Layer 1,2 and 3 support                          *
  39. * Layer-3 realtime only with a 'fast' machine (e.g Sparc10)          *
  40. * Since 29.3.96 128kbit j-stereo on an amd 5x86-P75 (133Mhz), too ;) *
  41. * Layer 1,2 stereo or Layer 3 with one channel seems to be           *
  42. * possible in realtime on a i486dx4-100                              *
  43. **********************************************************************
  44.  
  45. Please read first the important information in the COPYING file.
  46.  
  47. written/modfied by:
  48.    Michael Hipp (email: Michael.Hipp@student.uni-tuebingen.de)
  49.    Philipp Knirsch (email: phil@mpik-tueb.mpg.de)
  50.      -> still using an idea (the 'manual unroll') from Phil, though
  51.         his original code was replaced by a slightly faster code.
  52.  
  53. Uses code (or at least ideas) from:
  54.   MPEG Software Simulation Group (Base package)
  55.   Tobias Bading (subband synthesis)
  56.   Jeff Tsay (DCT36)
  57.   Philipp Knirsch (DCT36/manual unroll)
  58.   Thomas Woerner (SGI Audio)
  59.   Oliver Fromme <oliver.fromme@heim3.tu-clausthal.de> 
  60.     (several enhancements, man pages, Makefile, FreeBSD port,License )
  61.  
  62. current original distribution site is:
  63.   http://www.sfs.nphil.uni-tuebingen.de/~hipp/mpg123.html
  64.  
  65. here's Oliver Fromme's mpg123 page:
  66.   http://www.heim3.tu-clausthal.de/~olli/mpg123/
  67.   (includes information about the mpg123 mailing list)
  68.  
  69. V0.58 plays a layer3,112Kbit/s,J-Stereo stream on my AMD 5x86/133Mhz
  70. with about 73% CPU load.
  71. If your machine isn't fast enough you may try the downsampling
  72. feature (-2to1 and -4to1 options)
  73. Playing in 'singlemix' (stero reduced to mono) also saves some
  74. CPU cycles, though the whole code is optimized for 'full' stereo playing. 
  75.  
  76. 'Benchmarks': (+/- 2%)
  77. ----------------------
  78. (AMD 5x86/133MHZ,ASUS SP3G,256KB cache,DIRTY-TAG installed,(BusLogic SCSI))
  79. (Layer3, 112Kbit/s, J-Stereo stream)
  80. (Compiled with: -DI386_ASSEM -DREAL_IS_FLOAT -DLINUX -Wall -O2 -m486
  81.    -fomit-frame-pointer -funroll-all-loops -finline-functions -ffast-math)
  82.  
  83.   full quality:     (stero)     72%
  84.                     (singlemix) 42% (-> should work on 486DX66)
  85.   2:1 downsampling: (stereo)    59%
  86.                     (singlemix) 35% (-> should work on 486DX50)
  87.  
  88. ---------------------------------------------------------------------
  89. Description:
  90.  
  91. This isn't a new player. It's a near fully rewritten version based on the
  92. mpegaudio (FHG-version) package. The DCT algorithm in the
  93. synthesis filter is a rewritten version of the DCT first seen in the maplay
  94. package, which was written by Tobias Bading (bading@cs.tu-berlin.de). The 
  95. rewrite was neccassary, because the GPL may not allow this copyright mix.
  96. The mpegaudio package was written by various people from the MPEG/audio
  97. software simulation group. The maplay is under GPL .. You can find the
  98. original sourcecode and the mpegaudio package on: ftp.tnt.uni-hannover.de.
  99.  
  100. You will find code from the mpegaudio package in:
  101.    layer3.c
  102.    common.c
  103.    mpg123.h
  104.    mpg123.c
  105. I also often used the same variable names in the rewritten parts.
  106.  
  107. In the current layer3.c I'm using a DCT36 from Jeff Tsay's 
  108. (ctsay@pasteur.eecs.berkeley.edu) maplay 1.2+ package. His code is
  109. under GPL .. 
  110.  
  111. The output is always 'two channel interleaved'. If the input is a
  112. a mono-stream or single-channel is enabled, the player duplicates
  113. the channel. Currently, only (very simple) audiosupport for
  114. Linux,HP7xx,SGI and SunOS/Solaris,FreeBSD systems.
  115. I have tested the program with a lot of teststreams, but it's very 
  116. likely, that there are still a few bugs.
  117.  
  118. have fun,
  119.            Mike
  120.  
  121. ----------------------------------------------------------------------------
  122.  
  123. Just for info:
  124.     I'm also working on a DSP port for this package.
  125.     A first testversion of the layer-2 part is finished and seems
  126.     to work in realtime with my 20MHZ ADSP-2115 
  127.  
  128. ----------------------------------------------------------------------------
  129.  
  130. Copyrights (c) 1995,1996,1997 of all changes/modifications and
  131. of the new code by Michael Hipp. All rights reserved.
  132. See the packages 'maplay 1.2(+)' and 'mpegaudio' for their copy-policies.
  133.  
  134. known bugs:
  135.   layer 3 i-stereo not heavily tested
  136.    btw: I'm looking for i-stereo teststreams .. maybe you could send me a few
  137.   Layer 1 not heavily tested
  138.   no CRC checking ..
  139.   no 'free format streams'
  140.   no clean audio interface
  141.   no MPEG 2.0 support
  142.  
  143.  
  144. ******************************************************************************
  145. *
  146. * This is software with ABSOLUTELY NO WARRANTY.
  147. * Use it at your OWN RISK. It's possible to damage e.g. hardware or your hearing
  148. * due to a bug or for other reasons. 
  149. *
  150. * I do not warrant that the program is free of infringement of any third-party
  151. * patents.
  152. *
  153. ******************************************************************************
  154.  
  155. ----------8<----------------------8<-------------------8<----------------------
  156.  
  157.  
  158.