home *** CD-ROM | disk | FTP | other *** search
/ Amiga Dream 59 / CDDream59.ISO / Amiga / Emulation / SPCRecord.lha / SPCRecordV0.90 / SPCRecord.doc < prev    next >
Text File  |  1998-12-11  |  5KB  |  180 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 an SPC-700 emulator for your Amiga.  The SPC-700 is the sound
  46. co-processor in the Super Nintendo.
  47.  
  48. It is called SPCRecord 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. Some program that can play raw sound samples
  62. Some RAM (I don't know exactly how much, but it should be less than 512k)
  63. Some SPC files.  You can get these from various websites.  You might
  64.  try www.chez.com/raist/spc700/
  65.  
  66.  
  67. Installation:
  68.  
  69. Copy the file SPCRecord anywhere you want to.  You probably want it
  70. somewhere in your path so copy it to C: or RAM:
  71.  
  72.  
  73. Usage:
  74.  
  75. At the CLI type
  76.  
  77. SPCRecord <infile.spc> <outfile.raw> <milliseconds>
  78.  
  79. Infile is the SPC file to emulate
  80. Outfile is the file of raw sound data that will be created
  81. Miliseconds is the number of milliseconds of data to record.
  82.  
  83. 1000 milliseconds = 1 second
  84.  
  85. The raw output data will be 16-bit mono, big endian, at 22050 khz unless
  86. you specify some options:
  87.  
  88. F=FREQ/K/N - Frequency.  Ignored for now.  Frequency is fixed at 22050 khz.
  89. E=EIGHT/S - Output data will be 8-bit.
  90. S=STEREO/S - Output data will be interleaved stereo: left, then right.
  91.  
  92. B=BUFF/K/N - Buffer size.  Default is 65536 bytes.
  93. DE=NOECHO/S - Disable echo.  Can make it sound a bit clearer.
  94. DC=NOCACHE/S - Disable sample caching.  Slower, but slightly better quality
  95. DM=NOMVOL/S - Disable master volume.  Slightly different output.
  96.  
  97.  
  98.  
  99. So to make a 10 second long 16-bit mono file you might type:
  100.  
  101. SPCRecord infile.spc outfile.raw 10000
  102.  
  103. To make a 1 second long 16-bit stereo file:
  104.  
  105. SPCRecord infile.spc outfile.raw 1000 S
  106.  
  107.  
  108. To make a 5 second long 8-bit stereo file:
  109.  
  110. SPCRecord infile.spc outfile.raw 5000 E S
  111.  
  112.  
  113. To make a 30 second long 8-bit mono file:
  114.  
  115. SPCRecord infile.spc outfile.raw 30000 E
  116.  
  117.  
  118. To make a 2 second long 16-bit mono file with no echo:
  119.  
  120. SPCRecord infile.spc outfile.raw 2000 DE
  121.  
  122.  
  123.  
  124.  
  125. To play the output file, you must use some other program.
  126. I recommend Play16.
  127.  
  128.  
  129. Usage: Play16 outfile raw
  130.  
  131. Add these options:
  132.  
  133. bits 16 - if file is 16-bit
  134. tracks 2 - if file is stereo
  135.  
  136.  
  137.  
  138. So to play a file with the default output you would type:
  139.  
  140. Play16 outfile raw bits 16
  141.  
  142.  
  143. To play a 16-bit stereo file:
  144.  
  145. Play16 outfile raw bits 16 tracks 2
  146.  
  147.  
  148. To play an 8-bit stereo file:
  149.  
  150. Play16 outfile raw tracks 2
  151.  
  152.  
  153. To play an 8-bit mono file:
  154.  
  155. Play16 outfile raw
  156.  
  157.  
  158.  
  159. Future:
  160.  
  161. - Better documentation
  162. - User defined frequencies
  163. - Output to other file formats besides raw
  164. - More speed
  165. - A realtime PPC version
  166. - A realtime 680x0 version for highend processors
  167.  
  168.  
  169. Contact:
  170.  
  171. Please report all bugs immediately!
  172.  
  173. If you have any SPC-700 questions, comments, or whatever then drop me
  174. a line at:
  175.  
  176. Gaelan Griffin / chinoclast@softhome.net
  177.  
  178.  
  179. Also be sure to visit the website at http://www.chez.com/raist/spc700/
  180.