home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 19 / AACD19.BIN / CDTools / Players / DeliTracker / Bonus / S9xPlay93.lha / S9xPlay.doc < prev   
Text File  |  2000-04-19  |  8KB  |  207 lines
  1. (C) 1999 by Gaelan Griffin, FREEWARE
  2.  
  3. Read below for more information on the other copyright holders and the
  4. distribution:
  5.  
  6. /*
  7.  * Snes9x - Portable Super Nintendo Entertainment System (TM) emulator.
  8.  *
  9.  * (c) Copyright 1996, 1997, 1998 Gary Henderson (gary@daniver.demon.co.uk)
  10.  *                                and Jerremy Koot (jkoot@euronet.nl)
  11.  *
  12.  * Super FX C emulator code 
  13.  * (c) Copyright 1997, 1998 Lestat (lstat@hotmail.com) and
  14.  *                          Gary Henderson.
  15.  * Super FX assembler emulator code (c) Copyright 1998 zsKnight and _Demo_.
  16.  *
  17.  * DSP1 emulator code (c) Copyright 1998 Lestat and Gary Henderson.
  18.  * DOS port code contains the works of other authors. See headers in
  19.  * individual files.
  20.  *
  21.  * Permission to use, copy, modify and distribute Snes9x in both binary and
  22.  * source form, for non-commercial purposes, is hereby granted without fee,
  23.  * providing that this license information and copyright notice appear with
  24.  * all copies and any derived work.
  25.  *
  26.  * This software is provided 'as-is', without any express or implied
  27.  * warranty. In no event shall the authors be held liable for any damages
  28.  * arising from the use of this software.
  29.  *
  30.  * Snes9x is freeware for PERSONAL USE only. Commercial users should
  31.  * seek permission of the copyright holders first. Commercial use includes
  32.  * charging money for Snes9x or software derived from Snes9x.
  33.  *
  34.  * The copyright holders request that bug fixes and improvements to the code
  35.  * should be forwarded to them so everyone can benefit from the modifications
  36.  * in future versions.
  37.  *
  38.  * Super NES and Super Nintendo Entertainment System are trademarks of
  39.  * Nintendo Co., Limited and its subsidiary companies.
  40.  */
  41.  
  42.  
  43. Introduction:
  44.  
  45. This is an SPC700 emulator for your Amiga.  The SPC700 is the sound
  46. co-processor chip inside the Super Nintendo.
  47.  
  48. This program will attempt to play SNES music in realtime on any 68020+
  49. Amiga, using direct paula access or AHI.  It is a combination executable
  50. and deliplayer which means you can run it from the CLI or load it
  51. into Delitracker/Eagleplayer.
  52.  
  53. This program is based on the SNES9x sources.  The result is high quality,
  54. but at the expense of speed.  A 040+ is highly recommended, but I think
  55. that only 060 owners are going to be able to use this effectively.  Due
  56. to the nature of the emulated replays, some files will play much faster
  57. than others, which you will probably notice.  You can improve the speed
  58. by adjusting both the program options and/or your AHI settings.  If your
  59. CPU is not fast enough, there will be large gaps of silence between
  60. audio buffers, this can also occur when other programs steal too much
  61. CPU time from the emulator.  When using direct paula output, the buffer
  62. will be repeated instead of silence being played when the buffer has
  63. not been filled up in time.  If your CPU is too slow, you can use
  64. the file recording option to save raw audio data directly to a
  65. disk file for realtime playback.
  66.  
  67.  
  68.  
  69. Requirements:
  70.  
  71. - A 68020 Amiga or better
  72. - Some RAM (I don't know exactly how much, but it should be less than 512k)
  73. - Some SPC files to emulate.  You can get these from various sources on
  74. the Internet or you can make your own with certain SNES emulators.  A
  75. good place to start your search is the official webpage at
  76. http://come.to/amispc or http://www.chez.com/raist/spc700/
  77.  
  78. Recommended:
  79.  
  80. - A 68060 CPU in your Amiga
  81. - Delitracker or Eagleplayer installed.
  82. - AHI V4 or better installed.  Get it from Aminet: mus/misc/ahiusr.lha
  83.  
  84.  
  85. Installation:
  86.  
  87. Copy the executable file S9xPlay anywhere you want to.  You will probably
  88. want it somewhere in your system path so copy it to C: or RAM:
  89. If you want to use it as a deliplayer too, then make a copy of the
  90. program and place it in your deli/eagleplayers directory.
  91. S9xPlay uses the AHI Unit preferences, so make sure they are setup
  92. properly (default is Unit 0) if you are going to use the AHI option.
  93.  
  94.  
  95. Usage:
  96.  
  97. If you've installed it as a deliplayer then simply start Delitracker
  98. or Eagleplayer and make sure the player is enabled.  To change the
  99. preferences, you'll have to manually edit the prefs file.  The
  100. prefs file is called S9xPlay.prefs and is just a line of text that
  101. you would add for the arguments in the CLI version except that
  102. the AHI and file output options are not valid.  The prefs file
  103. is read when DT is first started, however pressing the config
  104. button in the players window, will cause the the prefs file to be
  105. reread and the new prefs will be implemented the next time an SPC
  106. file is loaded.
  107.  
  108. To use it as a shell command at the CLI type
  109.  
  110. S9xPlay <infile.spc> [options]
  111.  
  112. Infile is the SPC file to emulate and is the only required option.
  113.  
  114. F=FREQ/K/N - Frequency to mix the audio data at.  Default is 22050 khz.
  115. B=BUFF/K/N - Mixing buffer size in sample frames, default is 1.5 secs worth
  116. E=EIGHT/S - Output data will be 8-bit, default is 16-bit
  117. S=STEREO/S - Output data will be stereo, default is mono
  118. A=AHI/S - Use AHI for audio output, default is to use direct paula access
  119. U=UNIT/K/N - AHI Unit number to use 0-3, default is Unit 0
  120. SY=SYNC/S - Synchronize CPU and mixing code, ignored for now
  121. I=INTERPOLATE/S - Use interpolation in mixing routines, slows it down
  122. DE=NOECHO/S - Disables echo which sometimes sounds better and speeds it up.
  123. DC=NOCACHE/S - Disable sample caching.  Slower, but better quality sometimes.
  124. DM=NOMVOL/S - Disable master volume.  Emulation volume will always be max.
  125. O=FILE/K - Output file for recording raw audio data
  126. T=TIME/K/N - Number of milliseconds to record (1000 = 1 second)
  127.  
  128.  
  129.  
  130.  
  131. Hints:
  132.  
  133.  
  134. For AHI:
  135.  
  136. Remember that the AHI preferences used are the device Unit preferences,
  137. NOT the Music Unit!  Unit 0 is the default.
  138.  
  139. To improve sound quality you might try setting the AHI CPU usage to 100%,
  140. but this is dangerous!
  141.  
  142. If the output is too soft, set the number of channels in the Unit
  143. preferences to 1 and/or use 8-bit modes and/or use the 8-bit mixing option.
  144.  
  145. The output quality will improve with some of the higher quality audio
  146. modes, but at the expense of speed.  It's possible that your sound card
  147. might be causing some problems so try using Paula for output if you're
  148. having problems.
  149.  
  150. For the player itself:
  151.  
  152. Reduce the mixing frequency, try f 8000 or f 11000
  153.  
  154. Disable echo at the command line for a small speed gain.
  155.  
  156. Sixteen bit mixing is practically free, but if your output is 8-bit,
  157. then use the eight bit option for a small speed gain.
  158.  
  159. Make sure you're not running any other CPU intensive tasks concurrently,
  160. as they will most likely cause the emulator to fall behind and create
  161. gaps in the audio output.
  162.  
  163. Increasing the buffer size will help a little, but the player will be less
  164. responsive and will take longer to start playing.
  165.  
  166.  
  167.  
  168. Known Bugs:
  169.  
  170. - Some SPC files do not play or play incorrectly.
  171.  
  172.  
  173. Future:
  174.  
  175. - Sourcecode release
  176. - Better documentation
  177. - Integrate most recent SNES9x sources
  178. - More speed
  179. - Other methods of output (direct soundcard support)
  180. - Calibrated 14-bit paula output (currently 14-bit output is not calibrated)
  181. - Preferences GUI for the deliplayer interface
  182.  
  183.  
  184. Contact:
  185.  
  186. Please report all bugs immediately!
  187.  
  188. If you have any SPC700 questions, comments, or whatever then contact
  189. me at:
  190.  
  191. Gaelan Griffin / chinoclast@softhome.net
  192.  
  193.  
  194. Also be sure to visit the website at
  195. http://come.to/amispc or http://www.chez.com/raist/spc700/
  196.  
  197.  
  198. History:
  199.  
  200. 10.04.00 V0.93  - Delitracker release, minor bugfix.
  201. 18.07.99 V0.93b - Direct 14-bit Paula support added.  Program is now
  202.                   a combination executable and deliplayer.  File recording
  203.           support added.  Please read the whole documentation again.
  204. 25.03.99 V0.92  - Official release of V0.92, sound has improved
  205. 15.03.99 V0.92b - Ide's of March beta release, compiled with 1.18e code
  206. 13.03.99 V0.91  - First public release
  207.