bass.txt

bass player system api c++

BASS 2.4
Copyright (c) 1999-2008 Un4seen Developments Ltd. All rights reserved.

Files that you should have found in the BASS package
====================================================
Win32 version
-------------
BASS.TXT        This file
BASS.DLL        The BASS module
BASS.CHM        BASS documentation
MP3-FREE
  BASS.DLL        BASS module using the Windows MP3 decoder
C\              C/C++ API and examples...
  BASS.H          BASS C/C++ header file
  BASS.LIB        BASS import library
  BASS.DSW        Visual C++ workspace for examples
  MAKEFILE        Makefile for all examples
  MAKEFILE.IN     Makefile helper macros
  3DTEST\         3D/EAX example
    3DTEST.C
    3DTEST.RC
    3DTEST.DSP
    MAKEFILE
  BASSTEST\       Simple playback example
    BASSTEST.C
    BASSTEST.RC
    BASSTEST.DSP
    MAKEFILE
  CONTEST\        Console example
    CONTEST.C
    CONTEST.DSP
    MAKEFILE
  CUSTLOOP\       Custom looping example
    CUSTLOOP.C
    CUSTLOOP.DSP
    MAKEFILE
  DSPTEST\        DSP example
    DSPTEST.C
    DSPTEST.RC
    DSPTEST.DSP
    MAKEFILE
  FXTEST\         DX8 effect example
    FXTEST.C
    FXTEST.RC
    FXTEST.DSP
    MAKEFILE
  LIVEFX\         Full-duplex example
    LIVEFX.C
    LIVEFX.RC
    LIVEFX.DSP
    MAKEFILE
  LIVESPEC\       "Live" version of spectrum analyser example
    LIVESPEC.C
    LIVESPEC.DSP
    MAKEFILE
  MULTI\          Multiple device example
    MULTI.C
    MULTI.RC
    MULTI.DSP
    MAKEFILE
  NETRADIO\       Internet streaming example
    NETRADIO.C
    NETRADIO.RC
    NETRADIO.DSP
    MAKEFILE
  PLUGINS\        Plugins example
    PLUGINS.C
    PLUGINS.RC
    PLUGINS.DSP
    MAKEFILE
  RECTEST\        Recording example
    RECTEST.C
    RECTEST.RC
    RECTEST.DSP
    MAKEFILE
  SPEAKERS\       Multi-speaker example
    SPEAKERS.C
    SPEAKERS.RC
    SPEAKERS.DSP
    MAKEFILE
  SPECTRUM\       Spectrum analyser example
    SPECTRUM.C
    SPECTRUM.DSP
    MAKEFILE
  SYNTH\          Synth example
    SYNTH.C
    SYNTH.DSP
    MAKEFILE
  WRITEWAV\       WAVE writer example
    WRITEWAV.C
    WRITEWAV.DSP
    MAKEFILE
  BIN\            Precompiled examples
    3DTEST.EXE
    BASSTEST.EXE
    CONTEST.EXE
    CUSTLOOP.EXE
    DSPTEST.EXE
    FXTEST.EXE
    LIVEFX.EXE
    LIVESPEC.EXE
    MULTI.EXE
    NETRADIO.EXE
    RECTEST.EXE
    SPEAKERS.EXE
    SPECTRUM.EXE
    SYNTH.EXE
    WRITEWAV.EXE
