ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/SIDPlayer/README
(Generate patch)

Comparing SIDPlayer/README (file contents):
Revision 1.3 by cebix, 2000-09-18T22:41:23Z vs.
Revision 1.18 by cebix, 2003-10-23T13:12:08Z

# Line 1 | Line 1
1  
2 <        SIDPlayer, Version 4.0
2 >  SIDPlayer
3 >  A SID tune replayer
4  
5 <        A SID tune replayer for BeOS
5 <
6 <        Copyright (C) 1996-2000 Christian Bauer
7 <        Freely distributable
5 >  Copyright (C) 1996-2003 Christian Bauer
6  
7  
8   License
# Line 18 | Line 16 | What is SIDPlayer?
16   ------------------
17  
18   SIDPlayer is a replayer program for C64 music ("SID tunes"), like PlaySID on
19 < the Amiga or SIDPLAY for Unix. You can think of it as being a stripped- down
19 > the Amiga or SIDPLAY for Unix. You can think of it as being a stripped-down
20   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.
# Line 46 | Line 44 | SID tunes is that they take very little
44   in size.
45  
46  
47 + 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 + - BeOS/ppc R5
57 +
58 +
59   Supported file formats
60   ----------------------
61  
# Line 54 | Line 64 | files (these have the signature "PSID" i
64   available on the Internet is in this format.
65  
66  
67 < Using SIDPlayer
68 < ---------------
67 > Installing SIDPlayer
68 > --------------------
69 >
70 > See the file "INSTALL".
71 >
72 >
73 > Using SIDPlayer under BeOS
74 > --------------------------
75  
76   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
# Line 72 | Line 88 | used to adjust the replay speed.
88   The SIDPlayer menu has three items:
89  
90   - "About SIDPlayer" shows some information about SIDPlayer
91 < - "Sound Control" opens the sound control window
91 > - "Sound Control" opens the sound control window (see below)
92   - "Quit" quits SIDPlayer
93  
94   To load another PSID file, drag it into the SIDPlayer window. To quit
# Line 87 | Line 103 | Some functions of SIDPlayer can also be
103    Right arrow: Next song
104    Q          : Quit
105  
90 SIDPlayer can also be used as an input plugin for CL-Amp by Claes Löfqvist.
91 Simply copy the program to your CL-Amp "Plugins" directory (you have to copy
92 it, placing a link won't work) and rename it to "in_SIDPlayer".
106  
107 + Using SIDPlayer under Unix
108 + --------------------------
109 +
110 + SIDPlayer currently only works as a command line application. It is invoked
111 + as follows:
112  
113 < The Sound Control window
114 < ------------------------
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 >
120 > SIDPlayer accepts a number of command line arguments. Type "sidplayer --help"
121 > to get a list.
122 >
123 > 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 >
129 > The Sound Control window (BeOS only)
130 > ------------------------------------
131  
132   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-
# Line 152 | Line 186 | V4.0 - Now based on Frodo V5 CPU/SID cod
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 + V4.1 - Runs as a command line application under Unix (requiring SDL),
190 +       preferences items can be passed on the command line, and SIDPlayer
191 +       can now also be used as a SoundPlay plugin
192 + V4.2 - Fixed writes to mirrored SID registers, output to WAV file is possible
193 +       in SDL version
194 + V4.3 - Added support for Catweasel SID hardware in SDL version (use option
195 +       "--cwsid on"), CIA timer speed control now actually works
196 + 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 +
200 +
201 + 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   Christian Bauer

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines