SIDPLAY(1)						      General Commands Manual							SIDPLAY(1)

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  accu-
	      racy.  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>

SID Player Application						 19 September 2000							SIDPLAY(1)