Java SID Player Music Library V2 Files

Description:
============
This version is based of sourceforge project sidplay2 (SID Player Music Library V2).
This is a java version of the original C++ sources.
The goal is to create a 100% compatible version in java.

The base Versions of the converted C++ sources are:
resid 0.16
libsidplay 2.1.1
sidplay 2.0.9

Platform:
All java platforms should work.
Currently testing on Windows XP

The current supported features are:
- sound emulation with resid is now feature complete
- CPU emulation is feature complete
- CIA emulation is feature complete
- VIC emulation is feature complete (this is only a minimal implementation)
- XSID (extensions for special SID effects) is feature complete
- supported file formats: PSID, RSID, MUS, P00, PRG (currently tested only: PSID, RSID)
- Player capabilities: currently only console based player

The following features are still missing:
- hardsid support
- Amiga file formats

The following tasks are to do:
- Test player on various sound formats
- Test player with stereo SIDs
- Offer emulation options for console based player (as the original does)
- WAV output instead of soundcard output
- Linux test with Java Sound API

Instructions:
=============
Usage: java -jar jsidplay2.jar <filename> [tune]
- filename = path name of the sound file
- tune     = (1..?) number of the song in the sound file (Default: 1)

Example:
Start player to play Turrican sound file with song number 2

java -jar jsidplay2.jar Turrican.sid 2