NAME
SIDPLAY - Sidplay is SID-chip emulator for playing Commodore 64 music.
SYNOPSIS
sidplay [ OPTIONS... ] <datafile>
sidplay2 [ OPTIONS... ] <datafile>
DESCRIPTION
Sidplay is a music player that emulates various components from a
Commodore 64 (C64) computer. The result is a program which can load
and execute C64 machine code programs which produce music and sound.
This page covers both Sidplay versions 1 and 2, Sidplay being an frame
based emulation capable of playback on low specification PCs.
Sidplay2 on the other hand has been designed for accuracy which results
in a much higher cpu usage. Additional playback modes have however
been provided to allow playback on low specification machines at the
cost of accuracy, but it still has a higher cpu demand than Sidplay.
COMMON OPTIONS
--help|-h
Display help.
-f<num>
Set frequency in Hz (default: 44100).
-nf No filter emulation. This will reduce CPU overhead at the cost
of reduced sound quality.
-ns Emulate MOS8580 waveforms (default: MOS6581).
-o<num>
Select track number (default: preset).
-s Stereo Hardware support. For Sidplay the channels for the sid
will be split into left and right creating a stereo effect. The
same effect is present for Sidplay2 unless the tune is
identified as stereo. If this is the case then sid 1 and 2
become the left and right channels respectively. For Sidplay
other options are provided to produce special effects when in
stereo mode, but Sidplay2 does not as yet support these.
-v Verbose output while playing.
SIDPLAY2 OPTIONS
-b<num>
Set start time in [mins]:secs format (compatible with sid2wav).
-fd Force dual sid environment. This forces emulation of 2 sid-
chips for stereo playback even if datafile is identified as only
being mono. This occurs in the case of the stereo sid format as
currently there is no way to identify them. Stereo MUS files
are however automatically detected. The second sid appears in
the 0xD500 address range. -fs By default all samples are played
through the SIDs master volume. This can cause the SIDs voices
to become disturbed and slightly noisy, but generally no worse
than the original tune. This switch can be used to move the
samples to there own channel on the soundcard to avoid this
problem. Note that this is incompatible with some emulations
and will cause he samples to be lost e.g. HardSID.
-m<b|r>
Mode switch (default -mr). Currently supported modes are:
Sidplays Bankswitching Mode (-mb).
Sidplay2s Real C64 emulation mode (-mr).
-nf<filter>
New SID filter definition. This will redefine ReSIDs internal
filter (see the sidplay2 homepage for the file format).
-p<num>
Set bit precision for samples. The default is 16, but this value
will be affected by the hardware available on the platform you
are running.
-O<num>
Optimisation level (default: 0). Increasing the optimisation
level will improve the performance of sidplay2 at the cost of
accuracy. The maximum optimisation level can be found using
-o<l|s>
Option ’l’ will select continuous track looping while ’s’ will
select the current track instead of all. This option can be
combined with the track selection to form -ols<num>.
-q Quiet output while playing (opposite of verbose).
-s<l|r>
Playback the left or right stereo channel only.
-t<num>
Set play length in [mins]:secs format (0 is endless).
-v<n|p>[f]
Set VIC clock speed. ’n’ is NTSC (America, 60Hz) and ’p’ is PAL
(Europe, 50Hz). Providing an ’f’ will prevent speed fixing that
tries to compensate automatically for the speed difference.
Removing speed speed fixing simulates what happens on a real
C64. Options can be written as: -vnf or -vn -vf.
-w[name]|--wav[name]
Create WAV-file. The default output filename is
<datafile>[n].wav where [n] is the tune number should there be
more than one in the sid. This allows batch conversion of sid
tunes without them overwriting each other. By providing a name
you override this default behavior. The output file will be
<name> with no tune number is added and <name> IS NOT checked
for or appended with a legal wav file extension.
SIDPLAY OPTIONS
-a strict PlaySID song compatibility (read the docs!).
-a2 bank switching mode (overrides -a).
-16 enable 16-bit sample mixing.
-ss enable stereo surround.
-pc enable centered auto-panning (stereo only).
-n set NTSC clock speed (default: PAL).
-c force song speed = clock speed (PAL/NTSC).
-bn<num>
set number of audio buffer fragments to use.
-bs<num>
set size 2^<num> of audio buffer fragments.
-b<num>
set sample buffer size.
NOTES
Place for notes..
OTHER INFORMATION
Sidplay2 Homepage:
http://sidplay2.sourceforge.net/
Sidplay homepage:
http://www.geocities.com/SiliconValley/Lakes/5147/
High Voltage Sid Collection (HVSC):
http://hvsc.c64.org/
AUTHORS
sidplay2 - Simon White <sidplay2@yahoo.com>
sidplay - Michael Schwendt <sidplay@geocities.com>
reSID engine - Dag Lem <resid@nimrod.no>
man-page - Mikko Kilponen <mikil@uni.kaapeli.net>