home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 5 / RISCWORLD_VOL5.iso / SOFTWARE / Issue5 / IYONIX / KINOAMP / AMPlayer / Docs / Release < prev   
Encoding:
Text File  |  2002-01-07  |  6.6 KB  |  208 lines
  1. AMPlayer 1.39 Release Notes
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This is release 1.39 of AMPlayer; for full technical details of what has
  5. changed please see the Changes file in this directory.
  6.  
  7. AMPlayer is a family of MP3 playback modules/decoding systems based on
  8. an optimised decoder core, implemented in a mix of C and assembler.
  9.  
  10. Version 1.33 saw various important changes:
  11.  
  12.  * SharedSound support
  13.  
  14.  * Streaming interface
  15.  
  16.  * New FP version
  17.  
  18.  * New selector module
  19.  
  20.  * AMPapp
  21.  
  22.  * New distribution format
  23.  
  24.  * Significant speedups
  25.  
  26.  * Multiple Instantiation
  27.  
  28. Version 1.35 saw some more:
  29.  
  30.  * Tidied multiple instatiation.
  31.  
  32.  * Revised memory usage.
  33.  
  34.  * Various bugs fixed.
  35.  
  36.  * 'User' sound system added (to allow 'decode but not play' operation).
  37.  
  38. Version 1.36 introduced:
  39.  
  40.  * Bug fix for AmpApp.
  41.  
  42.  * Bug fix for 8 bit sound.
  43.  
  44.  * Speed improvements for FP version.
  45.  
  46. Version 1.37 introduced:
  47.  
  48.  * More speedups.
  49.  
  50.  * Improved instance handling.
  51.  
  52.  * Transient file playback
  53.  
  54. Version 1.38 introduced:
  55.  
  56.  * Bug fixes for stream handling.
  57.  * Many internal optimisations and improvements.
  58.  
  59. Version 1.39 introduced:
  60.  
  61.  * Various bug fixes.
  62.  
  63. SharedSound support
  64. ~~~~~~~~~~~~~~~~~~~
  65.  
  66. This section currently only applies to users with 16 bit sound on their
  67. machines. If you have an 8bit sound system then SharedSound will
  68. (currently) not operate at all and AMPlayer will behave exactly as
  69. older versions have.
  70.  
  71. Previously AMPlayer would claim the entire sound system, stopping any
  72. other sounds being generated. As from 1.33 onwards AMPlayer will use
  73. the SharedSound module (if it is loaded) to allow multiple sound system
  74. claimants at the same time.
  75.  
  76. Some users have noticed a degradation in Sound quality caused by the
  77. introduction of this facility. This degradation is due to the fact that
  78. the system sound frequency no longer tracks the frequency requested by
  79. AMPlayer, but rather stays constant. This is a consequence of the way
  80. SharedSound works, but can be easily alleviated.
  81.  
  82. In most cases MP3s are recorded at 44.1kHz (or an integer subdivision
  83. of this rate). By setting the sound system frequency to run at this
  84. speed all aliasing problems disappear, leaving perfectly mixed audio.
  85.  
  86. To set the sound frequency to 44.1kHz use the following command:
  87.  
  88.    SYS "Sound_SampleRate",3,20
  89.  
  90. [This assumes a standard RISC PC 16 bit sound system].
  91.  
  92. Some versions of SharedSound (notably that present in RISC OS 4) are broken
  93. in that they do not spot the frequency changes. Therefore after executing
  94. the previous command, it may be necessary to *RMReinit SharedSound and
  95. *RMReinit AMPlayer.
  96.  
  97. In any event if you want to revert to the old behaviour, simply kill the
  98. SharedSound module before loading AMPlayer.
  99.  
  100.  
  101. Streaming Interface
  102. ~~~~~~~~~~~~~~~~~~~
  103.  
  104. Old versions of the AMPlayer module could only play from a file. Version
  105. 1.33 introduces a streaming interface whereby data can be fed to AMPlayer
  106. in memory blocks. This is intended to facilitate the implementation of
  107. systems such as SHOUTcast in an efficient manner.
  108.  
  109. Details of the new streaming interface can be found in the example Frontend
  110. distribution.
  111.  
  112.  
  113. New FP version
  114. ~~~~~~~~~~~~~~
  115.  
  116. Previously 2 variants of the AMPlayer module have been available, AMPlayer
  117. and AMPlayer6. AMPlayer operates on machines with a long multiply operation
  118. available, whereas AMPlayer6 relies on macros to implement this long
  119. multiplication in terms of standard multiplications.
  120.  
  121. As from 1.33 we introduce a new variant AMPlayerFP that makes use of the
  122. floating point unit present in ARM7500FE based machines to do these long
  123. multiplications. This is still not fast enough to allow full bitrate
  124. operation on ARM7500FE based machines, but does allow modem speed clips
  125. to be played, thus opening the route to a SHOUTcast implementation in
  126. future.
  127.  
  128.  
  129. New selector module
  130. ~~~~~~~~~~~~~~~~~~~
  131.  
  132. With this proliferation of new versions it was getting increasingly hard
  133. for applications programmers to load the right variant for the machine
  134. they were on. We have therefore introduced a new module that automatically
  135. loads the correct variant of the module.
  136.  
  137. Simply performing:
  138.  
  139.  *RMEnsure AMPlayer 1.35 RMLoad System:Modules.Audio.MP3.AMPlayer
  140.  *RMEnsure AMPlayer 1.35 Error AMPlayer 1.35 cannot be found!
  141.  
  142. Will load the correct version. Please note that programmers shipping
  143. new Frontends for AMPlayer should NOT include the AMPlayer module
  144. within their application, but should load it from the !System directory
  145. as shown above.
  146.  
  147.  
  148. AMPapp
  149. ~~~~~~
  150.  
  151. Current solutions for decoding (rather than playing) MP3 files have
  152. sometimes worked in a less than ideal manner. To address this we have
  153. provided a command line build of the decoder called AMPapp. This is
  154. available as a separate download.
  155.  
  156.  
  157. New distribution format
  158. ~~~~~~~~~~~~~~~~~~~~~~~
  159.  
  160. As the AMPlayer family has grown it has become necessary (or at least
  161. desirable) to split it into more than one distribution. The current
  162. distributions are as follows:
  163.  
  164.  * Module Distribution: This contains the basic set of AMPlayer modules.
  165.    Anyone wanting to do playback using AMPlayer will need this distribution.
  166.    They will probably also want a frontend; either the example frontend
  167.    supplied with AMPlayer or any of the other alternatives available on the
  168.    net.
  169.  
  170.  * Example Frontend: This is the example frontend. While sufficient for
  171.    many peoples use its main task is to demonstrate what is possible.
  172.    Documentation on the AMPlayer modules API is included here.
  173.  
  174.  * AMPapp Distribution: This contains the command line MP3->PCM/WAV decoder.
  175.  
  176. These distributions contain a new license that outlines their
  177. use/redistribution status. Basically it is intended to allow free
  178. redistribution and to encourage future development while ensuring
  179. that developments remain free.
  180.  
  181.  
  182. Significant Speedups
  183. ~~~~~~~~~~~~~~~~~~~~
  184.  
  185. AMPlayer 1.33 has benefitted from having significant sections recoded in
  186. assembler. This has lowered the CPU usage significantly, and we now believe
  187. AMPlayer to be the most efficient RISC OS MP3 player currently available.
  188.  
  189.  
  190. Multiple Instantiation
  191. ~~~~~~~~~~~~~~~~~~~~~~
  192.  
  193. It is now possible to multiply instantiate AMPlayer. Coupled with the
  194. SharedSound system describe earlier this means that (subject to CPU
  195. and memory constraints) several MP3s can now be played at the same time.
  196. This facility is significantly better than in previous versions, and should
  197. allow AMPlayer to be used as a generic decoding resource. Contact the
  198. AMPlayer developers <amplayer@armware.dk> for more information.
  199.  
  200.  
  201. Decode-but-not-play interface
  202. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  203.  
  204. For systems (such as Flash decoders) that need to decode MP3 data, but have
  205. control over the playback itself, AMPlayer has grown a 'User' sound system.
  206. This enables controlling applications to capture the output from a decode
  207. and to play it back itself.
  208.