home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / Emulation / SPCRecordPPC / SPCRecordPPC.doc < prev    next >
Text File  |  1998-12-23  |  5KB  |  198 lines
  1. (C) 1998 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) and
  10.  *                                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 the PPC version of an SPC-700 emulator for your Amiga.  The
  46. SPC-700 is the sound co-processor in the Super Nintendo.
  47.  
  48. It is called SPCRecordPPC because it can only output to a disk file.  It
  49. cannot play anything in realtime (yet.)
  50.  
  51. This is based on the SNES9x sources so it's compatability is very high,
  52. unlike my other emulator.  I originally wrote this to debug the sound
  53. in the Amiga PPC ports of SNES9x, but since it works so well, I will
  54. continue to develop it as a stand alone SPC-700 emulator.
  55.  
  56.  
  57.  
  58.  
  59. Requirements:
  60.  
  61. A PPC board for your Amiga
  62. Some program that can play raw sound samples
  63. Some RAM (I don't know exactly how much, but it should be less than 512k)
  64. Some SPC files.  You can get these from various websites.  You might
  65.  try www.chez.com/raist/spc700/
  66.  
  67.  
  68. Installation:
  69.  
  70. Copy the file SPCRecordPPC anywhere you want to.  You probably want it
  71. somewhere in your path so copy it to C: or RAM:
  72.  
  73.  
  74. Usage:
  75.  
  76. At the CLI type
  77.  
  78. SPCRecordPPC <infile.spc> <outfile.raw> <milliseconds>
  79.  
  80. Infile is the SPC file to emulate
  81. Outfile is the file of raw sound data that will be created
  82. Miliseconds is the number of milliseconds of data to record.
  83.  
  84. 1000 milliseconds = 1 second
  85.  
  86. The raw output data will be 16-bit mono, big endian, at 22050 khz unless
  87. you specify some options:
  88.  
  89. F=FREQ/K/N - Frequency.  Ignored for now.  Frequency is fixed at 22050 khz.
  90. E=EIGHT/S - Output data will be 8-bit.
  91. S=STEREO/S - Output data will be interleaved stereo: left, then right.
  92.  
  93. B=BUFF/K/N - Buffer size.  Default is 65536 bytes.
  94. DE=NOECHO/S - Disable echo.  Can make it sound a bit clearer.
  95. DC=NOCACHE/S - Disable sample caching.  Slower, but slightly better quality
  96. DM=NOMVOL/S - Disable master volume.  Slightly different output.
  97.  
  98.  
  99.  
  100. So to make a 10 second long 16-bit mono file you might type:
  101.  
  102. SPCRecordPPC infile.spc outfile.raw 10000
  103.  
  104. To make a 1 second long 16-bit stereo file:
  105.  
  106. SPCRecordPPC infile.spc outfile.raw 1000 S
  107.  
  108.  
  109. To make a 5 second long 8-bit stereo file:
  110.  
  111. SPCRecordPPC infile.spc outfile.raw 5000 E S
  112.  
  113.  
  114. To make a 30 second long 8-bit mono file:
  115.  
  116. SPCRecordPPC infile.spc outfile.raw 30000 E
  117.  
  118.  
  119. To make a 2 second long 16-bit mono file with no echo:
  120.  
  121. SPCRecordPPC infile.spc outfile.raw 2000 DE
  122.  
  123.  
  124.  
  125.  
  126. To play the output file, you must use some other program.
  127. I recommend Play16.
  128.  
  129.  
  130. Usage: Play16 outfile raw
  131.  
  132. Add these options:
  133.  
  134. bits 16 - if file is 16-bit
  135. tracks 2 - if file is stereo
  136.  
  137.  
  138.  
  139. So to play a file with the default output you would type:
  140.  
  141. Play16 outfile raw bits 16
  142.  
  143.  
  144. To play a 16-bit stereo file:
  145.  
  146. Play16 outfile raw bits 16 tracks 2
  147.  
  148.  
  149. To play an 8-bit stereo file:
  150.  
  151. Play16 outfile raw tracks 2
  152.  
  153.  
  154. To play an 8-bit mono file:
  155.  
  156. Play16 outfile raw
  157.  
  158.  
  159.  
  160. Bugs:
  161.  
  162. - I don't have a PPC board myself, so it's difficult to test this.
  163. - XPK support may not work.
  164. - Argument reading might not work all the time.
  165.  
  166.  
  167. Help:
  168.  
  169. Does anyone know why SAS/C++ PPC has problems with the commandline?  I
  170. only got ReadArgs to work by passing in the command line to it directly.
  171. Also, sometimes argv[] would be corrupt.
  172.  
  173.  
  174. Future:
  175.  
  176. - WarpOS version!!
  177. - Better documentation
  178. - User defined frequencies
  179. - Output to other file formats besides raw
  180. - More speed
  181. - A realtime PPC version
  182. - A realtime 680x0 version for highend processors
  183.  
  184.  
  185. Contact:
  186.  
  187. Which would you prefer?  PPC or WarpOS?  Cast you vote now...
  188.  
  189. Please report all bugs immediately!
  190.  
  191. If you have any SPC-700 questions, comments, or whatever then drop me
  192. a line at:
  193.  
  194. Gaelan Griffin / chinoclast@softhome.net
  195.  
  196.  
  197. Also be sure to visit the website at http://www.chez.com/raist/spc700/
  198.