SND file v3 handler

Read SND file, play it, convert it to S3M or MIDI.

SND is a file format for storing NES (and some other console) music (almost) losslessly.

SND version 3 file format:
   Position Length Description
   0        4      Signature: "SND",26
   4        1      Version of file format. We use 3.
   5        1      Channelcount. For NES, 5.
   6        1      Rate (unsigned integer)
                   How many rows does it play in a second?
                   General values are 50 and 60.
   7        9      Unused, set to zero
   0x10     n      Events, see below
   
Event format:
   Data         Bytes Description
   0xFF          1     Next row (submit this row)
   0xFD x        2     Submit this row x times
   0xFE c t      3     Set channel c (zero based) type:
                        type 1: square
                        type 2: noise
                        type 3: triangle
                        type 4: dpcm
   0xFB n sl sh  2+s   Redefine PCM sample number n (1-based)
                        Size = sh:sl
                        PCM data follows (bytes 0x60..0x9F)
   0xdv c wl wh  4     Alter square wave on channel c:
                        Set duty = d (2,4,8,12)
                        Volume = v (0..15)
                        Wavelen = wh:wl (0..0x7FF)
   c wl wh v     4     Alter channel c
                        For triangle and noise:
                         Wavelen = wh:wl (0..0x7FF)
                         Volume = v (0..15)
                        For dpcm:
                         Sample number = v (set to 0 to stop sample)
                         Wavelen = wh:wl (0..0x7FF)

SNDv3 files are generated by nezplay (produced by
a patch to nezamp) from NSF and GBS files.

SNDv2 format was proposed to Martin Korth (no$gmb author)
for Game Boy music logging, but never applied.

SNDv1 files were generated by older versions
of iNES from NES gaming sessions.

Note that SNDv3 files use wavelengths whereas SNDv2
and SNDv1 files use frequencies. Therefore this format
isn't backwards compatible.

The program converts the SND to MidiS3M with Adlib instruments.
PCM samples are converted into S3M digital samples.
Conversion to MIDI format is also supported, but it doesn't save the PCM samples.

This zip file contains some S3M files generated by sndtool2 (only the instrument list has been finetuned by hand) and one MIDI generated by sndtool2 (not edited).
Note that the S3M files use adlib instruments.
Most mod players are unable to playback them, and most of the rest which can, only use an emulator which isn't perfect.

The program works, but isn't yet ready for users.
Command line options have to be implemented and the instrument type heuristics enhanced.
Three primary goals are:

• To shrink the amount of manual finetuning work needed after the conversion to minimum.
• To produce as exact conversion as possible, without hindering the next:
• To produce as readable and editable conversion as possible.

sndtool2 has been written by Joel Yliluoma, a.k.a. Bisqwit,
and is distributed under the following terms:

* No warranty. You are free to modify this source and to
* distribute the modified sources, as long as you keep the
* existing copyright messages intact and as long as you
* remember to add your own copyright markings.
* You are not allowed to distribute the program or modified versions
* of the program without including the source code (or a reference to
* the publicly available source) and this notice with it.

GNU tools are always good to have near.

• opl3emu emulates the OPL3 chip (which is known also as the FM synthesis chip or AdLib). I'm investigating how OPL works so that I could make a good adsr-based instrument detection here.

The official home page of sndtool2 is at http://iki.fi/bisqwit/source/sndtool2.html.
Check there for new versions.