VB\             Visual Basic API and examples...
  BASS.BAS        BASS Visual Basic module
  3DTEST\         3D/EAX example
    PRJ3DTEST.VBP
    PRJ3DTEST.FRM
    PRJDEVICE.FRM
  BASSTEST\       Simple playback example
    PRJBASSTEST.VBP
    FRMBASSTEST.FRM
  CUSTLOOP\       Custom looping example
    PRJCUSTLOOP.VBP
    FRMCUSTLOOP.FRM
    MODCUSTLOOP.BAS
  DSPTEST\        DSP example
    PRJDSPTEST.VBP
    FRMDSPTEST.FRM
    MODDSPTEST.BAS
  FXTEST\         DX8 effect example
    PRJFXTEST.VBP
    FRMFXTEST.FRM
  LIVEFX\         Full-duplex example
    PRJLIVEFX.VBP
    FRMLIVEFX.FRM
    MODLIVEFX.BAS
  LIVESPEC\       "Live" version of spectrum analyser example
    PRJLIVESPEC.VBP
    FRMLIVESPEC.FRM
    MODLIVESPEC.BAS
  MULTI\          Multiple device example
    PRJMULTI.VBP
    PRJMULTI.FRM
    PRJDEVICE.FRM
  NETRADIO\       Internet streaming example
    PRJNETRADIO.VBP
    FRMNETRADIO.FRM
    MODNETRADIO.BAS
    CLSFILEIO.CLS
  PLUGINS\        Plugins example
    PRJPLUGINS.VBP
    FRMPLUGINS.FRM
  RECTEST\        Recording example
    PRJRECTEST.VBP
    FRMRECTEST.FRM
    MODRECTEST.BAS
  SPEAKERS\       Multi-speaker example
    PRJSPEAKERS.VBP
    FRMSPEAKERS.FRM
  SPECTRUM\       Spectrum analyser example
    PRJSPECTRUM.VBP
    FRMSPECTRUM.FRM
    MODSPECTRUM.BAS
  SYNTH\          Synth example
    PRJSYNTH.VBP
    FRMSYNTH.FRM
    MODSYNTH.BAS
  WRITEWAV\       WAVE writer example
    PRJWRITEWAVE.VBP
    PRJWRITEWAVE.FRM
  MEMORY\         Playing from memory example by Jobnik
    PRJMEMORY.VBP
    FRMMEMORY.FRM
    SYNCTEST.BAS
    CBASS_TIME.CLS
DELPHI\         Delphi API and examples...
  BASS.PAS        BASS Delphi unit
  3DTEST\         3D/EAX example
    D3TEST.DPR
    DTMAIN.PAS
    DTMAIN.DFM
    DTSELECT.PAS
    DTSELECT.DFM
  BASSTEST\       Simple playback example
    BASSTEST.DPR
    BTMAIN.PAS
    BTMAIN.DFM
  CONTEST\        Console example
    CONTEST.DPR
  CUSTLOOP\       Custom looping example
    CUSTLOOP.DPR
    UNIT1.PAS
    UNIT1.DFM
  DSPTEST\        DSP example
    DSPTEST.DPR
    DTMAIN.PAS
    DTMAIN.DFM
  FXTEST\         DX8 effect example
    FXTEST.DPR
    TEST.PAS
    TEST.DFM
  LIVEFX\         Full-duplex example
    LIVEFX.DPR
    UNIT1.PAS
    UNIT1.DFM
  MULTI\          Multiple device example
    MULTI.DPR
    UNIT1.PAS
    UNIT1.DFM
    UNIT2.PAS
    UNIT2.DFM
  NETRADIO\       Internet streaming example
    NETRADIO.DPR
    UNIT1.PAS
    UNIT1.DFM
  PLUGINS\        Plugins example
    PLUGINS.DPR
    UNIT1.PAS
    UNIT1.DFM
  RECORDTEST\     Recording example
    RECORDTEST.DPR
    UNIT1.PAS
    UNIT1.DFM
  SAMPLEVIS\      Visualisation example
    SAMPLEVIS.DPR
    MAIN.PAS
    MAIN.DFM
    SPECTRUM_VIS.PAS
    CIRCLE_VIS.PAS
    OSC_VIS.PAS
    COMMONTYPES.PAS
  SPEAKERS\       Multi-speaker example
    SPEAKERS.DPR
    UNIT1.PAS
    UNIT1.DFM
  STREAMTEST\     User stream example
    STREAMTEST.DPR
    STMAIN.PAS
    STMAIN.DFM
  WRITEWAV\       WAVE writer example
    WRITEWAV.DPR
    UNITMAIN.PAS
    UNITMAIN.DFM
  DYNAMIC\        Dynamic-loading Delphi API
    DYNAMIC_BASS.PAS  Dynamic-loading Delphi unit
MASM\           MASM API and examples...
  BASS.INC        BASS MASM include file
  PLAYER\         Example MOD player
    PLAYER.EXE
    PLAYER.ASM
    RSRC.RC
    TOOLBAR.BMP
    COMPILE.BAT

NOTE: To run the example EXEs, first you will have to copy BASS.DLL into the
      same directory as them.

NOTE: To avoid unnecessary bloatage, the BASS DLLs are not digitally signed.
      Signed versions are available on request (email: [e-mail]).

