1 |
cebix |
1.1 |
|
2 |
cebix |
1.15 |
SIDPlayer |
3 |
cebix |
1.5 |
A SID tune replayer |
4 |
cebix |
1.1 |
|
5 |
cebix |
1.17 |
Copyright (C) 1996-2003 Christian Bauer |
6 |
cebix |
1.1 |
|
7 |
|
|
|
8 |
|
|
License |
9 |
|
|
------- |
10 |
|
|
|
11 |
|
|
SIDPlayer is available under the terms of the GNU General Public License. |
12 |
cebix |
1.10 |
See the file "COPYING" that is included in the distribution for details. |
13 |
cebix |
1.1 |
|
14 |
|
|
|
15 |
|
|
What is SIDPlayer? |
16 |
|
|
------------------ |
17 |
|
|
|
18 |
cebix |
1.3 |
SIDPlayer is a replayer program for C64 music ("SID tunes"), like PlaySID on |
19 |
cebix |
1.4 |
the Amiga or SIDPLAY for Unix. You can think of it as being a stripped-down |
20 |
cebix |
1.3 |
C64 emulator that only emulates the CPU and the sound chip of the C64. |
21 |
|
|
SIDPlayer can replay SID tunes in the "PSID" file format, but it cannot run |
22 |
|
|
any C64 programs. |
23 |
cebix |
1.1 |
|
24 |
|
|
|
25 |
|
|
Why would I want to listen to C64 music? |
26 |
|
|
---------------------------------------- |
27 |
|
|
|
28 |
|
|
The C64 had the most advanced sound capabilities of all home computers in |
29 |
|
|
the early 80's. While other computers of that time were only able to produce |
30 |
|
|
beeps, the C64 had a complete 3-voice analog synthesizer on its MOS 6581 |
31 |
|
|
sound chip (called "SID" - "Sound Interface Device"). Even some more modern |
32 |
|
|
computers (as the Atari ST or the first Macs) had worse sound. |
33 |
|
|
|
34 |
|
|
The SID chip features three oscillators with selectable waveform, ADSR |
35 |
cebix |
1.3 |
envelope generators, programmable resonance filters and special effects like |
36 |
|
|
ring modulation. With the aid of the CPU, it can also replay 4-bit sampled |
37 |
|
|
sounds. SIDPlayer emulates all features of the SID chip, including the |
38 |
|
|
filters. |
39 |
cebix |
1.1 |
|
40 |
|
|
There were (and are still) many composers programming excellent music for |
41 |
|
|
the C64 and thousands of tunes have been converted for use with SID tune |
42 |
|
|
replayers on nearly every existing computer platform. One big advantage of |
43 |
|
|
SID tunes is that they take very little hard disk space: most are only 4-8K |
44 |
|
|
in size. |
45 |
|
|
|
46 |
|
|
|
47 |
cebix |
1.5 |
System Requirements |
48 |
|
|
------------------- |
49 |
|
|
|
50 |
|
|
SIDPlayer runs on all Unix systems supported by SDL (which includes Linux, |
51 |
|
|
FreeBSD, Solaris and Irix) and on BeOS R4.5 or later versions. |
52 |
|
|
|
53 |
|
|
Successfully tested systems include: |
54 |
|
|
- Linux/i386 |
55 |
|
|
- BeOS/x86 R5 |
56 |
cebix |
1.18 |
- BeOS/ppc R5 |
57 |
cebix |
1.5 |
|
58 |
|
|
|
59 |
cebix |
1.1 |
Supported file formats |
60 |
|
|
---------------------- |
61 |
|
|
|
62 |
|
|
The only SID tune file format supported by SIDPlayer is single-file PSID |
63 |
|
|
files (these have the signature "PSID" in the first 4 bytes). Most SID music |
64 |
|
|
available on the Internet is in this format. |
65 |
|
|
|
66 |
|
|
|
67 |
cebix |
1.5 |
Installing SIDPlayer |
68 |
|
|
-------------------- |
69 |
|
|
|
70 |
|
|
See the file "INSTALL". |
71 |
|
|
|
72 |
|
|
|
73 |
|
|
Using SIDPlayer under BeOS |
74 |
|
|
-------------------------- |
75 |
cebix |
1.1 |
|
76 |
cebix |
1.3 |
SIDPlayer can be started from the Tracker or from the Shell. If you give the |
77 |
|
|
name of a PSID file as an argument from the Shell or drag a PSID file onto |
78 |
|
|
the SIDPlayer icon from the Tracker, that file is loaded and played. |
79 |
|
|
|
80 |
|
|
The SIDPlayer window displays some information about the currently loaded |
81 |
|
|
PSID file and has the usual tapedeck-like controls for pausing, restarting |
82 |
|
|
and stopping the replay and for selecting the next or previous song |
83 |
|
|
contained in the PSID file. The number of the song currently playing and the |
84 |
|
|
total number of songs in the loaded PSID file are displayed to the right of |
85 |
|
|
the tapedeck buttons. The slider in the bottom right of the window can be |
86 |
|
|
used to adjust the replay speed. |
87 |
cebix |
1.1 |
|
88 |
cebix |
1.3 |
The SIDPlayer menu has three items: |
89 |
cebix |
1.1 |
|
90 |
|
|
- "About SIDPlayer" shows some information about SIDPlayer |
91 |
cebix |
1.5 |
- "Sound Control" opens the sound control window (see below) |
92 |
cebix |
1.1 |
- "Quit" quits SIDPlayer |
93 |
|
|
|
94 |
|
|
To load another PSID file, drag it into the SIDPlayer window. To quit |
95 |
|
|
SIDPlayer, close the window or select the "Quit" menu item. |
96 |
|
|
|
97 |
|
|
Some functions of SIDPlayer can also be controlled with the keyboard: |
98 |
|
|
P : Play/pause |
99 |
|
|
S : Stop |
100 |
|
|
N : Next song |
101 |
|
|
Esc/Space : Stop |
102 |
|
|
Left arrow : Previous song |
103 |
|
|
Right arrow: Next song |
104 |
|
|
Q : Quit |
105 |
|
|
|
106 |
cebix |
1.5 |
|
107 |
|
|
Using SIDPlayer under Unix |
108 |
|
|
-------------------------- |
109 |
|
|
|
110 |
cebix |
1.17 |
SIDPlayer currently only works as a command line application. It is invoked |
111 |
cebix |
1.5 |
as follows: |
112 |
|
|
|
113 |
|
|
sidplayer FILE [song_number] |
114 |
|
|
|
115 |
|
|
"FILE" is the name of the PSID file to be loaded. The optional "song_number" |
116 |
|
|
specifies the number of the song to be player (instead of the default song). |
117 |
|
|
SIDPlayer cannot detect when a song has finished, so you have to use Ctrl-C |
118 |
|
|
to quit it. |
119 |
cebix |
1.1 |
|
120 |
cebix |
1.17 |
SIDPlayer accepts a number of command line arguments. Type "sidplayer --help" |
121 |
cebix |
1.16 |
to get a list. |
122 |
|
|
|
123 |
cebix |
1.17 |
If you have a Catweasel MK3 PCI card with a SID chip installed you can |
124 |
|
|
redirect the output of SIDPlayer to the card by specifying the "--cwsid on" |
125 |
|
|
command line argument. Visit www.jschoenfeld.de for more information about |
126 |
|
|
the Catweasel card. |
127 |
|
|
|
128 |
cebix |
1.1 |
|
129 |
cebix |
1.5 |
The Sound Control window (BeOS only) |
130 |
|
|
------------------------------------ |
131 |
cebix |
1.1 |
|
132 |
cebix |
1.3 |
Sound post-processing is controlled with the "Effect" pop-up menu and the |
133 |
|
|
"Delay" and "Feedback" sliders. The available effects are "None" (no post- |
134 |
|
|
processing), "Reverb" (simple reverb) and "Spatial" (reverb with phase |
135 |
|
|
shift, intended for headphone users). |
136 |
|
|
|
137 |
cebix |
1.1 |
The checkbox labeled "Filters" is used to turn the emulation of the SID |
138 |
|
|
filters on or off. |
139 |
|
|
|
140 |
cebix |
1.3 |
The "New SID Chip" checkbox selects the type of SID chip to be emulated. |
141 |
|
|
Currently this only affects some combined waveforms. |
142 |
|
|
|
143 |
|
|
The eight slider gadgets in the right part of the window control the stereo |
144 |
|
|
panning and volume of each of the four voices (3 synthesized voices, 1 |
145 |
|
|
sampled voice). |
146 |
cebix |
1.1 |
|
147 |
|
|
|
148 |
|
|
Where do I get PSID files |
149 |
|
|
------------------------- |
150 |
|
|
|
151 |
|
|
The two largest collections of SID tunes are the "High Voltage" SID |
152 |
cebix |
1.3 |
Collection (http://hvsc.c64.org) and the "NemeSIDs" archive |
153 |
|
|
(ftp://frodo.hiof.no/pub/c64/sidmusic). These have been used for testing |
154 |
|
|
during the development of SIDPlayer and they should all work. |
155 |
|
|
|
156 |
|
|
Twenty demonstration SID tunes are included with SIDPlayer in the "PSID |
157 |
|
|
Demo" directory. |
158 |
|
|
|
159 |
|
|
|
160 |
|
|
Support |
161 |
|
|
------- |
162 |
|
|
|
163 |
|
|
Updates of SIDPlayer are available on the official SIDPlayer home page: |
164 |
cebix |
1.1 |
|
165 |
cebix |
1.3 |
http://www.uni-mainz.de/~bauec002/SPMain.html |
166 |
cebix |
1.1 |
|
167 |
|
|
|
168 |
|
|
History |
169 |
|
|
------- |
170 |
|
|
|
171 |
|
|
V1.0 - First release |
172 |
|
|
V2.0 - SID filter emulation, better envelope generation |
173 |
|
|
V2.1 - Implemented notch filter, 60Hz replay now works, added faster/ |
174 |
|
|
slower buttons, compiled for BeOS DR8 |
175 |
|
|
V2.2 - Improved the 6510, triangle waveform is now 12 bits, output |
176 |
|
|
clipping, stereo output, corrected SID sustain behaviour, |
177 |
|
|
reading from a write-only SID register returns the last byte |
178 |
|
|
written to the SID, combined waveforms sampled from a 6581R4 |
179 |
|
|
V2.3 - Corrected BRK, DCP, ARR and LAS instructions, volume levels up |
180 |
|
|
to 200% possible, compiled for BeOS DR9 |
181 |
|
|
V2.4 - Shows name/author/copyright in ISO-Latin1 |
182 |
|
|
V2.5 - Converted panning/volume sliders to BSlider class |
183 |
|
|
V3.0 - Unified PPC/x86 release |
184 |
|
|
V4.0 - Now based on Frodo V5 CPU/SID code (more efficient CPU emulation, |
185 |
|
|
post-processing effects (reverb, spatial), prefs manager), replaced |
186 |
|
|
faster/slower buttons by slider, added popup menu and sound control |
187 |
|
|
window, ported to BeOS R5 with new Media Kit, implemented CIA timer |
188 |
|
|
speed control, and SIDPlayer can now also be used as a CL-Amp plugin |
189 |
cebix |
1.17 |
V4.1 - Runs as a command line application under Unix (requiring SDL), |
190 |
cebix |
1.12 |
preferences items can be passed on the command line, and SIDPlayer |
191 |
|
|
can now also be used as a SoundPlay plugin |
192 |
cebix |
1.16 |
V4.2 - Fixed writes to mirrored SID registers, output to WAV file is possible |
193 |
|
|
in SDL version |
194 |
cebix |
1.17 |
V4.3 - Added support for Catweasel SID hardware in SDL version (use option |
195 |
|
|
"--cwsid on"), CIA timer speed control now actually works |
196 |
cebix |
1.18 |
V4.4 - Fixed a problem with the wrong replay routine being called when the |
197 |
|
|
IRQ vector was changed. Mastercomposer tunes (and probably others) |
198 |
|
|
not play correctly. [Thanks to Stefano Tognon.] |
199 |
cebix |
1.1 |
|
200 |
|
|
|
201 |
cebix |
1.13 |
Acknowledgements |
202 |
|
|
---------------- |
203 |
|
|
|
204 |
|
|
Special thanks go to Claes Löfqvist and Marco Nelissen for their help with |
205 |
|
|
adding CL-Amp and SoundPlay plugin support. |
206 |
|
|
|
207 |
|
|
|
208 |
cebix |
1.1 |
Christian Bauer |
209 |
|
|
<Christian.Bauer@uni-mainz.de> |