bionic (1) sidplay2.1.gz

Provided by: sidplay_2.0.9-6ubuntu3_amd64 bug

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>