MacOSX version
--------------
BASS.TXT        This file
LIBBASS.DYLIB   The BASS module
BASS.CHM        BASS documentation
CHMOX.APP       CHM file viewer
BASS.H          BASS C/C++ header file
MAKEFILE        Makefile for all examples
MAKEFILE.IN     Makefile helper macros
MP3-FREE
  LIBBASS.DYLIB   BASS module using the OSX MP3 decoder
3DTEST\         3D example
  3DTEST.C
  MAKEFILE
  3DTEST.NIB
BASSTEST\       Simple playback example
  BASSTEST.C
  MAKEFILE
  BASSTEST.NIB
CONTEST\        Console example
  CONTEST.C
  MAKEFILE
CUSTLOOP\       Custom looping example
  CUSTLOOP.C
  MAKEFILE
DSPTEST\        DSP example
  DSPTEST.C
  DSPTEST.RC
  MAKEFILE
  DSPTEST.NIB
LIVESPEC\       "Live" version of spectrum analyser example
  LIVESPEC.C
  MAKEFILE
MULTI\          Multiple device example
  MULTI.C
  MAKEFILE
  MULTI.NIB
NETRADIO\       Internet streaming example
  NETRADIO.C
  MAKEFILE
  NETRADIO.NIB
PLUGINS\        Plugins example
  PLUGINS.C
  MAKEFILE
  PLUGINS.NIB
RECTEST\        Recording example
  RECTEST.C
  MAKEFILE
  RECTEST.NIB
SPEAKERS\       Multi-speaker example
  SPEAKERS.C
  MAKEFILE
  SPEAKERS.NIB
SPECTRUM\       Spectrum analyser example
  SPECTRUM.C
  MAKEFILE
WRITEWAV\       WAVE writer example
  WRITEWAV.C
  MAKEFILE


What's the point?
=================
BASS is an audio library for use in Windows and MacOSX software. Its
purpose is to provide the most powerful and efficient (yet easy to use),
sample, stream, MOD music, and recording functions. All in a tiny DLL,
under 100KB in size.

See the documentation for descriptions of all the BASS functions. You
should also look at the included example program source-codes for some
examples of how to use BASS in your own programs.


Requirements
============
Win32 version
-------------
BASS requires DirectX 3 or above for output. BASS does not require that a
soundcard with DirectSound/DirectSound3D hardware accelerated drivers is
installed, but it does improve performance if there is one. BASS also takes
advantage of MMX, which improves the performance of the MOD music playback.

MacOSX version
--------------
OSX 10.3 or above is recommended. BASS uses CoreAudio for output, so there
are no special library/driver requirements. BASS supports both PowerPC and
Intel Macs.


Main Features
=============
* Samples
  supports WAV/AIFF/MP3/MP2/MP1/OGG and custom generated samples

* Sample streams
  stream any sample data in 8/16/32 bit, with both "push" and "pull" systems

* File streams
  MP3/MP2/MP1/OGG/WAV/AIFF file streaming

* Internet file streaming
  stream files from the internet, including Shout/Icecast

* User file streaming
  stream files from anywhere using any delivery method

* Multi-channel streaming
  support for more than plain stereo, including multi-channel OGG/WAV/AIFF files

* MOD music
  uses the same engine as XMPlay = best accuracy, speed, and quality

* MO3 music
  MP3/OGG compressed MOD music

* Add-on system
  support for more formats is available via add-ons (aka plugins)

* Multiple outputs
  simultaneously use multiple soundcards, and move channels between them

* Recording
  flexible recording system, with support for multiple devices

* Decode without playback
  streams and MOD musics can be outputted in any way you want

* Speaker assignment
  assign streams and MOD musics to specific speakers

* High precision synchronization
  synchronize events in your software to the streams and MOD musics

* DirectX 8 effects
  chorus/compressor/distortion/echo/flanger/gargle/parameq/reverb

* User defined DSP functions
  custom effects may be applied to musics and streams

* 32 bit floating-point decoding and processing
  floating-point stream/music decoding, DSP, FX, and recording

* 3D sound
  play samples/streams/musics in any 3D position, with EAX support

* Small
  BASS is under 100KB (on Windows), so won't bloat your distribution


Using BASS
==========
There is no guarantee that all future BASS versions will be compatible
with all previous versions, so your program should use BASS_GetVersion
to check the version that is loaded. This also means that you should
put the BASS module in the same directory as your executable (not just
somewhere in the path), to avoid the possibility of a wrong version being
loaded.

If you are updating your software from a previous BASS version, then
you should check the "History" section (below), to see if any of the
functions that you are using have been affected by a change.