             Component: TWavePlayer
               Version: 1.0
                Status: Freeware
                Author: Chirag Dalal
        Delphi version: 1.0 and 2.0
Default component page: Custom

Task
----
  Given a wave file (files with *.wav extension), TWavePlayer can
  play it to the default sound device. On the event of non-availability
  of the file, it can, optionally, play a default sound (set through
  Control Panel - usually a beep). It can play the file either
  synchronously or asynchronously and can even force stop a playing
  wave file. Optionally, it can loop over the wave file without
  further any intervention from the program.

Properties
----------
* About: TStrings
    Read-only. Gives information on the component name, it's version,
    author, author's address and e-mail id.
* Default: Boolean
    When set to False and if the sound cannot be found, the component
    doesn't play the default sound.
* FileName: string
    A string that specifies the sound to play. This parameter can
    be either an entry in the registry or in WIN.INI that identifies
    a system sound, or it can be the name of a waveform-audio file.
    (If the component does not find the entry, the parameter is
    treated as a filename.) If this property is blank, any currently
    playing sound is stopped.
* ForcePlay: Boolean
    When set to False and if a sound is currently playing, the
    component doesn't play the requested sound.
* Loop: Boolean
    The sound plays repeatedly until played again with the FileName
    property set to blank. You must also set Wait to False to loop sounds.
* Play: Boolean
    When set to True, calls the Start method which plays the sound.
    When set to False, calls the Stop method which stops the sound.
* Wait: Boolean
    When set to True, the sound is played synchronously and the
    control does not return until the sound ends.


Methods
-------
* procedure Start; virtual;
    Starts playing the specified sound using the values set at the
    time of calling. Any changes to values of the properties does
    not affect the sound until Start is called again.

* procedure Stop; virtual;
    Forcefully stops any playing waveform file.

Events
------
  (none)

Types
-----
  (none)

Tips
----
* If the specified sound cannot be found, the component plays the
  system default sound. If there is no system default entry in the
  registry or WIN.INI file, or if the default sound cannot be found,
  it makes no sound.

* The specified sound must fit in available physical memory and
  be playable by an installed waveform-audio device driver. If
  the component does not find the sound in the current directory,
  it searches using the standard directory-search order.

=============================================
 Limited warranty and disclaimer of warranty
=============================================
This software and accompanying written materials are provided
"as is" without warranty of any kind. Further, the author does
not warrant, guarantee, or take any representations regarding
the use, or the results of use, of the software or written
materials in terms of correctness, accuracy, reliability,
currentness or otherwise. The entire risk as to the results
and performance of the software is assumed by you.
Neither the author nor anyone else who has been involved in
the creation, production or delivery of this product shall be
liable for any direct, indirect, consequential or incidental
damages (including damages for loss of business profits, business
interruption, loss of business information and the like) arising
out of the use or inability to use the product even if the author
has been advised of the possibility of such damages.
By using the TWavePlayer component you acknowledge that you have read
this limited warranty, understand it, and agree to be bound by its'
terms and conditions.

=====================================================================
If you have any comments, suggestions and bug-reports, please forward
it to dalal@cse.iitb.ernet.in OR chdalal@pcsbom.patni.com
=====================================================================

========================================
Name: Chirag Dalal
Address: 6/54, Varma Nagar,
         Old Nagardas Road,
         Andheri (East),
         Mumbai - 400 069,
         Maharashtra, India.
E-mail: dalal@cse.iitb.ernet.in
URL: http://www.cse.iitb.ernet.in/~dalal
========================================

