home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser-CD 2000 January / LCD_01_2000.iso / anwend / falcamp / fampdoc.txt < prev   
Text File  |  1999-12-10  |  8KB  |  195 lines
  1.                             *********************
  2.                             *   FalcAMP v0.80ß  *
  3.                             *********************
  4.  
  5.            Audio MPEG Layer 3 player for Atari Falcon 030 computers
  6.              By Denis "STGhost" HUGUET and David "Splash" CARRERE
  7.                                  -----------
  8.                                  ╜Sector One
  9.                                   1998-1999
  10.  
  11.  
  12.   Sector One is proud to present the first beta release of an MP3 player
  13. for Falcon 030 computers.
  14.  
  15.  
  16. I/ What is MP3 ?
  17. ----------------
  18.  
  19.   The MP3 fileformat has become one of the most used audio format in the
  20. world. This format is in fact the "layer 3" of the MPEG audio streams.
  21. Unlike most people think, the MP3 isn't a better compression system:
  22. for a given bitrate, it will give the same filesize as a "layer 2" file.
  23. The "layer 3" has been developed for low bitrate streams so that it 
  24. provides a good way to transfer audio data across Internet. But at com-
  25. mon bitrates (those used for good sound quality) it doesn't differ in
  26. quality compared to "layer 2" files (except if a bad encoder has been
  27. used, of course). The "layer 2" is recommended for very high quality
  28. encodings (high bitrates).
  29.  
  30.  
  31. II/ The player
  32. --------------
  33.  
  34.   Well, it took us a lot of time but here is the first release. This
  35. program is spread as a TTP executable file as we're still working on
  36. it. It will allow you to play MP3 files under these conditions:
  37.  
  38.  -only layer 3 is supported
  39.  -MPEG 1, MPEG 2 and MPEG 2.5 fileformats are supported
  40.  -Mono, Stereo and Dual-channel files are accepted, not Joint-Stereo.
  41.   (in fact, there is a trick to listen to Join-Stereo files, see below)
  42.  -the file is not severly damaged (simple error-recovery built-in)
  43.  
  44.   If the file is recognized, it will be played until its end unless you
  45. press the 'space' key before.
  46.  
  47.   It is pure monotasking...it will run under a multitasking OS but it will
  48. freeze alot the system ! That means that the player will slow down other
  49. programs but it can also be slowed by other programs (CAB for example). Also,
  50. avoid to play files from a slow harddisk or from a slow CD, because it would
  51. probably entails cuts into the sound (disk buffering).
  52.   Next versions, we'll have some GEM interface and an interrupt based decoder
  53. that will reduce the CPU time usage and speed up the disk buffering. So
  54. don't cry about that for now please !
  55.   Please keep in mind that both processors, even though they're working in
  56. parallel, need to synchronize so if you get a rate higher than 100% it means
  57. that one of the processor is too slow...either you're doing too much things in
  58. parallel on the 030 side or the dsp is simply too slow (should only happen if
  59. you don't use an audio clock on a standard Falcon for playing an MPEG 1
  60. stream).
  61.  
  62.   The only condition to run this player is to have 1.6Mo of free RAM
  63. on your Falcon 030. This amount of memory is required mainly to speed up
  64. the player.
  65.  
  66.   However, if you want to play MP3 files on a standard Falcon without an
  67. external audio clock, you should avoid big screen resolution because this may
  68. cause some slowdown of the replay, this should be very important if you have
  69. a VGA screen on your Falcon. You can either keep a large screen by shrinking
  70. the number of colours or use a small screen with a lot of colours...
  71.  
  72. III/ Features
  73. -------------
  74.  
  75.   The player supports some extra features:
  76.  
  77. -External audio clocks automatically detected and used (dual clocks and FDI
  78.  recognized too)
  79. -Linear sample interpolation to convert MPEG replay frequency to Falcon
  80. audio frequency. Useful only if you have not an external clock.
  81. -ID3 tags v1 and v2 recognized: they will be displayed at the beginning
  82.  of the replay (v1, v2.2.0 and v2.3.0 recognized)
  83. -Displays details about the fileformat at the beginning of the replay
  84.  (after ID3 if any). These infos are based on the first frame, but it
  85.  supports format-changes on the fly (except for frequency)
  86. -Variable bitrate supported
  87. -CPU speed boards accepted and recommended (especially if you don't have
  88.   any external audio clock and you want to play 44.1kHz or 48kHz files).
  89.   It's not very important for this version, but it will be for the next
  90.   release (if you want to use it as a desk accessory for example).
  91.  
  92.  
  93. IV/ Known bugs and limits of this version
  94. -----------------------------------------
  95.  
  96. - The accuracy of Layer 3 final resolving has to be improved. The DSP's 24
  97. bits fixed-point representation is not convenient for the Layer 3
  98. decoding algorithm we used. When the sound is weak, the signal/noise
  99. ratio could decrease, lowering the sound quality. We will add new DSP
  100. routines later.
  101.  
  102. - The Joint-Stereo encoding scheme isn't supported yet but will be decoded as
  103. a normal Stereo-encoded file. This will result in more or less noisy clicks
  104. on the left channel and probably weird sound on the right channel...This
  105. filetype will be supported in the next release.
  106.  
  107. - We did our best to make this player works with 16Mhz 030/32Mhz DSP. Most
  108. of the time, the file will be replayed correctly, even if it could use most
  109. of the available time of your Falcon. But problems are possible sometimes
  110. with 44kHz and 48Khz stereo MP3 files, resulting in a kind of echo effect or
  111. adding noisy clicks. If you have a 50Mhz 030/50Mhz DSP, you should never have
  112. this kind of problem !
  113. Anyway, to let standard Falcons users listen to all MP3, we added a special
  114. "Standard Falcon" mode, wich will output Join stereo and Stereo files as if
  115. they were mono. A 32Mhz DSP has then enough time to process the file at
  116. correct rate. To use this special mode, keep the SHIFT key held when starting
  117. FalcAMP.
  118.  
  119.  
  120.   We did our best to make this software system friendly, and to prevent any
  121. unexpected freezing of your computer. But, please, keep in mind that we
  122. cannot guarantee a complete reliability, all the more this is a betaversion.
  123. You have been warned !
  124.  
  125.   For bug reports, please send an email to STGHOST or SPLASH, using more
  126. or less the following model. Try to fill it with maximum accuracy.
  127.  
  128. FAMP's standard bug report:
  129. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  130.  
  131. a- Executable file and my configuration
  132.  
  133. My FAMP version is the: ___, FAMP.TTP filesize is ______ bytes.
  134.  
  135. Hardware configuration of your Falcon: model, memory, and additional
  136. hardware (clocks, faster CPU/FPU/DSP, enhanced sound system, ...).
  137.  
  138. Software configuration of your Falcon (when you found FAMP's bug, else the
  139. most frequently used): TOS version, additonal OS.
  140.  
  141. b- Layer 3 file
  142.  
  143. (Please, always keep the file wich is not played correctly until we
  144. answered.)
  145.  
  146. A bug occured with: ________.MP3 file (available at: ...).
  147. Filesize is: ...
  148. Displayed infos are: ...
  149.  
  150. Kind of error:
  151.  
  152. -> Famp give me the following error message:
  153. -> Famp is locked
  154. -> The sound is not correct. Here is a short description of what occured:
  155. -> ...
  156.  
  157.  
  158. V/ Authors
  159. ----------
  160.  
  161.   Who did what in this player:
  162.                              (I know what you did since last summer :-)
  163.  
  164. STGHOST (030 part)       deunstg@free.fr
  165.  File parsing, disk caching, scalefactor decoding, fast Huffman decoding,
  166.  clock detection, error recovery and many weeks of debugging
  167.  
  168. SPLASH (DSP part)        dcarrere@worldnet.fr
  169.  Sound system init, DMA-DSP transfer, requantisation, antialiasing
  170.  butterflies, IMDCT, polyphase filerbank, linear interpolation, and many
  171.  more weeks of debugging
  172.  
  173.  
  174. FAMP is a 100% assembler product, based on AMP 0.71, AMP 0.76, MPEGA and ISO
  175. MPEG sourcecode, that we completely changed, improved, and optimized for Falcon.
  176.  
  177.  
  178.   We'd like to thank:
  179.  
  180. -Tomislav Uzelac for spreading his sources of AMP
  181. -Stephane Tavenard for giving us his sources of MPEGA
  182. -All people who believed in us...
  183.  
  184.  
  185.   We decided to spread this software as a freeware. We did FAMP for the fun,
  186. and also because we were dying to listen MP3 files on our Falcon ! Also,
  187. maybe we did it because people used to say that it would be probably
  188. impossible to do, and we were convinced that it was possible.
  189.   Anyway, because of the huge work we put into this player, we wait -at least-
  190. for support and aknowledgements, and -at most- for money if you think it's
  191. worth the price. If you use FAMP often, please, do not forget us... It may
  192. speed-up the release of next version ! :-)
  193.  
  194. Have fun !
  195.