home *** CD-ROM | disk | FTP | other *** search
/ M.u.C.S. Disc 2000 / MUCS2000.iso / sound / mp2 / readme < prev    next >
Encoding:
Text File  |  1996-12-08  |  5.7 KB  |  148 lines
  1.  
  2.                          Atari/C-Lab Falcon
  3.            MPEG Audio Layer II PRG/ACC Realtime DSP Decoder
  4.                             version 0.95
  5.                            December  1996
  6.  
  7.                        http://noring.org/mp2
  8.  
  9.                     a NoCrew Production MCMXCVI
  10.  
  11.           Copyright ╜ Fredrik Noring & Tomas Berndtsson, 1996
  12.  
  13.   This program is free software; you can redistribute it and/or modify
  14.   it under the terms of the GNU General Public License as published by
  15.   the Free Software Foundation; either version 2 of the License, or
  16.   (at your option) any later version.
  17.  
  18.  
  19. This is the version 0.95 release of the MPEG Audio Layer II decoder
  20. by Fredrik Noring and Tomas Berndtsson.
  21.  
  22. See NEWS for more news after version 0.9.
  23.  
  24. New features from version 0.9 are:
  25.  
  26.        * Dynamic buffer allocation
  27.        * Config file
  28.        * Find next song in the same directory
  29.        * Skip to next and previous song
  30.        * Fast forward
  31.        * Songs with CRC now work
  32.        * Keyboard control
  33.        * Change if count down or up
  34.  
  35. Some bugs has also been fixed:
  36.  
  37.        * Pause now works all the time
  38.        * On play, the player was sometimes silent
  39.  
  40. Features from version 0.7 are still worth mentioning:
  41.  
  42.        * Handshaked DMA transfers
  43.        * GEM interface, also working as ACC
  44.        * Several new options, including pause and stop
  45.        * Sync detection and recovery routines
  46.        * Clock detection
  47.        * Count-down display
  48.        * MiNT support, and several other systems
  49.  
  50. Although this program has been tested successfully with various MPEG songs,
  51. no warranties comes with the program. We are not responsible for anything
  52. it might do to you or your system. If it works well for you, we'll gladly
  53. take the credit for it.
  54.  
  55. The program is a standalone program and it is also designed to work as
  56. an accessory. Simply rename the PRG to ACC and put it where the rest of
  57. your accessories are.
  58.  
  59. The config file (MP2AUDIO.CNF) should be placed either in the same
  60. directory as the program or in the root of C:\. The program will first 
  61. look for it in the program's directory and then C:\.
  62. If no config file can be found or if an argument is invalid, the
  63. default value(s) are used. The default values can be found in the
  64. example config file.
  65. Note that the config file is only loaded when the program is first
  66. started. Therefore, if you run it as ACC, any changes in the config
  67. file will only take place after a reboot or resolution change.
  68.  
  69. Here is a list of the keyboard controls:
  70.  
  71.   SPACE     -     Play/Stop
  72.  Ctrl-l     -     (Load and) Play
  73.  Ctrl-s     -     Stop
  74.  Ctrl-o     -     Load (and don't play)
  75.  Ctrl-p     -     Pause
  76.  Ctrl-f     -     Next song
  77.  Ctrl-b     -     Previous song
  78.  Ctrl-v     -     Fast Forward
  79.  Ctrl-r     -     Repeat on/off
  80.  Ctrl-t     -     Count down/up
  81.  Ctrl-i     -     Info
  82.  Ctrl-u     -     Close top window
  83.  
  84. The player has been tested with both MultiTOS and oAESis running under
  85. MiNT version 1.12, with and without NVDI 4.11, and of course normal TOS. 
  86.  
  87. The player supports the Drag & Drop protocol used in MultiTOS and other
  88. desktops. This means you can drag a file from the desktop to the players
  89. control window. If the Alternate key is held down when dropping, the 
  90. player will only load the song, not start playing it. See the file BUGS!
  91.  
  92. In case the Drag & Drop protocol isn't supported, the player also works
  93. with the VA_START message, used by at least Gemini and Thing. I have only
  94. tested it with Thing, since I don't have Gemini. With VA_START, the song
  95. always starts playing, but if you use Thing, it will use Drag & Drop as
  96. first choice.
  97.  
  98. Currently, the resource file is only made for interlaced mode on RGB's 
  99. and non-doublelined mode on VGA's. The program still works in other 
  100. resolutions though.
  101.  
  102. The program normally detects if there is an external clock attached to 
  103. the computer and uses it if so. Otherwise, the internal clock is used 
  104. and a frequency conversion (linear interpolation) to 49.17 kHz is made 
  105. by the DSP (this reduces sound quality significantly). This detection
  106. may always be overridden by the FORCE_CLOCK argument in the config file.
  107.  
  108. Note that the frequency conversion takes some DSP time, thus high
  109. bitrate (typically 192kbit/s) MPEGs might not work without an external 
  110. clock.
  111.  
  112. In this version, the program will assume that the external clock, if any,
  113. is a 44.1 kHz. If a 48 kHz, or any other, is used the song will probably
  114. be played at that frequency. Other frequencies than 44.1 kHz might work,
  115. we haven't tested it yet. The lyrics function is not yet implemented.
  116.  
  117. There is no special mailing list for this product, but the most appropriate
  118. mailing list for asking questions or giving great ideas is
  119. nocrew-nojunk@dd.chalmers.se.
  120. You can also contact the authors of the program, see addresses below.
  121.  
  122.  
  123. We are interested in what kinds of MPEG files that work, so if you are
  124. able to play songs with bitrates lower than 128 kbit/s, or frequencies
  125. others than 44.1 kHz, please let us know. Also, if you run it in other
  126. systems than the normal and the ones listed above, such as N.AES, XaAES,
  127. MagiC, whatever, let us know.
  128.  
  129. MPEG audio files can be found at http://www.iuma.com.
  130. !! NOTE !! Only stereo songs work in this version!!
  131.  
  132. Thanks to Anders Eriksson for testing the program and his work on the
  133. resource file, even if we changed most of the original resource.
  134.  
  135. Enjoy,
  136.  
  137. Fredrik Noring            Tomas Berndtsson
  138. fredrik@noring.org        tomas@nocrew.pp.se
  139. http://www.noring.org/    http://www.lysator.liu.se/~tobe/
  140.  
  141. Donations are welcome! Send money to:
  142.  
  143.    NoCrew DSP Productions
  144.    Tröskaregatan 69.10
  145.    S-583 33 Linköping
  146.           SWEDEN
  147.  
  148.