Text from JSIDPlay2 V2.0|
|Text:||FAQ - JSIDPlay2 - Music Player & C64 SID Chip Emulator|
1. What is JSIDPlay2?
JSIDPlay2 is a software that makes it possible to listen to SID music of the Commodore 64 (C64)
a very popular Home Computer of the 80's. Beside that, it has evolved to a full featured Commodore 64 emulator.
2. What is a SID?
SID (Sound Interface Device)
is the name of a sound chip and part of the Commodore 64.
It is responsible for sound playback and a synthesizer which can be programmed in Basic and Assembler
to produce sound output.
3. What is SID music?
SID music (or SID tune) is a program running on the C64, that produces sound.
SID is also a file extension. Emulators such as JSIDPlay2 are able to load SID music and
play the songs contained in a SID tune.
4. Where can I get SID music?
- High Voltage SID Collection (HVSC) - the biggest and most popular SID music collection
- Compute's Gazette SID Collection (CGSC) - A collection of COMPUTE!'s Sidplayer music containing tons of stereo files
- Stone Oakvalley's Authentic SID Collection (SOASC=) - A recording project containing SID music both in SID and MP3 format.
5. What is the system requirement to use JSIDPlay2?
JSIDPlay2 is a Java program and should run on every Java enabled platform,
that is at least Windows, Linux and Mac OS X. Java version 1.6 is required as a minimum to run JSIDPlay2.
Because the emulation is cycle exact, a fast PC is also required. I recommend to use at least a double core CPU
for the highest quality settings. CPU usage may vary depending on the settings of the emulator.
You also need a soundcard (16 bit sampling at 44.1KHz-96KHz). Sound output is mono or stereo (for specific tunes).
6. Which music formats does JSIDPlay2 support?
SID - HVSC format (containing one or multiple songs)
MUS - CGSC stereo format (voices 1-3)
STR - CGSC stereo format (voices 4-6)
DAT - SID music data
PRG - C64 program files (a C64 program)
P00 - C64 program files (a C64 program)
Because JSIDPlay2 is a complete C64 emulator, it supports additional peripherals like the Floppy C1541,
the Datasette C1530 and plugged-in Cartridges. These are emulated using the following file extensions
as a replacement of the Floppy disk, the tape and the cartridge.
D64 - Disk image
G64 - Disk image
TAP - Tape image
T64 - Tape image
REU - Ram Expansion Unit memory dump
CRT - Cartridge memory dump
In some rare cases SID music is part of a Floppy disk or a tape or a cartridge, which must be inserted first,
but normally just loading a single file should do the job just fine.
Note: Not supported in the HVSC are Amiga PlaySID and sidplay1 music formats, which are identified by
"_PSID.sid" extension. But these are removed from HVSC these days.
7. What sound output JSIDPlay2 supports?
Normally a sound card is used to play music, but you can choose the following things alternatively:
- Buy a HardSID4U soundcard for your PC (www.hardsid.com) and choose that for sound output. Connection is via USB cable.
- Listen a tune and write a WAV file to your harddisk at the same time.
- Switch between an MP3
recording and the emulation while playback to judge the emulators quality.
8. How can I use JSIDPlay2, what sort of software is it?
JSIDPlay2 is software which can be started as
- an application with a user interface (UI) to control the player using the mouse and keyboard.
- a console player controlled by keyboard
- an applet to be embedded in a web-page with or without a UI.
- a Network SID Device to be used with ACID64 (http://www.acid64.com) altogether with HardSID4U sound-cards (http://www.hardsid.com).
So you got one program, that can be used in multiple ways.
9. How to start JSIDPlay2?
That depends on what you want to start.
- For the UI version:
Type "jsidplay2.exe" (Windows)
or Type "java -jar jsidlay2.jar" (Linux, Mac OS X)
- For the console player:
Type "jsidplay2_console.exe" (Windows)
or Type "java -jar jsidlay2_console.jar" (Linux, Mac OS X)
- For the Applet version embed these HTML tags to your web-site and sign all jars
or grant them proper access rights.
- Applet with UI:
<APPLET width="620" height="680" align="left"
archive="hsqldb.jar,jinput.jar,jl1.0.jar,jorbis.jar,mp3spi1.9.4.jar,photos.jar,t ritonus_jorbis-0.3.6.jar,tritonus_share.jar,jsidplay2.jar" code="applet.JSIDPlay2.class">
- Hidden Applet (without UI) playing a SID:
<APPLET name="jsidplay" code="c64jukebox.SIDPlay" archive="c64jukebox.jar" WIDTH=0 HEIGHT=0 MAYSCRIPT >
10. How compatible is JSIDPlay2?
JSIDPlay2 is known to be a very accurate C64 emulator.
It emulates all components of a C64 and some important peripherals.
The emulation is cycle exact and passes many test programs.
We now pass the entire Lorentz suite. The CPU compatibility should be very good.
We pass Lorenz suite's CIA tests, and various VICE testprograms. The CIA compatibility should be very good.
We have a reasonably good, cycle-exact simulation of the VIC, and pass some very complicated VICE testprograms
such as the irqdma suite. However, some sprite tests like those used by various emutesters,
and some inline video mode changes are buggy.
The disk drive is very compatible. All chips are emulated cycle exact, although a few loaders deny to work.
Sound work is always ongoing, but I consider the distortion emulation to be fairly complete and compatible.
We have started to add support for various classic cartridges and the CRT format. We can support normal 8k and 16k,
and some freezer cartridges.
Cartridge support is limited to Action Replay, Atomic Power, Comal80, Epyx FastLoader, Expert Cartridge,
Final Cartridge, Final Cartridge III (87, 88), Rexx Datentechnik and Zaxxon.
REU is supportet as well (16 MB), just check out the excellent BlueREU demo by Crest.
11. What does that mean: java.lang.UnsatisfiedLinkError: no jinput-dx8 in java.library.path
JSIDPlay2 has joystick support, but that is not directly supported in Java.
It loads a native library at runtime to do that.
This release ships with libraries for Windows, Linux and Mac OS X, other OSs will show this error message.
12. What does that mean: java.net.BindException: Address already in use: JVM_Bind
JSIDPlay2 creates a listen socket (port 6581) for the Network SID device. If the port number is
not available or an instance of JSIDPlay2 is already running, this warning message appears.
Credits go first to the original authors for doing such a great sidplay2 software!
Dag Lem reSID emulation engine
Michael Schwendt SidTune library, Sid2Wav support
and basis for xSID...
Simon White Sidplay2 music player library v2
Antti Lankila SID chip Distortion Simulation efforts (resid-fp)
and continuous development of the whole emulator
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA