BASS WMA 1.6 - Copyright (c) 2002 Ian Luck. All rights reserved
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Files that you should have found in the BASS WMA "package"
==========================================================
BASSWMA.TXT   This file
BASSWMA.DLL   The BASS WMA module
BASSWMA.CHM   BASS WMA documentation
FILE_ID.DIZ   BBS description file
C\            C/C++ API and samples...
  BASSWMA.H     BASS WMA C/C++ header file
  BASSWMA.LIB   BASS WMA import library
  CONTEST.EXE   WMA version of the BASS console example program
  CONTEST.C     Console example program source-code
  DSPTEST.EXE   WMA version of the BASS DSP example program
  DSPTEST.C     DSP example program source-code
  DSPTEST.RC    DSP example program resource file
  DSPTEST.H     DSP example program resource header file
  WRITEWAV.EXE  WMA version of the BASS WAVE writer example
  WRITEWAV.C    WAVE writer example source-code
  WMALIVE.EXE   WMA live broadcast example program
  WMALIVE.C     WMA live broadcast example program source-code
  WMALIVE.RC    WMA live broadcast example program resource file
VB\           Visual Basic API and samples...
  BASSWMA.BAS   BASS WMA Visual Basic module file
  PLAYER\     Simple "one button" player example
    PRJPLAYER.VBP  Project file
    FRMPLAYER.FRM  Main form
    FRMPLAYER.FRX
  WRITEWAV\     WAVE writer example
    PRJWRITEWAVE.VBP  Project file
    PRJWRITEWAVE.FRM  Main form
    PRJWRITEWAVE.FRX
  WMALIVE\      WMA live broadcast example
    PRJWMALIVE.VBP  Project file
    FRMWMALIVE.FRM  Main form
    FRMWMALIVE.FRX
    MODWMALIVE.BAS
DELPHI\       Delphi API...
  BASSWMA.PAS   BASS WMA Delphi unit
TMT\          TMT Pascal API and samples...
  BASSWMA.PAS   BASS WMA TMT Pascal unit
  WRITEWAV.PAS  WAVE writer example source-code
MASM\         MASM API and samples...
  BASSWMA.INC   BASS WMA MASM include file
  PLAYER.ASM    Simple player example source-code
  COMPILE.BAT   Simple player compilation script


NOTE: The ZIP should be decompressed with the directory stucture maintained.

NOTE: To run the sample EXEs, first you'll have to copy BASSWMA.DLL into
      the same directory as the EXEs. You'll also need BASS.DLL which can
      be download from the BASS website.


What's the point?
=================
BASS WMA is an extension to the BASS audio library, enabling the playback
of WMA files. The audio tracks of WMV files can also be played. WMA file
encoding and network broadcasting functions are also provided.


Requirements
============
BASS 1.6 is required, BASSWMA.DLL will fail to load if BASS.DLL v1.6 is not
present. The Windows Media Format modules are also required to be installed
on the user's system. They are installed with Windows Media player, so will
already be on most users' systems, but they can also be installed seperately
(WMFADIST.EXE).


Using BASS WMA
==============
The WMA format is used in very much the same way as any of the built-in BASS
stream formats. Just replace the BASS_xxx function calls with the BASS_WMA_xxx
equivalent where appropriate. There are a few things to note though...

* When stopping a WMA channel, use BASS_ChannelPause (not BASS_ChannelStop),
  if you wish to resume playback from the same place.
* BASS_StreamPreBuf should not be used on a WMA channel, WMA channels already
  pre-buffer as quickly as possible.
* Channel links (BASS_ChannelSetLink) may produce unexpected results due to
  the fact that BASS_StreamPlay (rather than BASS_WMA_StreamPlay) is used.
* Message syncs (BASS_SYNC_MESSAGE) are not supported.

To use BASS WMA with Borland C++ Builder, you'll first have to create a
Borland C++ Builder import library for it. This is done by using the
IMPLIB tool that comes with Borland C++ Builder. Simply execute this:

	IMPLIB BASSWMABCB.LIB BASSWMA.DLL

... and then use BASSWMABCB.LIB in your projects to import BASS WMA.

For the BASS functions that return strings (char*), VB users should use
the VBStrFromAnsiPtr function to convert the returned pointer into a VB
string.

NOTE: BASSWMA.DLL will fail to load if BASS.DLL v1.6 is not present.


Latest Version
==============
The latest versions of BASS WMA & BASS can be found at the BASS website:

        http://www.un4seen.com/


Copyright, Disclaimer, and all that other jazz
==============================================
The BASS WMA library is free, so if anyone tries to charge you
for it, kick 'em where it hurts.

This software is provided "as is", without warranty of ANY KIND,
either expressed or implied, including but not limited to the
implied warranties of merchantability and/or fitness for a
particular purpose. The author shall NOT be held liable for
ANY damage to you, your computer, or to anyone or anything else,
that may result from its use, or misuse. Basically, you use it
at YOUR OWN RISK.

Usage of BASS WMA indicates that you agree to the above conditions.

You may freely distribute the BASS WMA package as long as NO FEE is
charged and all the files remain INTACT AND UNMODIFIED.

All trademarks and other registered names contained in the BASS WMA
package are the property of their respective owners.


History
=======
These are the major (and not so major) changes at each version
stage. There are ofcourse bug fixes and other little improvements
made along the way too! To make upgrading simpler, all functions
affected by a change to the BASS WMA interface are listed.

1.6 - 13/6/2002
---------------
* Connected clients count retrieval
	BASS_WMA_EncodeGetClients
* 64-bit lengths and positions
	BASS_WMA_StreamGetLength
	BASS_WMA_ChannelGetPosition
	BASS_WMA_ChannelSetPosition
	BASS_WMA_ChannelSetSync
* Streaming via IStream objects
	BASS_WMA_StreamCreateFile
* Auto-freeing WMA streams
	BASS_STREAM_AUTOFREE (BASS_WMA_StreamCreateFile flag)
* Normal playback resuming after seeking while paused
	BASS_ChannelResume
* WMA stream freeing integrated into BASS.DLL
	BASS_StreamFree
	BASS_Free

1.5a - 8/5/2002
---------------
* Encoding
	BASS_WMA_EncodeGetRates
	BASS_WMA_EncodeOpenFile
	BASS_WMA_EncodeOpenNetwork
	BASS_WMA_EncodeGetPort
	BASS_WMA_EncodeSetTag
	BASS_WMA_EncodeWrite
	BASS_WMA_EncodeClose
	BASS_WMA_ENCODE_TAGS (BASS_WMA_EncodeOpenFile/Network flag)
* Loading from a memory location
	BASS_WMA_StreamCreateFile
* Faster file verification
	BASS_WMA_StreamCreateFile
* Protected file error code
	BASS_ERROR_WMA_LICENSE (BASS_WMA_StreamCreateFile error code)

1.5 - 16/4/2002
---------------
* First release


Bug reports, Suggestions, Comments, Enquiries, etc...
=====================================================
If you have any of the aforementioned please check the BASS forum (at
the website)... If you can't find an answer there, you can email:

        basswma@un4seen.com

