Mercurial > spc_convert

     1 snes_spc 0.9.0: SNES SPC-700 APU Emulator

     2 -----------------------------------------

     3 This library includes a full SPC emulator and an S-DSP emulator that can

     4 be used on its own. Two S-DSP emulators are available: a highly accurate

     5 one for use in a SNES emulator, and a 3x faster one for use in an SPC

     6 music player or a resource-limited SNES emulator.

     7 

     8 * Can be used from C and C++ code

     9 * Full SPC-700 APU emulator with cycle accuracy in most cases

    10 * Loads, plays, and saves SPC music files

    11 * Can save and load exact full emulator state

    12 * DSP voice muting, surround sound disable, and song tempo adjustment

    13 * Uses 7% CPU average on 400 MHz Mac to play an SPC using fast DSP

    14 

    15 The accurate DSP emulator is based on past research by others and

    16 hundreds of hours of recent research by me. It passes over a hundred

    17 strenuous timing and behavior validation tests that were also run on the

    18 SNES. As far as I know, it's the first DSP emulator with cycle accuracy,

    19 properly emulating every DSP register and memory access at the exact SPC

    20 cycle it occurs at, whereas previous DSP emulators emulated these only

    21 to the nearest sample (which occurs every 32 clocks).

    22 

    23 Author : Shay Green <gblargg@gmail.com>

    24 Website: http://www.slack.net/~ant/

    25 Forum  : http://groups.google.com/group/blargg-sound-libs

    26 License: GNU Lesser General Public License (LGPL)

    27 

    28 

    29 Getting Started

    30 ---------------

    31 Build a program consisting of demo/play_spc.c, demo/demo_util.c,

    32 demo/wave_writer.c, and all source files in snes_spc/. Put an SPC music

    33 file in the same directory and name it "test.spc". Running the program

    34 should generate the recording "out.wav".

    35 

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

    37 assistance.

    38 

    39 

    40 Files

    41 -----

    42 snes_spc.txt            Documentation

    43 changes.txt             Change log

    44 license.txt             GNU LGPL license

    45 

    46 demo/

    47   play_spc.c            Records SPC file to wave sound file

    48   benchmark.c           Finds how fast emulator runs on your computer

    49   trim_spc.c            Trims silence off beginning of an SPC file

    50   save_state.c          Saves/loads exact emulator state to/from file

    51   comm.c                Communicates with SPC how SNES would

    52   demo_util.h           General utility functions used by demos

    53   demo_util.c

    54   wave_writer.h         WAVE sound file writer used for demo output

    55   wave_writer.c

    56 

    57 fast_dsp/               Optional standalone fast DSP emulator

    58   SPC_DSP.h             To use with full SPC emulator, move into

    59   SPC_DSP.cpp           snes_spc/ and replace original files

    60 

    61 snes_spc/               Library sources

    62   blargg_config.h       Configuration (modify as necessary)

    63   

    64   spc.h                 C interface to SPC emulator and sound filter

    65   spc.cpp

    66   

    67   SPC_Filter.h          Optional filter to make sound more authentic

    68   SPC_Filter.cpp

    69   

    70   SNES_SPC.h            Full SPC emulator

    71   SNES_SPC.cpp

    72   SNES_SPC_misc.cpp

    73   SNES_SPC_state.cpp

    74   SPC_CPU.h

    75   

    76   dsp.h                 C interface to DSP emulator

    77   dsp.cpp

    78   

    79   SPC_DSP.h             Standalone accurate DSP emulator

    80   SPC_DSP.cpp

    81   blargg_common.h

    82   blargg_endian.h

    83   blargg_source.h

    84 

    85 -- 

    86 Shay Green <gblargg@gmail.com>
author	Robert McIntyre <rlm@mit.edu>
date	Fri, 21 Oct 2011 07:46:18 -0700
parents	e38dacceb958
children