gzdoom/snes_spc
Randy Heit 01f59fa85f - Added an alternate module replay engine that uses foo_dumb's replayer, a
heavily customized version of DUMB (Dynamic Universal Music Bibliotheque).
  It has been slightly modified by me:
  * Added support for Ogg Vorbis-compressed samples in XM files ala FMOD.
  * Removed excessive mallocs from the replay core.
  * Rerolled the loops in resample.c. Unrolling them made the object file
    ~250k large while providing little benefit. Even at ~100k, I think it's
    still larger than it ought to be, but I'll live with it for now.
  Other than that, it's essentially the same thing you'd hear in foobar2000,
  minus some subsong detection features. Release builds of the library look
  like they might even be slightly faster than FMOD, which is a plus.
- Fixed: Timidity::font_add() did not release the file reader it created.
- Fixed: The SF2 loader did not free the sample headers in its destructor.


SVN r995 (trunk)
2008-05-29 23:33:07 +00:00
..
demo - Removed lots of spc_* cvars that are no longer meaningful and changed 2008-03-11 22:17:57 +00:00
fast_dsp - Removed lots of spc_* cvars that are no longer meaningful and changed 2008-03-11 22:17:57 +00:00
slow_dsp - Removed lots of spc_* cvars that are no longer meaningful and changed 2008-03-11 22:17:57 +00:00
snes_spc - Fixed: If an object is flagged for euthanization while it's in the gray 2008-03-16 00:54:53 +00:00
Makefile - Added an alternate module replay engine that uses foo_dumb's replayer, a 2008-05-29 23:33:07 +00:00
changes.txt - Removed lots of spc_* cvars that are no longer meaningful and changed 2008-03-11 22:17:57 +00:00
license.txt - Removed lots of spc_* cvars that are no longer meaningful and changed 2008-03-11 22:17:57 +00:00
readme.txt - Removed lots of spc_* cvars that are no longer meaningful and changed 2008-03-11 22:17:57 +00:00
snes_spc.txt - Removed lots of spc_* cvars that are no longer meaningful and changed 2008-03-11 22:17:57 +00:00
snes_spc.vcproj - Various fixes for compiling working 64-bit binaries with Visual C++. The 2008-04-29 02:43:42 +00:00

readme.txt

snes_spc 0.9.0: SNES SPC-700 APU Emulator
-----------------------------------------
This library includes a full SPC emulator and an S-DSP emulator that can
be used on its own. Two S-DSP emulators are available: a highly accurate
one for use in a SNES emulator, and a 3x faster one for use in an SPC
music player or a resource-limited SNES emulator.

* Can be used from C and C++ code
* Full SPC-700 APU emulator with cycle accuracy in most cases
* Loads, plays, and saves SPC music files
* Can save and load exact full emulator state
* DSP voice muting, surround sound disable, and song tempo adjustment
* Uses 7% CPU average on 400 MHz Mac to play an SPC using fast DSP

The accurate DSP emulator is based on past research by others and
hundreds of hours of recent research by me. It passes over a hundred
strenuous timing and behavior validation tests that were also run on the
SNES. As far as I know, it's the first DSP emulator with cycle accuracy,
properly emulating every DSP register and memory access at the exact SPC
cycle it occurs at, whereas previous DSP emulators emulated these only
to the nearest sample (which occurs every 32 clocks).

Author : Shay Green <gblargg@gmail.com>
Website: http://www.slack.net/~ant/
Forum  : http://groups.google.com/group/blargg-sound-libs
License: GNU Lesser General Public License (LGPL)


Getting Started
---------------
Build a program consisting of demo/play_spc.c, demo/demo_util.c,
demo/wave_writer.c, and all source files in snes_spc/. Put an SPC music
file in the same directory and name it "test.spc". Running the program
should generate the recording "out.wav".

Read snes_spc.txt for more information. Post to the discussion forum for
assistance.


Files
-----
snes_spc.txt            Documentation
changes.txt             Change log
license.txt             GNU LGPL license

demo/
  play_spc.c            Records SPC file to wave sound file
  benchmark.c           Finds how fast emulator runs on your computer
  trim_spc.c            Trims silence off beginning of an SPC file
  save_state.c          Saves/loads exact emulator state to/from file
  comm.c                Communicates with SPC how SNES would
  demo_util.h           General utility functions used by demos
  demo_util.c
  wave_writer.h         WAVE sound file writer used for demo output
  wave_writer.c

fast_dsp/               Optional standalone fast DSP emulator
  SPC_DSP.h             To use with full SPC emulator, move into
  SPC_DSP.cpp           snes_spc/ and replace original files

snes_spc/               Library sources
  blargg_config.h       Configuration (modify as necessary)
  
  spc.h                 C interface to SPC emulator and sound filter
  spc.cpp
  
  SPC_Filter.h          Optional filter to make sound more authentic
  SPC_Filter.cpp
  
  SNES_SPC.h            Full SPC emulator
  SNES_SPC.cpp
  SNES_SPC_misc.cpp
  SNES_SPC_state.cpp
  SPC_CPU.h
  
  dsp.h                 C interface to DSP emulator
  dsp.cpp
  
  SPC_DSP.h             Standalone accurate DSP emulator
  SPC_DSP.cpp
  blargg_common.h
  blargg_endian.h
  blargg_source.h

-- 
Shay Green <gblargg@gmail.com>