// Do not modify... the help window relies on it
// Best viewed with an editor / font with fixed-width letters
// Topics with an leading ! will not be displayed in kiosk mode
// Not compatible with QuickPlayer 1.00 beta 23 or older versions
// The // at the beginning of a line prevents QuickPlayer from showing it in the
// help window.
// The text width is 57 characters to fit in the help window textbox.
//
// The first chapter should be the Tutorial

Tutorial
--------

  This document will give you additional information of
  QuickPlayers features. It will not contain any infor-
  mation about basic features that any player offers.

  You can open the help window from within QuickPlayer:
  Simply press the F1 key in the Player window.

  It's recommend that you read this document carefully to
  get full usage of all features in QuickPlayer.

  This file is also found in your QuickPlayer directory
  named QPlayer.txt or Readme.txt

About / What is QuickPlayer
---------------------------

  Thanks for using QuickPlayer.
  QuickPlayer is an GUI (Graphical User Interface) for
  sound systems, e.g. Firelight Technologie's fmod.dll
  (http://www.fmod.org), or BASS Audio library (by Ian
  Luck) (http://www.un4seen.com)

  This means, QuickPlayer manages the playlist, menus,
  options, ... (What you actually see) and uses a sound
  system (dll) to play (...) sounds/music (What you hear)
  (load/play/pause/volume/time/seek/...).
  
  QuickPlayer gives you some of the best features a
  player could have.

  As long there are bugs or requests, QuickPlayer is
  under development. The latest official version can be
  found at http://www.ctuser.net. For suggestions,
  questions, requests or bug reports, send eMail to
  info@ctuser.net.
  
  So I optimized code (sharing, groups, ...), size grew
  with each new feature. QuickPlayer has now approximate
  850kb / compressed 240kb.
  The source code & resources take about 830kb
  (18000 lines / 210kb pure code)

Features
--------

  Please note that some features must be activated to be
  used

   - Add playlist feature
   - Automatic playback
   - AutoRefresh for directories
   - Built-in help system
   - Check for accurate streams
   - Command line options for special behaviours, can
     also be specified using a CMD file
   - Copy title/filename/file informations (as text to
     clipboard) feature
   - Crossfading
   - Customizeable action for trayicon click and playlist
     doubleclick
   - Customizeable controls for most common functions
   - Delete file(s) (stops current song if required)
   - Dropdown list of last 1024 (currently 1024!) played
     songs
   - End songs after ... minutes (depending on format)
   - "End song" feature (will simulate song end)
   - Fading on (un)pause / stop / skip / quit / output
     device change / ...
   - Failsave
   - Find current / next song in playlist
   - Flat buttons
   - Full drag'n'drop, (e.g. Drag to windows explorer or
     recording software), with menu when dropping using
     right mouse button
   - Icon indicating mp3 / Ogg vorbis quality (Details
     shown as tooltip text
   - "Ignore files / directories beginning with # or _"
   - Keyboard LED mode (command line option) for state
     information without screen
   - Kiosk mode and other command line parameters to
     disable features
   - MiniDisk Record mode (2 Sec. pause between tracks)
   - Minimize to tray
   - Mouse gestures
   - Multilanguage support using a language file
   - Multiple timer events, e.g. to start/stop playback,
     skip songs or quit/shutdown windows.
   - "Play next" feature
   - Parallel window feature: no window is disabled,
     except when crossfading / refreshing directories     
   - Presets to quickly change multiple settings
     Built-in preset manager
   - Quick Playlist access menu
   - (Re)Load / Save playlist (as)
   - "Remove missing songs", "Remove played songs" and
     "Remove manually skipped/ended songs" feature
   - Repeat single track feature
   - Reset sound system feature
   - "Refresh CD contents" feature (Browses the whole CD
     for supported files, not only audiotracks)
   - "Show in Explorer" feature
   - "Show titles when minimized"
   - Shutdown dialog to abort timer based shutdowns
   - Simple, inituitive interface
   - Simple MP3 / Ogg Vorbis ID3-tag information
   - Simple / extended spectrum analyzer
   - Smart output device changing (stops song, applies
     settings and resumes; fadeout / fadein supported)
   - Smart registering for playlist files (Does not
     conflict with other programs if not set as default
     playlist program)
   - Smart song processing (stops loading if not
     sucessfull within about 2 secs)
   - Sorting (directories/files)
   - Standard windows messaging support
   - "Stop after each song" feature
   - Structured playlist and directory list
   - System tray icon reloaded each 5 minutes (explorer
     may have crashed... )

System Requirements
-------------------
  (according to Microsoft)
   - Pentium 90MHz / higher
   - VGA 640x480 or higher
   - 24MB RAM for Windows 95 / 32MB for Windows NT.
   - Microsoft Windows NT 3.51 / 95 or later (Windows 95
     users may need DCOM update (or at least one file of)
  (for FMod / QuickPlayer)
   - FMod compatible sound card
   - FMod 3.62 or higher (3.71 or higher recommend;
     QuickPlayer crashes with 3.70 frequently)
     Versions newer than 3.74 have not been tested.
     Original 3.71 shows incorrectly 3.70 as version,
     but is detected correctly as 3.71 in QuickPlayer)
  (for BASS / QuickPlayer)
   - BASS 2.01
   - (optional:) matching bassflac/basswma.basscd.dll
   - DirectX 3 or higher

Copying / License / ...
-----------------------

  QuickPlayer is free software; you can redistribute it
  and/or modify it under the terms of the GNU General
  Public License as published by the Free Software
  Foundation; either version 2 of the License, or (at
  your option) any later version.

  This program is distributed in the hope that it will be
  useful, but WITHOUT ANY WARRANTY; without even the
  implied warranty of MERCHANTABILITY or FITNESS FOR A
  PARTICULAR PURPOSE.  See the GNU General Public License
  for more details.

  You should have received a copy of the GNU General
  Public License along with this program; if not, write
  to the Free Software Foundation, Inc., 59 Temple Place,
  Suite 330, Boston, MA  02111-1307  USA

  If you have any questions, suggestions or bug reports
  about this product, contact me: info@ctuser.net; Do not
  contact me about general B.A.S.I.C. language or A.P.I.
  issues

  Files (depending on which package you downloaded, not
  all files may be included):

    BASS.dll      required   for BASS sound system
    BASScd.dll   (required)  adds cd support for BASS
    BASSflak.dll (required)  adds flak support for BASS
    BASSwma.dll  (required)  adds wma support for BASS
    FMod.dll      required   for FMod sound system
    Histroy.txt   readme     information about changes
    License.txt   license    GNU General Public License
    msvbvm60.dll  required
    QPlayer.exe  (required)  executable
   (QPlayer.lng) (language)  language file; not required
                             for english version 
    QPlayer.txt   readme     information / help
    vb6os.zip     source     Source code (Visual Basic 6)
                             and related readme files,
                             also contains a copy of the
                             GNU General Public License

  If you want to localize QuickPlayer please contact me:
  info@ctuser.net

!Known problems, Behaviours, Bugs, Errors, Problems
---------------------------------------------------

  Spectrum analyzer: The spectrum analyzer does not show
  the full spectrum, just a small spectrum (It's a cool
  visualization). I tried full and some larger spectrum
  settings, but it was boring to look at. Depends on
  volume.

  Known problems:
   - MP3/OGG tag reading may not work properly on some
     files (I have no detail information about, I just
     viewed these files with a hexeditor (RAR) and tried
     to 'guess')
     It will work on some non-standart id3v2 tags (e.g.
     tags containing jpeg images... I found one file,
     according to file contents it was encoded/created
     by Real Jukebox)
   - During usage of menus (and similar events),
     QuickPlayer may not handle different events
     (e.g. Fade in/out will pause until menu usage has
     finished).
     Also, QuickPlayer will not react on menu clicks when
     crossfading, refreshing, ...
   - Skipping tracks will use previous/next playlist
     entry, not last played tracks. On random mode,
     QuickPlayer will always play a random playlist item.
     (I actually think that function is almost obsolete,
     but some people may miss it...?)
   - When clicking on the trayicon to restore QuickPlayer
     window, the next trayicon may also recognize a
     clickevent (depending on trayicon-settings)
   - QuickPlayer may accept commands (keyboard/clicks) so
     it should NOT react on (e.g. during fading, refresh)
     If you find anything like that, please eMail me
     (info@ctuser.net)
   - QuickPlayer may crash on some Trackers or faulty
     MP3s (should be a sound system problem)
   - When crossfading to streams (wav/mp3/wma...) from
     the same CD, sound might 'stutter'
   - When using Ctrl+[key], and releasing Ctrl before
     [key], QuickPlayer may react on [key]
     (e.g.: Ctrl+C  ->  Clear playlist
                 C  ->  Pause)
   - For Audio CD related problems, see "Audio CDs"
     section
   - When QuickPlayer does not get enough resources, it
     sometimes aborts (ends) the current song and goes to
     the next one (well, not really a problem, is it?)
   - No crossfading when both current and next item are
     audio CD tracks, wether on the same device (drive
     letter) or not.
   - No crossfading whem both current and next item are
     Midi files
   - Sound may stutter after several hours, e.g. on my
     system when using Sound mapper (Win98/SB Live Value)
     After about the same time it will be correct again.
     Use the 'Reset sound system' function from the menu
     to fix. Affects streams, not yet sure if also
     affects tracker or cdda audio playback / ...
   - On Windows 98 (Win9x?) when using a large playlist,
     QuickPlayer will hang for some time when quitting.
     Seems to be a Windows/Visual Basic Memory management
     problem.
   - When more than 32736 items are used, QuickPlayer may
     crash. I added code to prevent QuickPlayer from
     using more than 32736 items, but I've not tested all
     circumstances. If you find such a problem, write an
     eMail (info@ctuser.net)
   - Enhanced multiselect works with mouse only (Visual
     Basic problem)
   - Applications hang when causing certain windows
     events (e.g. System color changes) while QuickPlayer
     is busy (e.g. Crossfade, reading songs, ...)

  Other (un)known behaviours:
   - When starting the program "Handle" from SysInternals
     (www.sysinternals.com), the current played songs
     restarts from the beginning, but process indicator
     is still the old. The song will be aborted according
     to process indicator.

  As QuickPlayer uses an external dll-file (bass/
  fmod.dll), any problem/error could be:
   - QuickPlayer error/bug
   - BASS / FMod.dll error/bug
   - other software error/bug (e.g. Operating system)
   - multimedia device problem (e.g. no device, device not
     installed (properly), device in use by other appli-
     cation; incompatibility; directx problem)
   - media error (invalid/damaged file)

  What you should do:
  Of course I'm testing my software and find most errors
  myself. Additionally, some friends of mine actual /
  nonofficial releases. If you find an error anyway
  (that's why it's a beta), here's what you should check
  first:
 
  FIRST of all, please check if you have both the latest
  versions of QuickPlayer (http://www.ctuser.net) and
  your sound system:
  
  BASS.dll: http://www.un4seen.com
     You need BASS.dll 2.01
  FMod.dll: http://www.fmod.org
     You need at least fmod 3.62 or higher ! (3.71 or
     higher recommend; QuickPlayer may crash on older
     versions); Versions newer than 3.74 have not been
     tested, Version; 3.70 crashes frequently. Original
     3.71 shows incorrectly 3.70 as version, but is
     detected correctly as 3.71 in QuickPlayer)

   - Check if it is a invalid/damaged file, or if the
     error occurs with a specific file only
   - Please also check if the error depends on one or
     more settings (repeat mode, fading, ...)
   - Test other players
   - Test same media file with other players
   - Test same media file with other players using the
     same sound system

  If the error occurs with QuickPlayer only, try to find
  out what you did that caused the error (bug) and the
  easiest way to reproduce this error and eMail your
  report (and maybe required files if below 300kb) to
  info@ctuser.net.

!Stop/Skip/Next/End song, Play next - Differences
-------------------------------------------------

  Stop:      Stops current song. Does not jump to next
             item. No post-processing (When "Play next"
             is set, QuickPlayer will not stop but re-
             move your "Play next" command.)
  Next song: Stops current song and play next item
   (skip)    "Remove played song", "stop each song" and
             "MD Record Mode" options are NOT processed,
             "Remove manually skipped/ended songs" is
             processed.
  End song:  Stops current song (simulates the current
             song has ended) and plays next item. All
             "Remove played song", "stop each song",
             "MiniDisk Record Mode" AND "Remove skipped
             songs"  options are processed
  Play next: Selected playlist item will be played after
             the current item. To skip a "Play next"
             command, press "Stop" once (does not stop
             current song)

!Volume
-------

  So the volume slider shows a large green, a yellow and
  a red area, the output level is never 'overloaded',
  not even at maximum. However, on most soundcards the
  soundcard output is 'overloaded' when both application
  and soundcard volume(s) is/are on maximum. In that case
  you should slightly reduce your soundcards volume(s)
  (either global volume or Wave/DirectSound slider, or
  both)

!Drag'n'Drop
------------

  You can drag and drop any supported file in QuickPlayer

  Dropping on the form or playlist will insert file(s).
  Dropping on the form or playlist with right mouse
  button will insert file(s) and open a menu for further
  actions.

  Dropping on the play buttons will insert file(s), mark
  the first inserted file, and:
   - Previous button: dropping not supported
   - Play button:     Play new file(s) immediately
                      (no crossfade/...)
   - Pause button:    No additional function
   - Stop button:     No additional function
   - Next button:     Play new file(s) after current song
   - End song button: Ends current song, play new file(s)
                      (supports crossfade, stop each
                      song, ...)

  You can also drag items from your playlist to the
  explorer or other programs. (Dragging to the explorer
  will copy files)

MP3/Ogg Vorbis Format Icon
--------------------------

  Requires "Read MP3/Ogg vorbis format" to be activated
  (Options, More settings, Supported formats)

  MP3 Icon      Description
  -------------------------------------------------------
  X             No information available
  Brown ?       An error occured detecting format
                (or non-standard-format)
  Red           Low Quality (below 113kbs/44kHz) or mono
  Red Checked   64kbs/mono, 96kbs/mono or joint stereo,
                or 128kbs/stereo;
                22 or 44kHz, MPeg Version 1 Layer 3,
                Constant bitrate
  Blue          113-143kbs/44kHz
  Blue Checked  128kbs/44kHz, MPeg Version 1 Layer 3
                Constant bitrate
  Green         High Quality; 144kbps/44kHz or higher
  Green Checked High Quality (192kbs/44kHz)
                MPeg Version 1 Layer 3, Constant bitrate

  Ogg Vorbis Icon             Description
  -------------------------------------------------------
  X             No information available
  Brown ?       An error occured detecting format
                (or non-standard-format)
  Red           Low Quality (below 128kbs/44kHz) or mono
  Blue          80-135kbs/44kHz, stereo
  Blue Checked  ~110kbps/44kHz, stereo
  Green         High Quality (at least 135kbps,
                44kHz or higher, stereo or more channels
  Green Checked ~160kbps/44KHz, stereo

  (Ogg Vorbis icons will be improved when I'm more
  familiar with Ogg vorbis recommend formats)
  (Bitrates for Ogg Vorbis files are nominal bitrate)

!Automatic Playback
-------------------

  Be sure "Automatic playback" is activated (Options,
  More settings, Advanced)

  Whenever you start playback (Play-Button, Menu, ...),
  and playback will be stopped (error, empty playlist),
  QuickPlayer automatically will retry playback after one
  minute. Pressing "Stop" will disable automatic playback
  (When "Play next" is set, QuickPlayer will not stop /
  disable "Automatic Playback", but remove your "Play
  next" command.), pressing "Play" will reactivate it.

Audio CDs
---------

  Multiple CD-Drives:
  QuickPlayer does not detect Audio-tracks from CD-Rom
  drives. Whenever you specify a CDA file, CD playback
  for the according drive will be started.
  
  No crossfading when both current and next item are
  audio CD tracks, wether on the same device (drive
  letter) or not.
  
  (When not using CDDA (off by default)), be sure the CD
  drive you use for audio cds is connected to the "Audio
  CD" input on your soundcard (not Dat In, or Auxilary).
  Otherwise volume changes won't work (affects fading /
  crossfading / volume / ...). Whenever using audio CDs,
  this may change the global volume setting for Audio
  CDs.

  Jitter correction will speed up CDDA, however, on some
  drives playback will not work properly without.

  When using fmod.dll older than 3.72, it may occur that
  songs are skipped so the track is not yet finished.
  Update to fmod 3.72 will fix it.

!Kiosk mode
-----------

  When starting QuickPlayer with the "/locked" command
  line parameter, QuickPlayer will use the kiosk mode.
  This mode is designed when using QuickPlayer for
  playback on public computers to prevent the user from
  aborting playback but give him the possibility to see
  the Player. The user can search songs in the playlist,
  change between playlists found in QuickPlayer directory
  choose the next song, depending on "Playlist
  doubleclick" setting, even skip or end songs. Therefor,
  QuickPlayer will hide most menus and overwrite some
  settings.
  
  It's recommed to check all playlists in the QuickPlayer
  directory are functional. Additional, you may want to
  define QuickPlayer as windows shell and start with the
  "/SHELL" command (QuickPlayer will show the Windows
  shutdown dialog instead of quitting).
  You may also startup with other settings, using the
  "/BASE=..." command line parameter
  Globalkeys will still be active, but denied keys will
  not work.
  Use /VOLUME parameter to allow volume changing (+/-)
  Use /CD to allow the "Refresh CD content" function.
  Use /MSG to allow messaging in kiosk mode

  Check the other commandline parameters for other
  features.

Keyboard shortcuts
------------------

  All functions are available via menu. The keyboard
  command / shortcut is mentioned there, e.g.:

  Play      X      -> Pressing x will start playback
  Find...   Ctrl+F -> Pressing Ctrl+F will open the find
                      window
  (Note that some menu items are not recommend to be used
  within the menu and are shown only if a key is defined
  so you can look up the keyboard command)

  You can customize these controls in the setup window
  (Options, More settings, Keyboard setup).

  The shortcuts shown in the keyboard setup list are:
  C=Control (Ctrl), S=Shift, A=Alt
  CS=Control+Shift (Ctrl+Shift),
  CA=Control+Alt (Ctrl+Alt)

  When using Ctrl+[key], be shure to release [key]
  before releasing Ctrl, or QuickPlayer may react on
  [key]

  If Globalkeys are activated, you can press Ctrl+Alt+
  <Key> to control QuickPlayer, with no need that
  QuickPlayer is the current application / form

  If keyboard commands don't work, you may have to press
  tab once or click on your playlist once.

!Mouse Gestures
---------------

  (Thanks to Opera Software (http://www.opera.com) for
  using gestures. Once used to gestures, I liked them, so
  I decided to support gestures for QuickPlayer, too.)
  
  Be sure Mouse gestures are activated (General settings)
  
  Mouse gestures allow you to do actions by special
  mousemoves. Do do this, rightclick on the playlist (be
  shure not to click on an marked item), hold down and
  move...

  Left          Previous track
  Left   Up     Pause
  Left   Down   Stop
  Right         Play
  Right  Up     Next track
  Right  Down   End song
  Up            Play next
  Up     Left   Add file(s)
  Up     Right  Add directory
  Down          Restore window
  Down   Left   Maximixe
  Down   Right  Minimize

!End songs after ... minutes
----------------------------

  The "End songs after ... minutes" setting affects the
  time the current song really has been played, not the
  current position.
  It's designed to prevent tracker/midi/CD Audio from
  playing continous.

!Autorefresh
------------

  Directories that will be automatically refreshed on
  demand, when needed, or after a specified time.

  Saved with the playlist; Merged with existing playlist
  when appending a playlist.

  Delayed autorefresh stops playback and clears all play-
  list items and restarts playback after one minute.
  Designed for background playback without a monitor to
  allow CD-changing without getting a bluescreen.
  (LED mode recommend)

!Recording support
------------------

  QuickPlayer does not support recording / cd recording
  itself, but as it supports full drag'n'drop, you can
  simply drag any song(s) to your favourite recording
  software.

!Timers
-------

  To load timers on startup, use the /LOADTIMER[=file]
  command line parameter.
  
  Additionally, when importing timers, you can use a
  relative time (+30 means 30 minutes later):
  Timer file syntax:
    <time>: <events>[<description>][{<playlistfile>}]
   - Open your *.qpt
   - Edit your line
       e.g. 1210: 100600 LoadPlaylist{C:\Test.m3u}
       to     +30: 100600 LoadPlaylist{C:\Test.m3u}

!LED state
----------

  Requires /LED command line parameter; Overwrites built-
  in spectrum analyzer.
  
  By default, the spectrum is displayed (NumLock-> Scroll-
  lock.
  For special state information, the first LED (NumLock)
  is OFF; this means:
    CAPS:             Stopped
    CAPS, blinking:   Paused
    SCROLL:           Crossfading 
    SCROLL, blinking: Refreshing

  All LED: Playing with spectrum, or startup/quitting/
           output mode change;
  All LED blinking: Empty playlist and/or delayed
                    autorefresh

  Please also read section autorefresh for 'Delayed auto-
  refresh' information

!Command line parameters
------------------------

  Please note that some parameters are useless when [not]
  used with other parameters.

  <Playlist>
  /BASE=<path\file> Instructs QuickPlayer to use another
                    filename for settings, playlist and
                    presets. Filename should not have an
                    extension.
  /CD               Shows "Refresh CD contents" menu in
                    kiosk mode
  /CMD or           Use CMD file as additional parameters
    /+ or
    /#
  /DEFAULT          Skips loading settings, uses defaults
  /FAILSAVE         Skips loading settings, uses defaults
  /FS               Player starts fullscreen
  /HIDETASK         QuickPlayer will not be shown in the
                    task manager (Win9x only)
                    (not recommend!)
  /INFO[1-9]        Shows info window (use 1-9 for window
                    position, according to numpad).
  /KIOSK[:options]   "Kiosk mode": Disabled most features,
   or /LOCKED[:...] depending on settings. See section
                    "Kiosk mode". Seperate options with
                    komatas):
                    Repeat Mode options:
                     - all Repeat all songs
                     - sng Repead single song
                     - rnd Repeat random
                    Song post-processing
                     - nop No post-song-processing
                     - crf Crossfading
                     - mdm MiniDisk record mode
                     - stp Stop after each song
                    Playlist doubleclick actions
                     - pds Skip song
                     - pde End song
                     - pdn Play song next
                    Other settings
                     - fad Fading on
                     - nfd Fading off
                    Kiosk mode related options
                     - cdm Shows "Refresh CD constens"
                           menu
                     - msg Allowes special messaging
                           functions
                     - vol Allow volume changing
  /LED              Use keyboard LEDs for state
                    informations (see section keyboard
                    LEDs state); Overwrites built-in
                    spectrum analyzer.
  /LOADTIMER[=file] Import 'file' containing timer
                    settings on startup (*.qpt)
                    if no 'file' is defined, QPlayer.qpt
                    (according to QuickPlayer exename),
                    if present, will be imported.
  /MSG              Allowes special messaging functions
                    kiosk mode
  /NOAUTOREFRESH    Hides all autorefresh related menu
                    items. AutoRefresh is still working!
  /NOAUTOSETUP      Hides the "AutoRefresh setup" menu 
                    item
  /NODIRLISTSET     Hides the Directory list setup menu
  /NOFAILSAVE       Disable automatic failsave
  /NOLOADLIST       Don't load playlist (use a new one)
  /NOLOADSETTINGS   Skips loading settings, uses defaults
  /NOMSG            Disable messaging
  /NOPLMENU         Hides the "Load playlist" quickmenu
  /NOPRESETS        Hides the preset menu
  /NOQUIT           QuickPlayer cannot be quitted
  /NOSAVELIST       Don't save playlist
  /NOSAVESETTINGS   Don't save settings
  /NOSETUP          Disables "General settings" and
                    "AutoRefresh setup"
  /NOSPECTRUM       Disable spectrum analyzer and hides
                    menu item
  /NOTASKMGR        Disables Windows 9x task manager
                    (not recommend!)
  /NOTASKMGR!       Disables Windows 9x task manager, and
                    do not reactivate when quitting
                    (not recommend!)
  /NOTUTORIAL       Suppresses first time help (e.g. when
                    ini file is never present
  /NOVERWARN        Suppress the '... update required'
                    message on startup (info screen)
  /ONTOP            Activates "Always on top" and hides
                    menu item
  /PREV             If a m3u file is specified and
                    QuickPlayer is already running, the
                    m3u is passed to the previous
                    instance (used when registering m3u
                    files, ment for internal usage)
  /PROMO[1-9]       Always shows info window (use 1-9 for
                    window position, according to numpad)
                    (In difference to the /INFO parameter
                    the info window cannot be closed)
  /SECURE           I lighter 'kiosk'-mode. File opening/
                    saving dialogs are disabled (User
                    could delete files with that dialog),
                    as well as file deleting and opening
                    an explorer
  /SET:Option(s)    Overwrite playlist/inifile settings
                    Seperate options with komatas.
                    When using the /KIOSK or /LOCKED
                    command line parameters, the /SET
                    command line parameter is ignored
                    Repeat Mode options:
                     - all Repeat all songs
                     - sng Repead single song
                     - rnd Repeat random
                    Song post-processing
                     - nop No post-song-processing:
                     - crf Crossfading
                     - mdm MiniDisk record mode
                     - stp Stop after each song
                    Playlist doubleclick actions:
                     - pds Skip song
                     - pde End song
                     - pdn Play song next
                    RemoveItems settings:
                     - rp0 Remove played songs OFF
                     - rp1 Remove played songs ON
                     - rs0 Remove manually skipped/ended
                           songs OFF
                     - rs1 Remove manually skipped/ended
                           songs ON
                     - rm0 Remove missing songs OFF
                     - rm1 Remove missing songs ON
                    Other settings:
                     - fd0 Fading ON
                     - fd1 Fading OFF
                     - vol Set volume. Must be followed
                           with a value from 0-100, e.g.
                           vol90
                     - drl Directory list setting. Must
                           be followed with a value from
                           0 to 8; 0 to use as dropdown
                           list, 1-8 for size in 1/10;
                           e.g. drl5
  /SHELL            Quitting will open the windows shut
                    down dialog (Start, Shut Down)
  /SHOWFAILSAVE     Show failsave dialog on startup
  /SHUTDOWN         Quitting QuickPlayer will shutdown
                    the computer. Works in Kiosk mode.
  /VISIBLE          Prevents to start QuickPlayer
                    minimized
  /VOLUME           Allowes volume changing in kiosk mode

  When no commandline parameters (except <playlist>, /CMD
  or /BASE=...) are specified, QuickPlayer tries to open
  "QPlayer.cmd" for commandline parameters (if the /BASE
  commandline parameter is used, QuickPlayer looks for
  a matching <file> first). A /BASE parameter in the
  CMD-file will be ignored. A playlist specified in a
  CMD-file is only used if no playlist is specified in
  the commandline parameter, or it cannot be loaded.
  If no playlist is specified (or none can be loaded),
  the default playlist (according to /BASE, if specified)
  is used.

  Here is the hierarchy:
    <playlist>
    <(other) parameters>
    </base>
      <cmdfile>
        <playlist>
        <(other) parameters>
      <playlist>                        (Used for saving)
    <default>                (if /base is NOT USED only!)
      <cmdfile>
        <playlist>
        <(other) parameters>
      <playlist>                        (Used for saving)

!Settings / Presets / Playlist
------------------------------

  The INI-file is compatible with most previously saved
  files and may be compatible with future QuickPlayer
  versions. Some settings, of course, may be ignored
  when using different versions

  The playlist (m3u-file) is compatible, but when using
  QuickPlayer playlists with other players / other
  QuickPlayer versions (or versewise), only the playlist
  itself (filelist) will be loaded. Any additional
  settings will get lost.

  Preset files (*.qps) are similar to the INI-file.
  Use them to quickly changes multiple settings at once.
  You can use up to 64 presets. You can use the built-in
  preset manager or create presets with a simple editor.
  You can also copy and rename your current INI-file (if
  QuickPlayer is running, save settings first).
  
  The following settings are stored in the playlist (m3u):
   - Autorefresh refresh interval (#AutoRefreshTimer)
   - Autorefresh directories (#AutoDir=...)
   - Last played song (ignored on random mode)
     (#LastSong)
   - Playlist (non-refresh songs only) (x:\*\*.*;
     #Dir=x:\*)
   - Remove missing songs (*) (#RemoveMissingSongs)
   - Remove manually skipped songs (*)
     (#RemoveSkippedSongs)
   - Remove played songs (*) (#RemovePlayedSongs)
   - Repeat mode (*) (#RepeatMode)

  The following settings are stored in the INI-file and/
  or preset file(s):
   - Allow file delete (AllowFileDeleting)
   - Always on top (AlwaysOnTop)
   - Automatic playback (AutoPlay)
   - Check for accurate streams (CheckAccurateStreams)
   - CDDA (CDDA)
   - Crossfading / MD Record mode / Stop after each song
     (EndSongMode) (0=off, 1=XFade, 2=MDMode, 3=StopMode)
   - Directory/file sorting (Sorting)
   - Directory list mode (DirectoryList
   - End ... after ... minutes (EndCDAudio, EndStreams,
     EndTrackers). (0 or negative value if disabled)
   - Fading (Fading)
   - First time help (TutorialShown)
   - Flat Buttons  (FlatButtons)
   - Follow current song (FollowSong)
   - High detail spectrum (SpectrumAdvanced)
   - Get MP3/Ogg vorbis Format (GetFileFormat)
   - Global Keys (Ctrl+Alt+KEY) (GlobalPlayKeys)
   - Ignore files/directories beginning with # or _
     (IgnoreUnderscored)
   - Jitter correction (CDDAJitterCorrection)
   - Keyboard configuration (Controls)
   - Mouse gestures (MouseGesture)
   - Output device settings (DirectSound, SoundCard)
   - Playlist doubleclick action (PlaylistDoubleClick)
   - Remove missing songs (*) (RemoveMissingSongs)
   - Remove manually skipped songs (*)
     (RemoveSkippedSongs)
   - Remove played songs (*) (RemovePlayedSongs)
   - Repeat mode (*) (RepeatMode)
   - Show additional file infos (GetFileInfos)
   - Show elapsed time (ElapsedTime)
   - Show full path (ShowFullPath)
   - Show titles when minimized (TitlesWhenMinimized)
   - Spectrum analyzer (Spectrum, SpectrumQuality)
     ('SpectrumQuality' stored in INI file only)
   - Task / thread priority (Priority)
   - Tracker Stereo Panning (TrackerPanSeperation)
   - Tray icon settings (TrayIcon, TrayMinimize,
     TrayLeftClick, TrayRightClick)
   - Used file types (UsedFileTypes)
   - Volume (Volume)
   - Window position (Player) and size (WindowLeft,
     WindowTop, WindowWidth, WindowHeight)

  The following settings are stored in the ini-file only
   - Failsave state (Failsave)

  The following setting is stored in the Windows
  regestry:
   - Register playlists / Default playlist program
   - Run at windows startup (HotKey_LocalMachine,
     Software\Microsoft\Windows\CurrentVersion\Run,
     QuickPlayer)

  (*) These settings are stored in both ini-file and
  playlist (m3u-file). The settings in the ini-file will
  be used on startup if no playlist is loaded / playlist
  loading fails.

!Version history
----------------

  Due to file size the version history is now found in
  the file 'History.txt' or 'QPlayer_History.txt'

!Sound system compatibility
---------------------------

  BASS:
    Currently only version 2.01 is supported

  FMod
    The following versions have been (more or less)
    tested:
      3.20a,3.30a,3.32,3.33,3.40,3.50,3.60,3.61,3.62,
      3.63,3.70,3.71,3.72,3.73,3.74
    So QuickPlayer handles different or missing API
    interfaces for these versions, I have not fully
    tested them. I'm currently developing with fmod 3.74,
    and recommend you use this version (or try a newer).
    I recommend not to use fmod 3.70 because it crashes
    frequencly with QuickPlayer.
    Version 3.2x (and older) are not supported.

Credits
-------

  Jan Vorel (thats me):
   - Programming
   - Layout (design)
   - Testing
   - Spent several sleepless nights thinking of possible
     problems, new features and workarounds
   - Readme file
   - Homepage content (Text, screenshots, ...)
   - SendMessageA IR Support & testing
   - Lots of features
   
  Christian Falk:
   - Beta tester
   - Nerved me to add crossfade features
     Most removed since beta 21
   - Found bugs that occured on special settings
   - Tested QuickPlayer with different sound cards
   - The idea to use a shutdown dialog to give the user
     the possibility to abort the shut down. (One of his
     programs used such a shutdown dialog)

  Ali Chaudhry:
   - Missed the possibility to delete a song ("Remove
     and delete file")
   - lots of discussions resulting in better
     performance / compatiblity,
   - Showed me UPX

  Thomas Vorel:
   - Convinced me to add a shut-down feature to save
     power when using QuickPlayer to fall asleep
     ("Timer settings").
   - Testing on slow computers
   - Some requests / comments / suggestions

  Alex Wippenbeck (and many other ...):
   - Testing under Windows XP

  Ian Luck
   - developing BASS.dll

  Firelight Technologies:
   - developing FMod.dll
   - Support requests (especially Visual Basic API
     related)
   - Bugfixes

  ------------------ General Credits: ------------------

  Angus Johnson
   - Resource Hacker

  Carlos J. Quintero
   - MZ-Tools

  Eugene Roshal
   - WinRar
   - Rar ('DosShell' / HexViewer)

  Grennady Feldman
   - Win32Pad (Notepad replacement)

  Markus F.X.J. Oberhumer & Laszlo Molnar:
   - UPX

  Michael Merbald
   - Homepage / webspace

  Microsoft:
   - Windows 95/98
   - Visual Basic
   - MSDN

  PlanetSourceCode:
   - Visual Basic Source Codes to see how to use API

  Toshi:
   - ExeScope: Additional resource operations / checking

  ULEAD System:
   - Photo Impact (best image editing programm)

  Lothar Rossipaul:
   - Wörterbuch (For some translations)

  and many other...
