--- SIDPlayer/README 2000/10/05 17:03:50 1.4 +++ SIDPlayer/README 2000/10/10 21:47:46 1.5 @@ -1,10 +1,8 @@ - SIDPlayer, Version 4.0 + SIDPlayer, Version 4.0 + A SID tune replayer - A SID tune replayer for BeOS - - Copyright (C) 1996-2000 Christian Bauer - Freely distributable + Copyright (C) 1996-2000 Christian Bauer License @@ -46,6 +44,18 @@ SID tunes is that they take very little in size. +System Requirements +------------------- + +SIDPlayer runs on all Unix systems supported by SDL (which includes Linux, +FreeBSD, Solaris and Irix) and on BeOS R4.5 or later versions. + +Successfully tested systems include: + - Linux/i386 + - BeOS/x86 R5 + - BeOS/ppc R4.5 + + Supported file formats ---------------------- @@ -54,8 +64,14 @@ files (these have the signature "PSID" i available on the Internet is in this format. -Using SIDPlayer ---------------- +Installing SIDPlayer +-------------------- + +See the file "INSTALL". + + +Using SIDPlayer under BeOS +-------------------------- SIDPlayer can be started from the Tracker or from the Shell. If you give the name of a PSID file as an argument from the Shell or drag a PSID file onto @@ -72,7 +88,7 @@ used to adjust the replay speed. The SIDPlayer menu has three items: - "About SIDPlayer" shows some information about SIDPlayer - - "Sound Control" opens the sound control window + - "Sound Control" opens the sound control window (see below) - "Quit" quits SIDPlayer To load another PSID file, drag it into the SIDPlayer window. To quit @@ -87,13 +103,23 @@ Some functions of SIDPlayer can also be Right arrow: Next song Q : Quit -SIDPlayer can also be used as an input plugin for CL-Amp by Claes Löfqvist. -Simply copy the program to your CL-Amp "Plugins" directory (you have to copy -it, placing a link won't work) and rename it to "in_SIDPlayer". + +Using SIDPlayer under Unix +-------------------------- + +SIDPlayer currently only works as a command-line application. It is invoked +as follows: + + sidplayer FILE [song_number] + +"FILE" is the name of the PSID file to be loaded. The optional "song_number" +specifies the number of the song to be player (instead of the default song). +SIDPlayer cannot detect when a song has finished, so you have to use Ctrl-C +to quit it. -The Sound Control window ------------------------- +The Sound Control window (BeOS only) +------------------------------------ Sound post-processing is controlled with the "Effect" pop-up menu and the "Delay" and "Feedback" sliders. The available effects are "None" (no post- @@ -152,6 +178,7 @@ V4.0 - Now based on Frodo V5 CPU/SID cod faster/slower buttons by slider, added popup menu and sound control window, ported to BeOS R5 with new Media Kit, implemented CIA timer speed control, and SIDPlayer can now also be used as a CL-Amp plugin +V4.1 - Runs as a command-line application under Unix (requiring SDL) Christian Bauer