From 041ee1b932cc9c058c545595751b77893dde75dc Mon Sep 17 00:00:00 2001 From: brunzelchen Date: Mon, 21 Jun 2010 16:33:16 +0000 Subject: - individual line breaks for each player in duet songs are now possible - fade in and out of lyrics, notes and notelines in sing screen - update of acinerella.dll - update of BASS to v2.4 - removed joypad support (did it ever worked?) - removed unused units and options git-svn-id: svn://svn.code.sf.net/p/ultrastardx/svn/branches/1.0.1 Challenge MOD@2553 b956fd51-792f-4845-bead-9b4dfca2ff2c --- Game/Code/lib/bass/bass.txt | 374 ++++++++++++++++++++++++++++++++++---------- 1 file changed, 292 insertions(+), 82 deletions(-) (limited to 'Game/Code/lib/bass/bass.txt') diff --git a/Game/Code/lib/bass/bass.txt b/Game/Code/lib/bass/bass.txt index c60b6594..d21085dd 100644 --- a/Game/Code/lib/bass/bass.txt +++ b/Game/Code/lib/bass/bass.txt @@ -1,7 +1,8 @@ -BASS 2.3 - Copyright (c) 1999-2007 Ian Luck. All rights reserved. +BASS 2.4 +Copyright (c) 1999-2010 Un4seen Developments Ltd. All rights reserved. -Files that you should have found in the BASS "package" -====================================================== +Files that you should have found in the BASS package +==================================================== Win32 version ------------- BASS.TXT This file @@ -9,7 +10,7 @@ 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 samples... +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 @@ -23,7 +24,6 @@ C\ C/C++ API and samples... BASSTEST\ Simple playback example BASSTEST.C BASSTEST.RC - BASSTEST.H BASSTEST.DSP MAKEFILE CONTEST\ Console example @@ -53,11 +53,6 @@ C\ C/C++ API and samples... LIVESPEC.C LIVESPEC.DSP MAKEFILE - LOADNGET\ LoadLibrary/GetProcAddress example - LOADNGET.C - LOADNGET.RC - LOADNGET.DSP - MAKEFILE MULTI\ Multiple device example MULTI.C MULTI.RC @@ -104,7 +99,6 @@ C\ C/C++ API and samples... FXTEST.EXE LIVEFX.EXE LIVESPEC.EXE - LOADNGET.EXE MULTI.EXE NETRADIO.EXE RECTEST.EXE @@ -112,8 +106,8 @@ C\ C/C++ API and samples... SPECTRUM.EXE SYNTH.EXE WRITEWAV.EXE -VB\ Visual Basic API and samples... - BASS.BAS BASS Visual Basic module file +VB\ Visual Basic API and examples... + BASS.BAS BASS Visual Basic module 3DTEST\ 3D/EAX example PRJ3DTEST.VBP PRJ3DTEST.FRM @@ -142,8 +136,8 @@ VB\ Visual Basic API and samples... MODLIVESPEC.BAS MULTI\ Multiple device example PRJMULTI.VBP - PRJMULTI.FRM - PRJDEVICE.FRM + FRMMULTI.FRM + FRMDEVICE.FRM NETRADIO\ Internet streaming example PRJNETRADIO.VBP FRMNETRADIO.FRM @@ -175,7 +169,7 @@ VB\ Visual Basic API and samples... FRMMEMORY.FRM SYNCTEST.BAS CBASS_TIME.CLS -DELPHI\ Delphi API and samples... +DELPHI\ Delphi API and examples... BASS.PAS BASS Delphi unit 3DTEST\ 3D/EAX example D3TEST.DPR @@ -205,6 +199,8 @@ DELPHI\ Delphi API and samples... LIVEFX.DPR UNIT1.PAS UNIT1.DFM + LIVESPEC\ "Live" version of spectrum analyser example + LIVESPEC.DPR MULTI\ Multiple device example MULTI.DPR UNIT1.PAS @@ -235,6 +231,10 @@ DELPHI\ Delphi API and samples... SPEAKERS.DPR UNIT1.PAS UNIT1.DFM + SPECTRUM\ Spectrum analyser example + SPECTRUM.DPR + UNIT1.PAS + COMMON.INC STREAMTEST\ User stream example STREAMTEST.DPR STMAIN.PAS @@ -245,7 +245,7 @@ DELPHI\ Delphi API and samples... UNITMAIN.DFM DYNAMIC\ Dynamic-loading Delphi API DYNAMIC_BASS.PAS Dynamic-loading Delphi unit -MASM\ MASM API and samples... +MASM\ MASM API and examples... BASS.INC BASS MASM include file PLAYER\ Example MOD player PLAYER.EXE @@ -254,8 +254,8 @@ MASM\ MASM API and samples... TOOLBAR.BMP COMPILE.BAT -NOTE: To run the sample EXEs, first you'll have to copy BASS.DLL into the - same directory as the EXEs. +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: bass@un4seen.com). @@ -287,9 +287,12 @@ CUSTLOOP\ Custom looping example MAKEFILE DSPTEST\ DSP example DSPTEST.C - DSPTEST.RC MAKEFILE DSPTEST.NIB +FXTEST\ DX8 effect example + FXTEST.C + MAKEFILE + FXTEST.NIB LIVESPEC\ "Live" version of spectrum analyser example LIVESPEC.C MAKEFILE @@ -352,64 +355,61 @@ Intel Macs. Main Features ============= * Samples -- supports WAV/AIFF/MP3/MP2/MP1/OGG and custom generated samples + supports WAV/AIFF/MP3/MP2/MP1/OGG and custom generated samples * Sample streams -- stream any sample data in 8/16/32 bit + 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 + MP3/MP2/MP1/OGG/WAV/AIFF file streaming * Internet file streaming -- stream MP3/MP2/MP1/OGG/WAV/AIFF files from the internet (inc. Shout/Icecast) + stream files from the internet, including Shout/Icecast * User file streaming -- stream MP3/MP2/MP1/OGG/WAV/AIFF files from anywhere using any delivery method + stream files from anywhere using any delivery method * Multi-channel streaming -- support for more than plain stereo, including multi-channel OGG/WAV/AIFF files + 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 + uses the same engine as XMPlay = best accuracy, speed, and quality * MO3 music -- MP3/OGG compressed MOD music + MP3/OGG compressed MOD music * Add-on system -- support for more formats is available via add-ons (aka plugins) + support for more formats is available via add-ons (aka plugins) * Multiple outputs -- simultaneously use multiple soundcards, and move channels between them + simultaneously use multiple soundcards, and move channels between them * Recording -- flexible recording system, with support for multiple devices + flexible recording system, with support for multiple devices * Decode without playback -- streams and musics can be outputted in any way you want + streams and MOD musics can be outputted in any way you want * Speaker assignment -- assign streams and musics to specific speakers + assign streams and MOD musics to specific speakers * High precision synchronization -- synchronize events in your software to the music + synchronize events in your software to the streams and MOD musics * DirectX 8 effects -- chorus/compressor/distortion/echo/flanger/gargle/parameq/reverb + chorus/compressor/distortion/echo/flanger/gargle/parameq/reverb * User defined DSP functions -- custom effects may be applied to musics and streams + 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 + floating-point stream/music decoding, DSP, FX, and recording * 3D sound -- play samples/streams/musics in any 3D position, with EAX support - -* Expandable -- underlying DirectSound object interfaces are accessible + play samples/streams/musics in any 3D position, with EAX support * Small -- BASS is under 100KB (on Windows), so won't bloat your distribution + BASS is under 100KB (on Windows), so won't bloat your distribution Using BASS @@ -431,12 +431,6 @@ C/C++, Visual Basic, Delphi and MASM APIs are provided, to use BASS with another language you'll first have to convert the header file. Or, as a last resort, you could use LoadLibrary and GetProcAddress. -One benefit of the LoadLibrary method is that it allows you to look for -the correct BASS version, because you can load and unload BASS.DLL at -any time. This also allows those who'd prefer not to have a separate -DLL to store it with the program (eg. in a resource), write it to disk, -load it, use it, free it and delete it. - The downside is that you have to manually import each function that you use, with the GetProcAddress function. But it has been made a lot simpler to import BASS this way by the use of the BASSDEF #define. Here's a small @@ -449,8 +443,6 @@ HINSTANCE bass=LoadLibrary("BASS.DLL"); // load BASS BASS_Init=GetProcAddress(bass,"BASS_Init"); // get BASS_Init BASS_Init(-1,44100,0,hWnd,NULL); // call BASS_Init -See the LOADNGET.C file for a more complete example. - To use BASS 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: @@ -496,36 +488,36 @@ The latest version of BASS can always be found at the BASS website: www.un4seen.com -Copyright, disclaimer, and all that other jazz -============================================== -The BASS library is free for non-commercial use. If you are a non- -commercial entity (eg. an individual) and are not charging for your -product, and the product has no other commercial purpose, then you -can use BASS in it for free. If you wish to use BASS in commercial -products, then please also see the next section. +Licence +======= +BASS is free for non-commercial use. If you are a non-commercial entity +(eg. an individual) and you are not charging for your product, and the +product has no other commercial purpose, then you can use BASS in it +for free. If you wish to use BASS in commercial products, then please +also see the next section. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, BASS 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 AUTHORS SHALL NOT BE HELD -LIABLE FOR ANY DAMAGE THAT MAY RESULT FROM THE USE OF BASS. BASICALLY, -YOU USE BASS ENTIRELY AT YOUR OWN RISK. +LIABLE FOR ANY DAMAGE THAT MAY RESULT FROM THE USE OF BASS. YOU USE +BASS ENTIRELY AT YOUR OWN RISK. Usage of BASS indicates that you agree to the above conditions. All trademarks and other registered names contained in the BASS package are the property of their respective owners. - -BASS in commercial products? -============================ +Commercial licensing +-------------------- BASS is available for use in your commercial products. The licence types available are as follows: SHAREWARE: Allows the usage of BASS in an unlimited number of your shareware products, which must sell for no more than 40 Euros each. -If you're an individual making and selling your own software (and -its price is within the limit), this is the licence for you. +If you are an individual (not a corporation) making and selling your +own software (and its price is within the limit), this is the licence +for you. SINGLE COMMERCIAL: Allows the usage of BASS in a single commercial product. @@ -538,7 +530,7 @@ required. Please note the products must be end-user products, eg. not components used by other products. -These licences only cover your own software. not the publishing of +These licences only cover your own software, not the publishing of other's software. If you publish other's software, its developers (or the software itself) will need to be licensed to use BASS. @@ -549,7 +541,7 @@ licence covers one person or entity and is not transferable. These licences do not allow reselling/sublicensing of BASS. For example, if a product is a development system, the users of said product are not -licensed to use BASS in their productions - they will need their own +licensed to use BASS in their productions; they will need their own licences. If the standard licences do not meet your requirements, or if you have @@ -559,9 +551,8 @@ Visit the BASS website for the latest pricing: www.un4seen.com - MP3 -=== +--- MP3 technology is patented, and Thomson license the use of their and Fraunhofer's patents. The inclusion of an MP3 decoder (eg. BASS) in a commercial product requires an MP3 patent licence. Contact Thomson for @@ -569,7 +560,7 @@ details: www.mp3licensing.com -Alternatively, the "MP3-FREE" BASS version doesn't include its own MP3 +Alternatively, the "MP3-FREE" BASS version does not include its own MP3 decoder but instead makes use of the operating system's already licensed decoder. @@ -585,6 +576,220 @@ There are of course bug fixes and other little improvements made along the way too! To make upgrading simpler, all functions affected by a change to the BASS interface are listed. +2.4.6 - 17/6/2010 +----------------- +* Support for APEv2 tags, including binary + BASS_TAG_APE (BASS_ChannelGetTags type) + BASS_TAG_APE_BINARY (BASS_ChannelGetTags type) +* Unicode/IDN URL support + BASS_StreamCreateURL +* Decoding position retrieval + BASS_POS_DECODE (BASS_ChannelGetPosition flag) +* Support for OGG 6/7.1 channel configs + BASS_StreamCreateFile/User/Url +* Support for setting syncs within mixtime SYNCPROCs + BASS_ChannelSetSync +* Support for setting additional DSP/FX within DSPPROCs + BASS_ChannelSetDSP/FX +* DC bias removal in FFT processing + BASS_DATA_FFT_REMOVEDC (BASS_ChannelGetData flag) +* Fix for incorrect (2x) return value when getting FFT data from a 16-bit channel + BASS_ChannelGetData +* Fix for incorrect (STOPPED instead of PAUSED) channel status following BASS_Pause + BASS_ChannelIsActive + +2.4.5 - 18/12/2009 +------------------ +* Support for little-endian AIFF files + BASS_StreamCreateFile/User/Url + BASS_SampleLoad +* Support for 64-bit floating-point WAVE/AIFF files + BASS_StreamCreateFile/User/Url + BASS_SampleLoad +* Input volume retrieval failure results in a reading of -1 instead of 1 + BASS_RecordGetInput + RECTEST example updated +* Input volume support on OSX + BASS_RecordSetInput + BASS_RecordGetInput + RECTEST example updated +* Fix for deferred input settings on Vista + BASS_RecordSetInput +* Windows MP3 codec given preference over other installed MP3 codecs (MP3-FREE version) + BASS_StreamCreateFile/User/Url + BASS_SampleLoad + +2.4.4 - 13/10/2009 +------------------ +* RIFF/BWF "radio traffic" tag retrieval + BASS_TAG_RIFF_CART (BASS_ChannelGetTags type) + TAG_CART structure +* Support for ID3v2 tags in RIFF/WAVE/AIFF files ("ID3 " chunk) + BASS_TAG_ID3V2 (BASS_ChannelGetTags type) +* Pushed fractional samples are refused rather than discarded + BASS_StreamPutData +* DX8 effect emulation on OSX + BASS_FX_DX8_CHORUS/DISTORTION/ECHO/FLANGER/PARAMEQ/REVERB (BASS_ChannelSetFX types) + FXTEST example added +* UTF-16 support on OSX + BASS_UNICODE (BASS_StreamCreateFile/SampleLoad/MusicLoad/PluginLoad flag) + +2.4.3 - 8/5/2009 +---------------- +* MOD order list retrieval + BASS_TAG_MUSIC_ORDERS (BASS_ChannelGetTags type) +* Support for ID3v2 tags in RIFF/WAVE files ("id3 " chunk) + BASS_TAG_ID3V2 (BASS_ChannelGetTags type) +* Improved position reporting precision on Vista + BASS_ChannelGetPosition +* Length retrieval when streaming in blocks (BASS_STREAM_BLOCK) + BASS_ChannelGetLength +* Support for CoreAudio codecs on OSX + BASS_StreamCreateFile/User + BASS_SampleLoad + BASS_TAG_CA_CODEC (BASS_ChannelGetTags type) + TAG_CA_CODEC structure +* 3D algorithm option support on OSX + BASS_CONFIG_3DALGORITHM (BASS_SetConfig option) + +2.4.2 - 18/9/2008 +----------------- +* RF64 support + BASS_StreamCreateFile/User +* RIFF/BWF "Broadcast Audio Extension" tag retrieval + BASS_TAG_RIFF_BEXT (BASS_ChannelGetTags type) + TAG_BEXT structure +* ID3v1 tag structure + TAG_ID3 structure +* Multiple simultaneous recordings per device on Vista & OSX (as on XP) + BASS_RecordStart +* DX8 effect parameter defaults updated/corrected in documentation + +2.4 - 2/4/2008 +-------------- +* "Push" streaming + STREAMPROC_PUSH (BASS_StreamCreate "proc") + BASS_StreamPutData + LIVEFX and MULTI examples updated +* "Push" buffered file streaming + STREAMFILE_BUFFERPUSH (BASS_StreamCreateFileUser system) + BASS_StreamPutFileData +* STREAMFILEPROC replaced by table of callbacks for each file operation + BASS_FILEPROCS (FILECLOSEPROC/FILELENPROC/FILEREADPROC/FILESEEKPROC) + STREAMFILEPROC *removed* +* 64-bit file positioning + BASS_SampleLoad + BASS_MusicLoad + BASS_StreamCreateFile + BASS_StreamGetFilePosition +* File buffer level retrieval + BASS_FILEPOS_BUFFER (BASS_StreamGetFilePosition mode) +* Sinc interpolated MOD music mixing + BASS_MUSIC_SINCINTER (BASS_MusicLoad flag) +* MO3 2.4 support + BASS_MusicLoad +* MOD orders positioning incorporated into channel functions + BASS_ChannelGetLength + BASS_ChannelSetPosition + BASS_ChannelGetPosition + BASS_MusicGetOrderPosition *removed* + BASS_MusicGetOrders *removed* +* Channel attribute functions consolidated + BASS_ChannelSetAttribute + BASS_ChannelGetAttribute + BASS_ChannelSlideAttribute + BASS_ChannelIsSliding + BASS_ChannelSetAttributes *removed* + BASS_ChannelGetAttributes *removed* + BASS_ChannelSlideAttributes *removed* + BASS_ChannelSetEAXMix *removed* + BASS_ChannelGetEAXMix *removed* + BASS_MusicSetAttribute *removed* + BASS_MusicGetAttribute *removed* +* Floating-point volume and panning + BASS_SetVolume + BASS_GetVolume + BASS_RecordSetInput + BASS_RecordGetInput + BASS_ATTRIB_PAN/VOL (BASS_ChannelGet/Set/SlideAttribute options) + BASS_ATTRIB_MUSIC_VOL_CHAN/INST (BASS_ChannelGet/Set/SlideAttribute options) + BASS_SAMPLE (volume/pan/outvol members) + BASS_CONFIG_MAXVOL *removed* + BASSTEST and RECTEST examples updated +* Output device volume control on Vista (as on other OS) + BASS_SetVolume + BASS_GetVolume +* Multiple update threads + BASS_CONFIG_UPDATETHREADS + BASSTEST example updated +* Global volume range increased to 10000 + BASS_CONFIG_GVOL_SAMPLE/STREAM/MUSIC (BASS_SetConfig options) + BASSTEST example updated +* Setting and retrieving of a sample's data + BASS_SampleSetData + BASS_SampleGetData + BASS_SampleCreate + BASS_SampleCreateDone *removed* +* Channel flag setting mask + BASS_ChannelFlags + BASS_ChannelSetFlags *removed* + SPEAKERS example updated +* 256 sample FFT + BASS_DATA_FFT256 (BASS_ChannelGetData flag) +* Channel locking to prevent access by other threads + BASS_ChannelLock +* Manual channel buffer updating + BASS_ChannelUpdate + BASS_ChannelPreBuf *removed* +* Configurable manual update length + BASS_Update +* Extended device information retrieval and detection of new/removed devices + BASS_GetDeviceInfo + BASS_RecordGetDeviceInfo + BASS_DEVICEINFO structure + BASS_GetDeviceDescription *removed* + BASS_RecordGetDeviceDescription *removed* + BASS_INFO (driver member) *removed* + BASS_RECORDINFO (driver member) *removed* + MULTI example updated +* Default device change tracking on Windows (as on OSX) + BASS_Init + BASS_RecordInit +* Speaker detection from Windows control panel + BASS_DEVICE_CPSPEAKERS (BASS_Init flag) +* Channel automatically stopped & resumed for DX8 effects + BASS_ChannelSetFX + BASS_ChannelRemoveFX +* "double" precision position conversion + BASS_ChannelBytes2Seconds + BASS_ChannelSeconds2Bytes +* Separate config functions for pointers + BASS_SetConfigPtr + BASS_GetConfigPtr + BASS_CONFIG_NET_AGENT/PROXY (BASS_SetConfigPtr options) +* Configurable file format verification length + BASS_CONFIG_VERIFY (BASS_SetConfig option) +* Stream filename retrieval + BASS_CHANNELINFO (file member) +* Channel sample retrieval + BASS_CHANNELINFO (sample member) +* META syncs no longer receive metadata in the "data" parameter + BASS_SYNC_META (BASS_ChannelSetSync type) +* Separate sync for OGG logical bitstream changes (instead of BASS_SYNC_META) + BASS_SYNC_OGG_CHANGE (BASS_ChannelSetSync type) + NETRADIO example updated (C version) +* Message syncing removed (use PostMessage instead) + BASS_SYNC_MESSAGE (BASS_ChannelSetSync flag) *removed* +* Data retrieval from stopped/paused channels + BASS_ChannelGetData +* Callback "user" parameters changed to pointers + BASS_StreamCreate / STREAMPROC + BASS_StreamCreateFileUser + BASS_StreamCreateURL / DOWNLOADPROC + BASS_RecordStart / RECORDPROC + BASS_ChannelSetDSP / DSPPROC + BASS_ChannelSetSync / SYNCPROC + 2.3.0.3 - 30/7/2007 ------------------- * FX state resetting @@ -623,7 +828,7 @@ change to the BASS interface are listed. BASS_ChannelStop * Sample channels created paused to prevent overriding before playback BASS_SampleGetChannel -* Separate "MP3-FREE" version using Windows/OSX MP3 decoder +* Separate "MP3-FREE" version using the OS's MP3 decoder BASS_CONFIG_MP3_CODEC *removed* 2.3.0.1 - 12/6/2006 @@ -964,7 +1169,7 @@ change to the BASS interface are listed. BASS_ChannelSeconds2Bytes return value is rounded down to nearest sample BASS_ChannelGetData "length" param must equal a whole number of samples Slide syncs are triggered by "-2" volume slides on "autofree" streams -* Support for UNICODE filenames +* Support for Unicode filenames BASS_UNICODE (BASS_SampleLoad/BASS_StreamCreateFile/BASS_MusicLoad flag) * 4096 sample FFT BASS_DATA_FFT4096/S (BASS_ChannelGetData flags) @@ -1351,7 +1556,7 @@ change to the BASS interface are listed. 0.8 - 24/1/2000 --------------- -* Improved MP3 performance on P2/K6 and above CPUs - fast! +* Improved MP3 performance on P2/K6 and above CPUs * User DSP functions on streams and MOD musics BASS_ChannelSetDSP BASS_ChannelRemoveDSP @@ -1526,21 +1731,26 @@ change to the BASS interface are listed. * First public release -Credits - API/Sample Contributors -================================= -Visual Basic - Adam Hoult, Hendrik Knaepen, Arthur Aminov, - Peter Hebels -Delphi - Titus Miloi, Rogier Timmermans, Alessandro Cappellozza, - Jesse Naranjo, Chris Troesken -MASM - Octavian Chis +Credits +======= +Ogg Vorbis decoding is based on libogg/vorbis, +Copyright (c) 2002-2004 Xiph.org Foundation + +CHMOX is (c) 2004 Stéphane Boisson, http://chmox.sourceforge.net/ -CHMOX is (c)2004 Stéphane Boisson, http://chmox.sourceforge.net/ +API/Sample contributors +----------------------- +Visual Basic: Adam Hoult, Hendrik Knaepen, Arthur Aminov, + Peter Hebels +Delphi: Titus Miloi, Rogier Timmermans, Alessandro Cappellozza, + Jesse Naranjo, Chris Troesken, Evgeny Melnikov +MASM: Octavian Chis Bug reports, Suggestions, Comments, Enquiries, etc... ===================================================== -If you have any of the aforementioned please see the BASS forum (at -the website). If you can't find an answer there, you can email: +If you have any of the aforementioned please visit the BASS forum at +the website. If you can't find an answer there, you can also email: bass@un4seen.com -- cgit v1.2.3