diff --git a/AO2XP.py b/AO2XP.py index 8082520..c4c86ea 100644 --- a/AO2XP.py +++ b/AO2XP.py @@ -1,15 +1,14 @@ -import sys, thread, time, os, platform +import sys, thread, time, os, platform, __builtin__ from os.path import exists, abspath from PyQt4 import QtGui, QtCore -app = QtGui.QApplication(sys.argv) +import audio as AUDIO +__builtin__.audio = AUDIO +del AUDIO + +app = QtGui.QApplication(sys.argv) osname = platform.system() -bassdll = "bass.dll" -bassopusplugin = "bassopus.dll" -if osname != "Windows": - bassdll = "libbass.so" - bassopusplugin = "libbassopus.so" path = sys.argv[0] if osname == "Darwin" and ".app" in path: # bundle @@ -18,9 +17,10 @@ if osname == "Darwin" and ".app" in path: # bundle debugmode = len(sys.argv) > 1 and sys.argv[1] == "debug" if not debugmode: - fakebass = len(sys.argv) > 1 and sys.argv[1] == "bass" - if not exists(bassdll) or fakebass: - QtGui.QMessageBox.critical(None, "Unable to launch game", "Couldn't find the file %s on the client folder.\nAO2XP needs this file in order to play sounds and music.\nThe file is included in the client's zip file, make sure it's in the same folder as the AO2XP exe.\n\nAdditional info:\n%s\n%s" % (bassdll, sys.argv, os.getcwd())) + fakebass = len(sys.argv) > 1 and sys.argv[1] == "ignorebass" + missing = audio.checkAvailable() + if missing or fakebass: + QtGui.QMessageBox.critical(None, "Unable to launch game", "Couldn't find the file %s on the client folder.\nAO2XP needs this file in order to play sounds and music.\nThe file is included in the client's zip file, make sure it's in the same folder as the AO2XP exe.\n\nAdditional info:\n%s\n%s" % (missing, sys.argv, os.getcwd())) os._exit(-2) class gamewindow(QtGui.QMainWindow): @@ -72,11 +72,11 @@ if not debugmode: else: os._exit(-3) -from pybass import * import gameview, mainmenu, options, ini -BASS_Init(ini.read_ini_int("AO2XP.ini", "Audio", "device", -1), 44100, 0, 0, 0) -BASS_PluginLoad(abspath(bassopusplugin), 0) +audio.init() shit = gamewindow() shit.show() -sys.exit(app.exec_()) +returnc = app.exec_() +audio.free() +sys.exit(returnc) diff --git a/audio.py b/audio.py new file mode 100644 index 0000000..80cc96c --- /dev/null +++ b/audio.py @@ -0,0 +1,113 @@ +# platform-dependent audio module using BASS + +import platform, ctypes, os +from pybass import constants_only as ctts +import ini + +DOWNLOADPROC = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_ulong, ctypes.c_void_p) + +dll = None +dllf = "" +opus = "" +use_ctypes = False +if platform.system() == "Windows": + dllf = "bass.dll" + opus = "bassopus.dll" +elif platform.system() == "Darwin": + dllf = "libbass.dylib" + opus = "libbassopus.dylib" +else: + dllf = "libbass.so" + opus = "libbassopus.so" + +def checkAvailable(): + """ +Check if the DLLs exist +Returns string with dll name if it's missing, empty if all DLLs are in place + """ + one = os.path.exists(os.path.abspath(dllf)) + two = os.path.exists(os.path.abspath(opus)) + if not one: return dllf + if not two: return two + return "" + + + +def init(freq=48000): + """ +Initialize BASS and the opus plugin + """ + global dll, use_ctypes + if platform.system() == "Darwin": + dll = ctypes.WinDLL(dllf) + use_ctypes = True + else: + import pybass as dll + + dll.BASS_Free() + dll.BASS_Init(ini.read_ini_int("AO2XP.ini", "Audio", "device", -1), freq, 0, 0, 0) + dll.BASS_PluginLoad(os.path.abspath(opus), 0) + +def free(): + """ +Free BASS + """ + dll.BASS_Free() + +def getcurrdevice(): + return dll.BASS_GetDevice() + +def getdevices(): + """ +Get BASS devices + """ + info = ctts.BASS_DEVICEINFO() if use_ctypes else dll.BASS_DEVICEINFO() + ind = 0 + devices = [] + while dll.BASS_GetDeviceInfo(ind, ctypes.addressof(info) if use_ctypes else info): + devices.append(info.name) + ind += 1 + return devices + +def loadhandle(mem, file, offset=0, length=0, flags=0): + """ +Load a BASS stream handle + """ + return dll.BASS_StreamCreateFile(mem, file, ctts.QWORD(offset), ctts.QWORD(length), flags) + +def loadURLhandle(url, offset, flags, proc=DOWNLOADPROC(), user=0): + """ +Load a BASS stream handle from an URL + """ + return dll.BASS_StreamCreateURL(url, offset, flags, proc, user) + +def freehandle(handle): + """ +Free a handle + """ + return dll.BASS_StreamFree(handle) + +def playhandle(handle, restart): + """ +Play a handle + """ + return dll.BASS_ChannelPlay(handle, restart) + +def stophandle(handle): + """ +Stop handle playback + """ + return dll.BASS_ChannelStop(handle) + +def handleisactive(handle): + """ +Get handle playback status + """ + return dll.BASS_ChannelIsActive(handle) + +def sethandleattr(handle, attr, value): + """ +Set handle attribute + """ + if use_ctypes and type(value) == float: value = ctypes.c_float(value) + return dll.BASS_ChannelSetAttribute(handle, attr, value) \ No newline at end of file diff --git a/gameview.py b/gameview.py index 2e36fb3..3ca48db 100644 --- a/gameview.py +++ b/gameview.py @@ -1,10 +1,11 @@ import socket, thread, time, os, buttons, urllib, charselect, ini, random -from PyQt4 import QtGui, QtCore -from pybass import * from os.path import exists -from functools import partial from ConfigParser import ConfigParser +from pybass import constants_only as bass +from PyQt4 import QtGui, QtCore +from functools import partial + import images AOpath = "base/" @@ -657,15 +658,15 @@ class gui(QtGui.QWidget): self.sfx_delay_timer.timeout.connect(self.play_sfx) if exists('mod_call.wav'): - self.modcall = BASS_StreamCreateFile(False, 'mod_call.wav', 0, 0, 0) + self.modcall = audio.loadhandle(0, "mod_call.wav", 0, 0, 0) else: self.modcall = None wtcefile = AOpath+"sounds/general/sfx-testimony2" guiltyfile = AOpath+"sounds/general/sfx-guilty" - self.wtcesfx = BASS_StreamCreateFile(False, wtcefile+".opus" if exists(wtcefile+".opus") else wtcefile+".wav", 0, 0, 0) - self.guiltysfx = BASS_StreamCreateFile(False, guiltyfile+".opus" if exists(guiltyfile+".opus") else guiltyfile+".wav", 0, 0, 0) - self.notguiltysfx = BASS_StreamCreateFile(False, "sfx-notguilty.wav", 0, 0, 0) + self.wtcesfx = audio.loadhandle(False, wtcefile+".opus" if exists(wtcefile+".opus") else wtcefile+".wav", 0, 0, 0) + self.guiltysfx = audio.loadhandle(False, guiltyfile+".opus" if exists(guiltyfile+".opus") else guiltyfile+".wav", 0, 0, 0) + self.notguiltysfx = audio.loadhandle(False, "sfx-notguilty.wav", 0, 0, 0) self.healthbars.connect(self.netmsg_hp) self.disconnectnow = False @@ -957,7 +958,7 @@ class gui(QtGui.QWidget): self.nextemotepage.show() self.realizationbtn = buttons.AOToggleButton(self, 265, 192, "realization") self.realizationbtn.clicked.connect(self.onRealizationButton) - self.realizationsnd = BASS_StreamCreateFile(False, AOpath + 'sounds/general/sfx-realization.wav', 0, 0, 0) + self.realizationsnd = audio.loadhandle(False, AOpath + 'sounds/general/sfx-realization.wav', 0, 0, 0) self.shakebtn = buttons.AOToggleButton(self, 265+42, 192, "screenshake") # AO 2.8 self.customobject = buttons.CustomObjection(self, 250, 312) self.holditbtn = buttons.Objections(self, 10, 312, 1) @@ -1102,21 +1103,21 @@ class gui(QtGui.QWidget): def changeMusicVolume(self, value): if self.music: - BASS_ChannelSetAttribute(self.music, BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.music, bass.BASS_ATTRIB_VOL, value / 100.0) def changeSoundVolume(self, value): if self.sound: - BASS_ChannelSetAttribute(self.sound, BASS_ATTRIB_VOL, value / 100.0) - BASS_ChannelSetAttribute(self.realizationsnd, BASS_ATTRIB_VOL, value / 100.0) - BASS_ChannelSetAttribute(self.wtcesfx, BASS_ATTRIB_VOL, value / 100.0) - BASS_ChannelSetAttribute(self.guiltysfx, BASS_ATTRIB_VOL, value / 100.0) - BASS_ChannelSetAttribute(self.notguiltysfx, BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.sound, bass.BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.realizationsnd, bass.BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.wtcesfx, bass.BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.guiltysfx, bass.BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.notguiltysfx, bass.BASS_ATTRIB_VOL, value / 100.0) if self.modcall: - BASS_ChannelSetAttribute(self.modcall, BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.modcall, bass.BASS_ATTRIB_VOL, value / 100.0) def changeBlipVolume(self, value): if self.blipsnd: - BASS_ChannelSetAttribute(self.blipsnd, BASS_ATTRIB_VOL, value / 100.0) + audio.sethandleattr(self.blipsnd, bass.BASS_ATTRIB_VOL, value / 100.0) def setJudgeButtons(self): if self.charside == 'jud': @@ -2054,9 +2055,9 @@ class gui(QtGui.QWidget): for callword in callwords: if callword.lower() in self.m_chatmessage[CHATMSG].lower(): self.ooclog.append("%s called you." % f_char) - snd = BASS_StreamCreateFile(False, "word_call.wav", 0, 0, BASS_STREAM_AUTOFREE) + snd = audio.loadhandle(False, "word_call.wav", 0, 0, bass.BASS_STREAM_AUTOFREE) if snd: - BASS_ChannelPlay(snd, True) + audio.playhandle(snd, True) break def do_effect(self, fx_name, fx_sound, p_char, p_folder): @@ -2120,17 +2121,17 @@ class gui(QtGui.QWidget): self.blip = self.charlist[charid][2] if exists(AOpath+"sounds/general/sfx-blip"+self.blip+".wav"): - self.blipsnd = BASS_StreamCreateFile(False, AOpath+"sounds/general/sfx-blip"+self.blip+".wav", 0, 0, 0) + self.blipsnd = audio.loadhandle(False, AOpath+"sounds/general/sfx-blip"+self.blip+".wav", 0, 0, 0) elif exists(AOpath+"sounds/general/sfx-blip"+self.blip+".opus"): - self.blipsnd = BASS_StreamCreateFile(False, AOpath+"sounds/general/sfx-blip"+self.blip+".opus", 0, 0, 0) + self.blipsnd = audio.loadhandle(False, AOpath+"sounds/general/sfx-blip"+self.blip+".opus", 0, 0, 0) elif exists(AOpath+"sounds/blips/"+self.blip+".wav"): - self.blipsnd = BASS_StreamCreateFile(False, AOpath+"sounds/blips/"+self.blip+".wav", 0, 0, 0) + self.blipsnd = audio.loadhandle(False, AOpath+"sounds/blips/"+self.blip+".wav", 0, 0, 0) elif exists(AOpath+"sounds/blips/"+self.blip+".opus"): - self.blipsnd = BASS_StreamCreateFile(False, AOpath+"sounds/blips/"+self.blip+".opus", 0, 0, 0) + self.blipsnd = audio.loadhandle(False, AOpath+"sounds/blips/"+self.blip+".opus", 0, 0, 0) else: self.blipsnd = 0 - BASS_ChannelSetAttribute(self.blipsnd, BASS_ATTRIB_VOL, self.blipslider.value() / 100.0) + audio.sethandleattr(self.blipsnd, bass.BASS_ATTRIB_VOL, self.blipslider.value() / 100.0) emote_mod = int(self.m_chatmessage[EMOTE_MOD]) if emote_mod in (0, 5) and self.m_chatmessage[SCREENSHAKE] == "1": @@ -2290,7 +2291,7 @@ class gui(QtGui.QWidget): if f_message[self.tick_pos] != " " or self.blank_blip: if self.blip_pos % self.blip_rate == 0 and not formatting_char: self.blip_pos = 0 - BASS_ChannelPlay(self.blipsnd, True) + audio.playhandle(self.blipsnd, True) self.blip_pos += 1 @@ -2307,21 +2308,21 @@ class gui(QtGui.QWidget): self.chat_tick_timer.start(self.message_display_speed[self.current_display_speed]) def playRealization(self): - BASS_ChannelPlay(self.realizationsnd, True) + audio.playhandle(self.realizationsnd, True) def playObjectionSnd(self, charname, objection): if self.objectsnd: - if BASS_ChannelIsActive(self.objectsnd): - BASS_ChannelStop(self.objectsnd) - BASS_StreamFree(self.objectsnd) + if audio.handleisactive(self.objectsnd): + audio.stophandle(self.objectsnd) + audio.freehandle(self.objectsnd) objecting = ["holdit", "objection", "takethat", "custom"][objection-1] if objecting: if exists(AOpath + 'characters/' + charname + '/' + objecting + '.wav'): - self.objectsnd = BASS_StreamCreateFile(False, AOpath + 'characters/' + charname + '/' + objecting + '.wav', 0, 0, 0) + self.objectsnd = audio.loadhandle(False, AOpath + 'characters/' + charname + '/' + objecting + '.wav', 0, 0, 0) elif exists(AOpath + 'characters/' + charname + '/' + objecting + '.opus'): - self.objectsnd = BASS_StreamCreateFile(False, AOpath + 'characters/' + charname + '/' + objecting + '.opus', 0, 0, 0) + self.objectsnd = audio.loadhandle(False, AOpath + 'characters/' + charname + '/' + objecting + '.opus', 0, 0, 0) else: self.objectsnd = None if ini.read_ini_bool("AO2XP.ini", "General", "download sounds"): @@ -2329,11 +2330,11 @@ class gui(QtGui.QWidget): thread.start_new_thread(download_thread, ("base/characters/"+charname.lower()+"/"+objecting.lower()+".opus", AOpath+"characters/"+charname.lower()+"/"+objecting.lower()+".wav")) if exists(AOpath + 'sounds/general/sfx-objection.opus'): - self.objectsnd = BASS_StreamCreateFile(False, AOpath + 'sounds/general/sfx-objection.opus', 0, 0, 0) + self.objectsnd = audio.loadhandle(False, AOpath + 'sounds/general/sfx-objection.opus', 0, 0, 0) else: - self.objectsnd = BASS_StreamCreateFile(False, AOpath + 'sounds/general/sfx-objection.wav', 0, 0, 0) - BASS_ChannelSetAttribute(self.objectsnd, BASS_ATTRIB_VOL, self.soundslider.value() / 100.0) - BASS_ChannelPlay(self.objectsnd, True) + self.objectsnd = audio.loadhandle(False, AOpath + 'sounds/general/sfx-objection.wav', 0, 0, 0) + audio.sethandleattr(self.objectsnd, bass.BASS_ATTRIB_VOL, self.soundslider.value() / 100.0) + audio.playhandle(self.objectsnd, True) def play_sfx(self): sfx_name = self.m_chatmessage[SFX] @@ -2344,53 +2345,53 @@ class gui(QtGui.QWidget): def playSound(self, sfx): if self.sound: - if BASS_ChannelIsActive(self.sound): - BASS_ChannelStop(self.sound) - BASS_StreamFree(self.sound) + if audio.handleisactive(self.sound): + audio.stophandle(self.sound) + audio.freehandle(self.sound) if exists(AOpath + 'sounds/general/' + sfx + '.wav'): - self.sound = BASS_StreamCreateFile(False, AOpath + 'sounds/general/' + sfx + '.wav', 0, 0, 0) - BASS_ChannelSetAttribute(self.sound, BASS_ATTRIB_VOL, self.soundslider.value() / 100.0) - BASS_ChannelPlay(self.sound, True) + self.sound = audio.loadhandle(False, AOpath + 'sounds/general/' + sfx + '.wav', 0, 0, 0) + audio.sethandleattr(self.sound, bass.BASS_ATTRIB_VOL, self.soundslider.value() / 100.0) + audio.playhandle(self.sound, True) elif exists(AOpath + 'sounds/general/' + sfx + '.opus'): - self.sound = BASS_StreamCreateFile(False, AOpath + 'sounds/general/' + sfx + '.opus', 0, 0, 0) - BASS_ChannelSetAttribute(self.sound, BASS_ATTRIB_VOL, self.soundslider.value() / 100.0) - BASS_ChannelPlay(self.sound, True) + self.sound = audio.loadhandle(False, AOpath + 'sounds/general/' + sfx + '.opus', 0, 0, 0) + audio.sethandleattr(self.sound, bass.BASS_ATTRIB_VOL, self.soundslider.value() / 100.0) + audio.playhandle(self.sound, True) def playMusic(self, mus): if not mus.endswith(".mp3") and "===MUSIC START===.mp3" in self.musiclist: #vidya workaround mus += ".mp3" if self.music: - if BASS_ChannelIsActive(self.music): - BASS_ChannelStop(self.music) - BASS_StreamFree(self.music) + if audio.handleisactive(self.music): + audio.stophandle(self.music) + audio.freehandle(self.music) if exists(AOpath + 'sounds/music/' + mus): - self.music = BASS_StreamCreateFile(False, AOpath + 'sounds/music/' + mus, 0, 0, 0) - BASS_ChannelSetAttribute(self.music, BASS_ATTRIB_VOL, self.musicslider.value() / 100.0) - BASS_ChannelPlay(self.music, True) + self.music = audio.loadhandle(False, AOpath + 'sounds/music/' + mus, 0, 0, 0) + audio.sethandleattr(self.music, bass.BASS_ATTRIB_VOL, self.musicslider.value() / 100.0) + audio.playhandle(self.music, True) elif ini.read_ini_bool("AO2XP.ini", "General", "download music"): if mus.lower().startswith("http"): - self.music = BASS_StreamCreateURL(mus, 0, BASS_STREAM_BLOCK, DOWNLOADPROC(), 0) + self.music = audio.loadURLhandle(mus, 0, bass.BASS_STREAM_BLOCK) else: for bucket in buckets: if not bucket: continue print "music stream:", bucket+'base/sounds/music/' + mus.lower() - self.music = BASS_StreamCreateURL(bucket+'base/sounds/music/' + mus.lower(), 0, BASS_STREAM_BLOCK, DOWNLOADPROC(), 0) + self.music = audio.loadURLhandle(bucket+'base/sounds/music/' + mus.lower(), 0, bass.BASS_STREAM_BLOCK) if self.music: break if self.music: - BASS_ChannelSetAttribute(self.music, BASS_ATTRIB_VOL, self.musicslider.value() / 100.0) - BASS_ChannelPlay(self.music, True) + audio.sethandleattr(self.music, bass.BASS_ATTRIB_VOL, self.musicslider.value() / 100.0) + audio.playhandle(self.music, True) def stopMusic(self): if self.music: - if BASS_ChannelIsActive(self.music): - BASS_ChannelStop(self.music) - BASS_StreamFree(self.music) + if audio.handleisactive(self.music): + audio.stophandle(self.music) + audio.freehandle(self.music) def startGame(self, tcp, charlist, musiclist, background, evidence, areas, features=[], oocjoin=[], hplist=[], webAO_bucket=""): self.willDisconnect = False @@ -2826,7 +2827,7 @@ class TCP_Thread(QtCore.QThread): elif header == 'ZZ': if self.parent.modcall: - BASS_ChannelPlay(self.parent.modcall, False) + audio.playhandle(self.parent.modcall, False) if len(network) > 1: self.OOC_Log.emit('[MOD CALL] ' + network[1].replace("\n", "
") + '
') @@ -2844,12 +2845,12 @@ class TCP_Thread(QtCore.QThread): if testimony == 'judgeruling': variant = int(network[2]) if variant == 0: - BASS_ChannelPlay(self.parent.notguiltysfx, True) + audio.playhandle(self.parent.notguiltysfx, True) elif variant == 1: - BASS_ChannelPlay(self.parent.guiltysfx, True) + audio.playhandle(self.parent.guiltysfx, True) else: variant = 0 - BASS_ChannelPlay(self.parent.wtcesfx, True) + audio.playhandle(self.parent.wtcesfx, True) self.parent.WTCEsignal.emit(testimony, variant) elif header == 'HP': diff --git a/options.py b/options.py index 5f472da..4516362 100644 --- a/options.py +++ b/options.py @@ -1,8 +1,9 @@ -from PyQt4 import QtGui, QtCore -from pybass import * from ConfigParser import ConfigParser from os.path import exists from os import listdir + +from PyQt4 import QtGui, QtCore + import ini AOpath = "base/" @@ -131,11 +132,8 @@ class Settings(QtGui.QDialog): audio_layout.setWidget(4, QtGui.QFormLayout.LabelRole, bliplabel) audio_layout.setWidget(4, QtGui.QFormLayout.FieldRole, self.blipslider) - info = BASS_DEVICEINFO() - ind = 0 - while BASS_GetDeviceInfo(ind, info): - self.device_list.addItem(info.name) - ind += 1 + for device in audio.getdevices(): + self.device_list.addItem(device) ###### Callwords tab ###### self.callwords_edit = QtGui.QTextEdit() @@ -179,7 +177,7 @@ class Settings(QtGui.QDialog): self.allowdownload_evidence.setChecked(ini.read_ini_bool(self.inifile, "General", "download evidence")) self.currtheme.setCurrentIndex(self.themes.index(ini.read_ini(self.inifile, "General", "theme", "default"))) - self.device_list.setCurrentIndex(ini.read_ini_int(self.inifile, "Audio", "device", BASS_GetDevice())) + self.device_list.setCurrentIndex(ini.read_ini_int(self.inifile, "Audio", "device", audio.getcurrdevice())) self.musicslider.setValue(ini.read_ini_int(self.inifile, "Audio", "Music volume", 100)) self.soundslider.setValue(ini.read_ini_int(self.inifile, "Audio", "Sound volume", 100)) self.blipslider.setValue(ini.read_ini_int(self.inifile, "Audio", "Blip volume", 100)) @@ -193,7 +191,7 @@ class Settings(QtGui.QDialog): self.allowdownload_evidence.setChecked(True) self.currtheme.setCurrentIndex(self.themes.index("default")) - self.device_list.setCurrentIndex(BASS_GetDevice()) + self.device_list.setCurrentIndex(audio.getcurrdevice()) self.musicslider.setValue(100) self.soundslider.setValue(100) self.blipslider.setValue(100) diff --git a/pybass/constants_only.py b/pybass/constants_only.py new file mode 100644 index 0000000..696c48f --- /dev/null +++ b/pybass/constants_only.py @@ -0,0 +1,797 @@ +# Copyright(c) Maxim Kolosov 2009-2013 pyirrlicht@gmail.com +# http://pybass.sf.net +# BSD license + +__version__ = '0.5.5' +__versionTime__ = '2013-11-29' +__author__ = 'Maxim Kolosov ' +__doc__ = ''' +pybass.py - is ctypes python module for BASS (http://www.un4seen.com). + +BASS is an audio library for use in Windows, Linux 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. + +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 +''' + +import sys, ctypes, platform + +if sys.hexversion < 0x02060000: + ctypes.c_bool = ctypes.c_byte + +QWORD = ctypes.c_int64 + +def LOBYTE(a): return (ctypes.c_byte)(a) +def HIBYTE(a): return (ctypes.c_byte)((a)>>8) +def LOWORD(a): return (ctypes.c_ushort)(a) +def HIWORD(a): return (ctypes.c_ushort)((a)>>16) +def MAKEWORD(a,b): return (ctypes.c_ushort)(((a)&0xff)|((b)<<8)) +def MAKELONG(a,b): return (ctypes.c_ulong)(((a)&0xffff)|((b)<<16)) + +BASSVERSION = 0x204 +BASSVERSIONTEXT = '2.4' + +HMUSIC = ctypes.c_ulong # MOD music handle +HSAMPLE = ctypes.c_ulong # sample handle +HCHANNEL = ctypes.c_ulong # playing sample's channel handle +HSTREAM = ctypes.c_ulong # sample stream handle +HRECORD = ctypes.c_ulong # recording handle +HSYNC = ctypes.c_ulong # synchronizer handle +HDSP = ctypes.c_ulong # DSP handle +HFX = ctypes.c_ulong # DX8 effect handle +HPLUGIN = ctypes.c_ulong # Plugin handle + +# Error codes returned by BASS_ErrorGetCode +error_descriptions = {} +BASS_OK = 0 +error_descriptions[BASS_OK] = 'all is OK' +BASS_ERROR_MEM = 1 +error_descriptions[BASS_ERROR_MEM] = 'memory error' +BASS_ERROR_FILEOPEN = 2 +error_descriptions[BASS_ERROR_FILEOPEN] = "can't open the file" +BASS_ERROR_DRIVER = 3 +error_descriptions[BASS_ERROR_DRIVER] = "can't find a free/valid driver" +BASS_ERROR_BUFLOST = 4 +error_descriptions[BASS_ERROR_BUFLOST] = 'the sample buffer was lost' +BASS_ERROR_HANDLE = 5 +error_descriptions[BASS_ERROR_HANDLE] = 'invalid handle' +BASS_ERROR_FORMAT = 6 +error_descriptions[BASS_ERROR_FORMAT] = 'unsupported sample format' +BASS_ERROR_POSITION = 7 +error_descriptions[BASS_ERROR_POSITION] = 'invalid position' +BASS_ERROR_INIT = 8 +error_descriptions[BASS_ERROR_INIT] = 'BASS_Init has not been successfully called' +BASS_ERROR_START = 9 +error_descriptions[BASS_ERROR_START] = 'BASS_Start has not been successfully called' +BASS_ERROR_ALREADY = 14 +error_descriptions[BASS_ERROR_ALREADY] = 'already initialized/paused/whatever' +BASS_ERROR_NOCHAN = 18 +error_descriptions[BASS_ERROR_NOCHAN] = "can't get a free channel" +BASS_ERROR_ILLTYPE = 19 +error_descriptions[BASS_ERROR_ILLTYPE] = 'an illegal type was specified' +BASS_ERROR_ILLPARAM = 20 +error_descriptions[BASS_ERROR_ILLPARAM] = 'an illegal parameter was specified' +BASS_ERROR_NO3D = 21 +error_descriptions[BASS_ERROR_NO3D] = 'no 3D support' +BASS_ERROR_NOEAX = 22 +error_descriptions[BASS_ERROR_NOEAX] = 'no EAX support' +BASS_ERROR_DEVICE = 23 +error_descriptions[BASS_ERROR_DEVICE] = 'illegal device number' +BASS_ERROR_NOPLAY = 24 +error_descriptions[BASS_ERROR_NOPLAY] = 'not playing' +BASS_ERROR_FREQ = 25 +error_descriptions[BASS_ERROR_FREQ] = 'illegal sample rate' +BASS_ERROR_NOTFILE = 27 +error_descriptions[BASS_ERROR_NOTFILE] = 'the stream is not a file stream' +BASS_ERROR_NOHW = 29 +error_descriptions[BASS_ERROR_NOHW] = 'no hardware voices available' +BASS_ERROR_EMPTY = 31 +error_descriptions[BASS_ERROR_EMPTY] = 'the MOD music has no sequence data' +BASS_ERROR_NONET = 32 +error_descriptions[BASS_ERROR_NONET] = 'no internet connection could be opened' +BASS_ERROR_CREATE = 33 +error_descriptions[BASS_ERROR_CREATE] = "couldn't create the file" +BASS_ERROR_NOFX = 34 +error_descriptions[BASS_ERROR_NOFX] = 'effects are not available' +BASS_ERROR_NOTAVAIL = 37 +error_descriptions[BASS_ERROR_NOTAVAIL] = 'requested data is not available' +BASS_ERROR_DECODE = 38 +error_descriptions[BASS_ERROR_DECODE] = 'the channel is a "decoding channel"' +BASS_ERROR_DX = 39 +error_descriptions[BASS_ERROR_DX] = 'a sufficient DirectX version is not installed' +BASS_ERROR_TIMEOUT = 40 +error_descriptions[BASS_ERROR_TIMEOUT] = 'connection timedout' +BASS_ERROR_FILEFORM = 41 +error_descriptions[BASS_ERROR_FILEFORM] = 'unsupported file format' +BASS_ERROR_SPEAKER = 42 +error_descriptions[BASS_ERROR_SPEAKER] = 'unavailable speaker' +BASS_ERROR_VERSION = 43 +error_descriptions[BASS_ERROR_VERSION] = 'invalid BASS version (used by add-ons)' +BASS_ERROR_CODEC = 44 +error_descriptions[BASS_ERROR_CODEC] = 'codec is not available/supported' +BASS_ERROR_ENDED = 45 +error_descriptions[BASS_ERROR_ENDED] = 'the channel/file has ended' +BASS_ERROR_BUSY = 46 +error_descriptions[BASS_ERROR_ENDED] = 'the device is busy' +BASS_ERROR_UNKNOWN = -1 +error_descriptions[BASS_ERROR_UNKNOWN] = 'some other mystery problem' + +def get_error_description(error_code = -1): + return error_descriptions.get(error_code, 'unknown BASS error code ' + str(error_code)) + +# BASS_SetConfig options +BASS_CONFIG_BUFFER = 0 +BASS_CONFIG_UPDATEPERIOD = 1 +BASS_CONFIG_GVOL_SAMPLE = 4 +BASS_CONFIG_GVOL_STREAM = 5 +BASS_CONFIG_GVOL_MUSIC = 6 +BASS_CONFIG_CURVE_VOL = 7 +BASS_CONFIG_CURVE_PAN = 8 +BASS_CONFIG_FLOATDSP = 9 +BASS_CONFIG_3DALGORITHM = 10 +BASS_CONFIG_NET_TIMEOUT = 11 +BASS_CONFIG_NET_BUFFER = 12 +BASS_CONFIG_PAUSE_NOPLAY = 13 +BASS_CONFIG_NET_PREBUF = 15 +BASS_CONFIG_NET_PASSIVE = 18 +BASS_CONFIG_REC_BUFFER = 19 +BASS_CONFIG_NET_PLAYLIST = 21 +BASS_CONFIG_MUSIC_VIRTUAL = 22 +BASS_CONFIG_VERIFY = 23 +BASS_CONFIG_UPDATETHREADS = 24 +BASS_CONFIG_DEV_BUFFER = 27 +BASS_CONFIG_VISTA_TRUEPOS = 30 +BASS_CONFIG_IOS_MIXAUDIO = 34 +BASS_CONFIG_DEV_DEFAULT = 36 +BASS_CONFIG_NET_READTIMEOUT = 37 +BASS_CONFIG_VISTA_SPEAKERS = 38 +BASS_CONFIG_IOS_SPEAKER = 39 +BASS_CONFIG_HANDLES = 41 +BASS_CONFIG_UNICODE = 42 +BASS_CONFIG_SRC = 43 +BASS_CONFIG_SRC_SAMPLE = 44 +BASS_CONFIG_ASYNCFILE_BUFFER = 45 +BASS_CONFIG_OGG_PRESCAN = 47 + +# BASS_SetConfigPtr options +BASS_CONFIG_NET_AGENT = 16 +BASS_CONFIG_NET_PROXY = 17 +BASS_CONFIG_IOS_NOTIFY = 46 + +# BASS_Init flags +BASS_DEVICE_8BITS = 1# use 8 bit resolution, else 16 bit +BASS_DEVICE_MONO = 2# use mono, else stereo +BASS_DEVICE_3D = 4# enable 3D functionality +BASS_DEVICE_LATENCY = 0x100# calculate device latency (BASS_INFO struct) +BASS_DEVICE_CPSPEAKERS = 0x400# detect speakers via Windows control panel +BASS_DEVICE_SPEAKERS = 0x800# force enabling of speaker assignment +BASS_DEVICE_NOSPEAKER = 0x1000# ignore speaker arrangement +BASS_DEVICE_DMIX = 0x2000# use ALSA "dmix" plugin +BASS_DEVICE_FREQ = 0x4000# set device sample rate + +# DirectSound interfaces (for use with BASS_GetDSoundObject) +BASS_OBJECT_DS = 1# IDirectSound +BASS_OBJECT_DS3DL = 2# IDirectSound3DListener + +# Device info structure +class BASS_DEVICEINFO(ctypes.Structure): + _fields_ = [('name', ctypes.c_char_p),#description + ('driver', ctypes.c_char_p),#driver + ('flags', ctypes.c_ulong) + ] +if platform.system().lower() == 'windows': + if sys.getwindowsversion()[3] == 3:#VER_PLATFORM_WIN32_CE + BASS_DEVICEINFO._fields_ = [('name', ctypes.c_wchar_p),#description + ('driver', ctypes.c_wchar_p),#driver + ('flags', ctypes.c_ulong) + ] + +# BASS_DEVICEINFO flags +BASS_DEVICE_ENABLED = 1 +BASS_DEVICE_DEFAULT = 2 +BASS_DEVICE_INIT = 4 + +class BASS_INFO(ctypes.Structure): + _fields_ = [('flags', ctypes.c_ulong),#device capabilities (DSCAPS_xxx flags) + ('hwsize', ctypes.c_ulong),#size of total device hardware memory + ('hwfree', ctypes.c_ulong),#size of free device hardware memory + ('freesam', ctypes.c_ulong),#number of free sample slots in the hardware + ('free3d', ctypes.c_ulong),#number of free 3D sample slots in the hardware + ('minrate', ctypes.c_ulong),#min sample rate supported by the hardware + ('maxrate', ctypes.c_ulong),#max sample rate supported by the hardware + ('eax', ctypes.c_bool),#device supports EAX? (always FALSE if BASS_DEVICE_3D was not used) + ('minbuf', ctypes.c_ulong),#recommended minimum buffer length in ms (requires BASS_DEVICE_LATENCY) + ('dsver', ctypes.c_ulong),#DirectSound version + ('latency', ctypes.c_ulong),#delay (in ms) before start of playback (requires BASS_DEVICE_LATENCY) + ('initflags', ctypes.c_ulong),#BASS_Init "flags" parameter + ('speakers', ctypes.c_ulong),#number of speakers available + ('freq', ctypes.c_ulong)#current output rate (Vista/OSX only) + ] + +# BASS_INFO flags (from DSOUND.H) +DSCAPS_CONTINUOUSRATE = 0x00000010# supports all sample rates between min/maxrate +DSCAPS_EMULDRIVER = 0x00000020# device does NOT have hardware DirectSound support +DSCAPS_CERTIFIED = 0x00000040# device driver has been certified by Microsoft +DSCAPS_SECONDARYMONO = 0x00000100# mono +DSCAPS_SECONDARYSTEREO = 0x00000200# stereo +DSCAPS_SECONDARY8BIT = 0x00000400# 8 bit +DSCAPS_SECONDARY16BIT = 0x00000800# 16 bit + +# Recording device info structure +class BASS_RECORDINFO(ctypes.Structure): + _fields_ = [('flags', ctypes.c_ulong),#DWORD flags;// device capabilities (DSCCAPS_xxx flags) + ('formats', ctypes.c_ulong),#DWORD formats;// supported standard formats (WAVE_FORMAT_xxx flags) + ('inputs', ctypes.c_ulong),#DWORD inputs; // number of inputs + ('singlein', ctypes.c_ubyte),#BOOL singlein;// TRUE = only 1 input can be set at a time + ('freq', ctypes.c_ulong)#DWORD freq; // current input rate (Vista/OSX only) + ] + +# BASS_RECORDINFO flags (from DSOUND.H) +DSCCAPS_EMULDRIVER = DSCAPS_EMULDRIVER# device does NOT have hardware DirectSound recording support +DSCCAPS_CERTIFIED = DSCAPS_CERTIFIED# device driver has been certified by Microsoft + +# defines for formats field of BASS_RECORDINFO (from MMSYSTEM.H) +WAVE_FORMAT_1M08 = 0x00000001# 11.025 kHz, Mono, 8-bit +WAVE_FORMAT_1S08 = 0x00000002# 11.025 kHz, Stereo, 8-bit +WAVE_FORMAT_1M16 = 0x00000004# 11.025 kHz, Mono, 16-bit +WAVE_FORMAT_1S16 = 0x00000008# 11.025 kHz, Stereo, 16-bit +WAVE_FORMAT_2M08 = 0x00000010# 22.05 kHz, Mono, 8-bit +WAVE_FORMAT_2S08 = 0x00000020# 22.05 kHz, Stereo, 8-bit +WAVE_FORMAT_2M16 = 0x00000040# 22.05 kHz, Mono, 16-bit +WAVE_FORMAT_2S16 = 0x00000080# 22.05 kHz, Stereo, 16-bit +WAVE_FORMAT_4M08 = 0x00000100# 44.1 kHz, Mono, 8-bit +WAVE_FORMAT_4S08 = 0x00000200# 44.1 kHz, Stereo, 8-bit +WAVE_FORMAT_4M16 = 0x00000400# 44.1 kHz, Mono, 16-bit +WAVE_FORMAT_4S16 = 0x00000800# 44.1 kHz, Stereo, 16-bit + +# Sample info structure +class BASS_SAMPLE(ctypes.Structure): + _fields_ = [('freq', ctypes.c_ulong),#DWORD freq;// default playback rate + ('volume', ctypes.c_float),#float volume;// default volume (0-1) + ('pan', ctypes.c_float),#float pan;// default pan (-1=left, 0=middle, 1=right) + ('flags', ctypes.c_ulong),#DWORD flags;// BASS_SAMPLE_xxx flags + ('length', ctypes.c_ulong),#DWORD length;// length (in bytes) + ('max', ctypes.c_ulong),#DWORD max;// maximum simultaneous playbacks + ('origres', ctypes.c_ulong),#DWORD origres;// original resolution bits + ('chans', ctypes.c_ulong),#DWORD chans;// number of channels + ('mingap', ctypes.c_ulong),#DWORD mingap; // minimum gap (ms) between creating channels + ('mode3d', ctypes.c_ulong),#DWORD mode3d;// BASS_3DMODE_xxx mode + ('mindist', ctypes.c_float),#float mindist;// minimum distance + ('maxdist', ctypes.c_float),#float maxdist;// maximum distance + ('iangle', ctypes.c_ulong),#DWORD iangle;// angle of inside projection cone + ('oangle', ctypes.c_ulong),#DWORD oangle;// angle of outside projection cone + ('outvol', ctypes.c_float),#float outvol;// delta-volume outside the projection cone + ('vam', ctypes.c_ulong),#DWORD vam;// voice allocation/management flags (BASS_VAM_xxx) + ('priority', ctypes.c_ulong)#DWORD priority;// priority (0=lowest, 0xffffffff=highest) + ] + +BASS_SAMPLE_8BITS = 1# 8 bit +BASS_SAMPLE_FLOAT = 256# 32-bit floating-point +BASS_SAMPLE_MONO = 2# mono +BASS_SAMPLE_LOOP = 4# looped +BASS_SAMPLE_3D = 8# 3D functionality +BASS_SAMPLE_SOFTWARE = 16# not using hardware mixing +BASS_SAMPLE_MUTEMAX = 32# mute at max distance (3D only) +BASS_SAMPLE_VAM = 64# DX7 voice allocation & management +BASS_SAMPLE_FX = 128# old implementation of DX8 effects +BASS_SAMPLE_OVER_VOL = 0x10000# override lowest volume +BASS_SAMPLE_OVER_POS = 0x20000# override longest playing +BASS_SAMPLE_OVER_DIST = 0x30000# override furthest from listener (3D only) +BASS_STREAM_PRESCAN = 0x20000# enable pin-point seeking/length (MP3/MP2/MP1) +BASS_MP3_SETPOS = BASS_STREAM_PRESCAN +BASS_STREAM_AUTOFREE = 0x40000# automatically free the stream when it stop/ends +BASS_STREAM_RESTRATE = 0x80000# restrict the download rate of internet file streams +BASS_STREAM_BLOCK = 0x100000# download/play internet file stream in small blocks +BASS_STREAM_DECODE = 0x200000# don't play the stream, only decode (BASS_ChannelGetData) +BASS_STREAM_STATUS = 0x800000# give server status info (HTTP/ICY tags) in DOWNLOADPROC + +BASS_MUSIC_FLOAT = BASS_SAMPLE_FLOAT +BASS_MUSIC_MONO = BASS_SAMPLE_MONO +BASS_MUSIC_LOOP = BASS_SAMPLE_LOOP +BASS_MUSIC_3D = BASS_SAMPLE_3D +BASS_MUSIC_FX = BASS_SAMPLE_FX +BASS_MUSIC_AUTOFREE = BASS_STREAM_AUTOFREE +BASS_MUSIC_DECODE = BASS_STREAM_DECODE +BASS_MUSIC_PRESCAN = BASS_STREAM_PRESCAN# calculate playback length +BASS_MUSIC_CALCLEN = BASS_MUSIC_PRESCAN +BASS_MUSIC_RAMP = 0x200# normal ramping +BASS_MUSIC_RAMPS = 0x400# sensitive ramping +BASS_MUSIC_SURROUND = 0x800# surround sound +BASS_MUSIC_SURROUND2 = 0x1000# surround sound (mode 2) +BASS_MUSIC_FT2MOD = 0x2000# play .MOD as FastTracker 2 does +BASS_MUSIC_PT1MOD = 0x4000# play .MOD as ProTracker 1 does +BASS_MUSIC_NONINTER = 0x10000# non-interpolated sample mixing +BASS_MUSIC_SINCINTER = 0x800000# sinc interpolated sample mixing +BASS_MUSIC_POSRESET = 0x8000# stop all notes when moving position +BASS_MUSIC_POSRESETEX = 0x400000# stop all notes and reset bmp/etc when moving position +BASS_MUSIC_STOPBACK = 0x80000# stop the music on a backwards jump effect +BASS_MUSIC_NOSAMPLE = 0x100000# don't load the samples + +# Speaker assignment flags +BASS_SPEAKER_FRONT = 0x1000000# front speakers +BASS_SPEAKER_REAR = 0x2000000# rear/side speakers +BASS_SPEAKER_CENLFE = 0x3000000# center & LFE speakers (5.1) +BASS_SPEAKER_REAR2 = 0x4000000# rear center speakers (7.1) +def BASS_SPEAKER_N(n): return ((n)<<24)# n'th pair of speakers (max 15) +BASS_SPEAKER_LEFT = 0x10000000# modifier: left +BASS_SPEAKER_RIGHT = 0x20000000# modifier: right +BASS_SPEAKER_FRONTLEFT = BASS_SPEAKER_FRONT|BASS_SPEAKER_LEFT +BASS_SPEAKER_FRONTRIGHT = BASS_SPEAKER_FRONT|BASS_SPEAKER_RIGHT +BASS_SPEAKER_REARLEFT = BASS_SPEAKER_REAR|BASS_SPEAKER_LEFT +BASS_SPEAKER_REARRIGHT = BASS_SPEAKER_REAR|BASS_SPEAKER_RIGHT +BASS_SPEAKER_CENTER = BASS_SPEAKER_CENLFE|BASS_SPEAKER_LEFT +BASS_SPEAKER_LFE = BASS_SPEAKER_CENLFE|BASS_SPEAKER_RIGHT +BASS_SPEAKER_REAR2LEFT = BASS_SPEAKER_REAR2|BASS_SPEAKER_LEFT +BASS_SPEAKER_REAR2RIGHT = BASS_SPEAKER_REAR2|BASS_SPEAKER_RIGHT +BASS_ASYNCFILE = 0x40000000 +BASS_UNICODE = 0x80000000#-2147483648 +BASS_RECORD_PAUSE = 0x8000# start recording paused + +# DX7 voice allocation & management flags +BASS_VAM_HARDWARE = 1 +BASS_VAM_SOFTWARE = 2 +BASS_VAM_TERM_TIME = 4 +BASS_VAM_TERM_DIST = 8 +BASS_VAM_TERM_PRIO = 16 + +# Channel info structure +class BASS_CHANNELINFO(ctypes.Structure): + _fields_ = [('freq', ctypes.c_ulong),#DWORD freq;// default playback rate + ('chans', ctypes.c_ulong),#DWORD chans;// channels + ('flags', ctypes.c_ulong),#DWORD flags;// BASS_SAMPLE/STREAM/MUSIC/SPEAKER flags + ('ctype', ctypes.c_ulong),#DWORD ctype;// type of channel + ('origres', ctypes.c_ulong),#DWORD origres;// original resolution + ('plugin', HPLUGIN),#HPLUGIN plugin;// plugin + ('sample', HSAMPLE),#HSAMPLE sample;// sample + ('filename', ctypes.c_char_p)#const char *filename;// filename + ] + +BASS_CTYPE_SAMPLE = 1 +BASS_CTYPE_RECORD = 2 +BASS_CTYPE_STREAM = 0x10000 +BASS_CTYPE_STREAM_OGG = 0x10002 +BASS_CTYPE_STREAM_MP1 = 0x10003 +BASS_CTYPE_STREAM_MP2 = 0x10004 +BASS_CTYPE_STREAM_MP3 = 0x10005 +BASS_CTYPE_STREAM_AIFF = 0x10006 +BASS_CTYPE_STREAM_CA = 0x10007 +BASS_CTYPE_STREAM_MF = 0x10008 +BASS_CTYPE_STREAM_WAV = 0x40000# WAVE flag, LOWORD=codec +BASS_CTYPE_STREAM_WAV_PCM = 0x50001 +BASS_CTYPE_STREAM_WAV_FLOAT = 0x50003 +BASS_CTYPE_MUSIC_MOD = 0x20000 +BASS_CTYPE_MUSIC_MTM = 0x20001 +BASS_CTYPE_MUSIC_S3M = 0x20002 +BASS_CTYPE_MUSIC_XM = 0x20003 +BASS_CTYPE_MUSIC_IT = 0x20004 +BASS_CTYPE_MUSIC_MO3 = 0x00100# MO3 flag + +class BASS_PLUGINFORM(ctypes.Structure): + _fields_ = [('ctype', ctypes.c_ulong),#DWORD ctype; // channel type + ('name', ctypes.c_char_p),#const char *name; // format description + ('exts', ctypes.c_char_p)#const char *exts; // file extension filter (*.ext1;*.ext2;etc...) + ] +if platform.system().lower() == 'windows': + if sys.getwindowsversion()[3] == 3:#VER_PLATFORM_WIN32_CE + BASS_PLUGINFORM._fields_ = [('ctype', ctypes.c_ulong),#DWORD ctype; // channel type + ('name', ctypes.c_wchar_p),#const wchar_t *name; // format description + ('exts', ctypes.c_wchar_p)#const wchar_t *exts; // file extension filter (*.ext1;*.ext2;etc...) + ] + +class BASS_PLUGININFO(ctypes.Structure): + _fields_ = [('version', ctypes.c_ulong),#DWORD version;// version (same form as BASS_GetVersion) + ('formatc', ctypes.c_ulong),#DWORD formatc;// number of formats + ('formats', ctypes.POINTER(BASS_PLUGINFORM))#const BASS_PLUGINFORM *formats;// the array of formats + ] + +# 3D vector (for 3D positions/velocities/orientations) +class BASS_3DVECTOR(ctypes.Structure): + _fields_ = [('x', ctypes.c_float),#float x;// +=right, -=left + ('y', ctypes.c_float),#float y;// +=up, -=down + ('z', ctypes.c_float)#float z;// +=front, -=behind + ] + +# 3D channel modes +BASS_3DMODE_NORMAL = 0 +BASS_3DMODE_RELATIVE = 1 +BASS_3DMODE_OFF = 2 + +# software 3D mixing algorithms (used with BASS_CONFIG_3DALGORITHM) +BASS_3DALG_DEFAULT = 0 +BASS_3DALG_OFF = 1 +BASS_3DALG_FULL = 2 +BASS_3DALG_LIGHT = 3 + +# EAX environments, use with BASS_SetEAXParameters +EAX_ENVIRONMENT_GENERIC = 0 +EAX_ENVIRONMENT_PADDEDCELL = 1 +EAX_ENVIRONMENT_ROOM = 2 +EAX_ENVIRONMENT_BATHROOM = 3 +EAX_ENVIRONMENT_LIVINGROOM = 4 +EAX_ENVIRONMENT_STONEROOM = 5 +EAX_ENVIRONMENT_AUDITORIUM = 6 +EAX_ENVIRONMENT_CONCERTHALL = 7 +EAX_ENVIRONMENT_CAVE = 8 +EAX_ENVIRONMENT_ARENA = 9 +EAX_ENVIRONMENT_HANGAR = 10 +EAX_ENVIRONMENT_CARPETEDHALLWAY = 11 +EAX_ENVIRONMENT_HALLWAY = 12 +EAX_ENVIRONMENT_STONECORRIDOR = 13 +EAX_ENVIRONMENT_ALLEY = 14 +EAX_ENVIRONMENT_FOREST = 15 +EAX_ENVIRONMENT_CITY = 16 +EAX_ENVIRONMENT_MOUNTAINS = 17 +EAX_ENVIRONMENT_QUARRY = 18 +EAX_ENVIRONMENT_PLAIN = 19 +EAX_ENVIRONMENT_PARKINGLOT = 20 +EAX_ENVIRONMENT_SEWERPIPE = 21 +EAX_ENVIRONMENT_UNDERWATER = 22 +EAX_ENVIRONMENT_DRUGGED = 23 +EAX_ENVIRONMENT_DIZZY = 24 +EAX_ENVIRONMENT_PSYCHOTIC = 25 +EAX_ENVIRONMENT_COUNT = 26# total number of environments + +# EAX presets, usage: BASS_SetEAXParameters(EAX_PRESET_xxx) +EAX_PRESET_GENERIC =(EAX_ENVIRONMENT_GENERIC,0.5,1.493,0.5) +EAX_PRESET_PADDEDCELL =(EAX_ENVIRONMENT_PADDEDCELL,0.25,0.1,0.0) +EAX_PRESET_ROOM =(EAX_ENVIRONMENT_ROOM,0.417,0.4,0.666) +EAX_PRESET_BATHROOM =(EAX_ENVIRONMENT_BATHROOM,0.653,1.499,0.166) +EAX_PRESET_LIVINGROOM =(EAX_ENVIRONMENT_LIVINGROOM,0.208,0.478,0.0) +EAX_PRESET_STONEROOM =(EAX_ENVIRONMENT_STONEROOM,0.5,2.309,0.888) +EAX_PRESET_AUDITORIUM =(EAX_ENVIRONMENT_AUDITORIUM,0.403,4.279,0.5) +EAX_PRESET_CONCERTHALL =(EAX_ENVIRONMENT_CONCERTHALL,0.5,3.961,0.5) +EAX_PRESET_CAVE =(EAX_ENVIRONMENT_CAVE,0.5,2.886,1.304) +EAX_PRESET_ARENA =(EAX_ENVIRONMENT_ARENA,0.361,7.284,0.332) +EAX_PRESET_HANGAR =(EAX_ENVIRONMENT_HANGAR,0.5,10.0,0.3) +EAX_PRESET_CARPETEDHALLWAY =(EAX_ENVIRONMENT_CARPETEDHALLWAY,0.153,0.259,2.0) +EAX_PRESET_HALLWAY =(EAX_ENVIRONMENT_HALLWAY,0.361,1.493,0.0) +EAX_PRESET_STONECORRIDOR =(EAX_ENVIRONMENT_STONECORRIDOR,0.444,2.697,0.638) +EAX_PRESET_ALLEY =(EAX_ENVIRONMENT_ALLEY,0.25,1.752,0.776) +EAX_PRESET_FOREST =(EAX_ENVIRONMENT_FOREST,0.111,3.145,0.472) +EAX_PRESET_CITY =(EAX_ENVIRONMENT_CITY,0.111,2.767,0.224) +EAX_PRESET_MOUNTAINS =(EAX_ENVIRONMENT_MOUNTAINS,0.194,7.841,0.472) +EAX_PRESET_QUARRY =(EAX_ENVIRONMENT_QUARRY,1.0,1.499,0.5) +EAX_PRESET_PLAIN =(EAX_ENVIRONMENT_PLAIN,0.097,2.767,0.224) +EAX_PRESET_PARKINGLOT =(EAX_ENVIRONMENT_PARKINGLOT,0.208,1.652,1.5) +EAX_PRESET_SEWERPIPE =(EAX_ENVIRONMENT_SEWERPIPE,0.652,2.886,0.25) +EAX_PRESET_UNDERWATER =(EAX_ENVIRONMENT_UNDERWATER,1.0,1.499,0.0) +EAX_PRESET_DRUGGED =(EAX_ENVIRONMENT_DRUGGED,0.875,8.392,1.388) +EAX_PRESET_DIZZY =(EAX_ENVIRONMENT_DIZZY,0.139,17.234,0.666) +EAX_PRESET_PSYCHOTIC =(EAX_ENVIRONMENT_PSYCHOTIC,0.486,7.563,0.806) + +# BASS_StreamCreateFileUser file systems +STREAMFILE_NOBUFFER = 0 +STREAMFILE_BUFFER = 1 +STREAMFILE_BUFFERPUSH = 2 + +# BASS_StreamPutFileData options +BASS_FILEDATA_END = 0 + +# BASS_StreamGetFilePosition modes +BASS_FILEPOS_CURRENT = 0 +BASS_FILEPOS_DECODE = BASS_FILEPOS_CURRENT +BASS_FILEPOS_DOWNLOAD = 1 +BASS_FILEPOS_END = 2 +BASS_FILEPOS_START = 3 +BASS_FILEPOS_CONNECTED = 4 +BASS_FILEPOS_BUFFER = 5 +BASS_FILEPOS_SOCKET = 6 + +# BASS_ChannelSetSync types +BASS_SYNC_POS = 0 +BASS_SYNC_END = 2 +BASS_SYNC_META = 4 +BASS_SYNC_SLIDE = 5 +BASS_SYNC_STALL = 6 +BASS_SYNC_DOWNLOAD = 7 +BASS_SYNC_FREE = 8 +BASS_SYNC_SETPOS = 11 +BASS_SYNC_MUSICPOS = 10 +BASS_SYNC_MUSICINST = 1 +BASS_SYNC_MUSICFX = 3 +BASS_SYNC_OGG_CHANGE = 12 +BASS_SYNC_MIXTIME = 0x40000000# FLAG: sync at mixtime, else at playtime +BASS_SYNC_ONETIME = 0x80000000# FLAG: sync only once, else continuously + +# BASS_ChannelIsActive return values +BASS_ACTIVE_STOPPED = 0 +BASS_ACTIVE_PLAYING = 1 +BASS_ACTIVE_STALLED = 2 +BASS_ACTIVE_PAUSED = 3 + +# Channel attributes +BASS_ATTRIB_FREQ = 1 +BASS_ATTRIB_VOL = 2 +BASS_ATTRIB_PAN = 3 +BASS_ATTRIB_EAXMIX = 4 +BASS_ATTRIB_NOBUFFER = 5 +BASS_ATTRIB_CPU = 7 +BASS_ATTRIB_SRC = 8 +BASS_ATTRIB_MUSIC_AMPLIFY = 0x100 +BASS_ATTRIB_MUSIC_PANSEP = 0x101 +BASS_ATTRIB_MUSIC_PSCALER = 0x102 +BASS_ATTRIB_MUSIC_BPM = 0x103 +BASS_ATTRIB_MUSIC_SPEED = 0x104 +BASS_ATTRIB_MUSIC_VOL_GLOBAL = 0x105 +BASS_ATTRIB_MUSIC_VOL_CHAN = 0x200# + channel # +BASS_ATTRIB_MUSIC_VOL_INST = 0x300# + instrument # + +# BASS_ChannelGetData flags +BASS_DATA_AVAILABLE = 0# query how much data is buffered +BASS_DATA_FLOAT = 0x40000000# flag: return floating-point sample data +BASS_DATA_FFT256 = 0x80000000#-2147483648# 256 sample FFT +BASS_DATA_FFT512 = 0x80000001#-2147483647# 512 FFT +BASS_DATA_FFT1024 = 0x80000002#-2147483646# 1024 FFT +BASS_DATA_FFT2048 = 0x80000003#-2147483645# 2048 FFT +BASS_DATA_FFT4096 = 0x80000004#-2147483644# 4096 FFT +BASS_DATA_FFT8192 = 0x80000005#-2147483643# 8192 FFT +BASS_DATA_FFT16384 = 0x80000006# 16384 FFT +BASS_DATA_FFT_INDIVIDUAL = 0x10# FFT flag: FFT for each channel, else all combined +BASS_DATA_FFT_NOWINDOW = 0x20# FFT flag: no Hanning window +BASS_DATA_FFT_REMOVEDC = 0x40# FFT flag: pre-remove DC bias +BASS_DATA_FFT_COMPLEX = 0x80# FFT flag: return complex data + +# BASS_ChannelGetTags types : what's returned +BASS_TAG_ID3 = 0# ID3v1 tags : TAG_ID3 structure +BASS_TAG_ID3V2 = 1# ID3v2 tags : variable length block +BASS_TAG_OGG = 2# OGG comments : series of null-terminated UTF-8 strings +BASS_TAG_HTTP = 3# HTTP headers : series of null-terminated ANSI strings +BASS_TAG_ICY = 4# ICY headers : series of null-terminated ANSI strings +BASS_TAG_META = 5# ICY metadata : ANSI string +BASS_TAG_APE = 6# APE tags : series of null-terminated UTF-8 strings +BASS_TAG_MP4 = 7# MP4/iTunes metadata : series of null-terminated UTF-8 strings +BASS_TAG_VENDOR = 9# OGG encoder : UTF-8 string +BASS_TAG_LYRICS3 = 10# Lyric3v2 tag : ASCII string +BASS_TAG_CA_CODEC = 11# CoreAudio codec info : TAG_CA_CODEC structure +BASS_TAG_MF = 13# Media Foundation tags : series of null-terminated UTF-8 strings +BASS_TAG_WAVEFORMAT = 14# WAVE format : WAVEFORMATEEX structure +BASS_TAG_RIFF_INFO = 0x100# RIFF "INFO" tags : series of null-terminated ANSI strings +BASS_TAG_RIFF_BEXT = 0x101# RIFF/BWF "bext" tags : TAG_BEXT structure +BASS_TAG_RIFF_CART = 0x102# RIFF/BWF "cart" tags : TAG_CART structure +BASS_TAG_RIFF_DISP = 0x103# RIFF "DISP" text tag : ANSI string +BASS_TAG_APE_BINARY = 0x1000# + index #, binary APE tag : TAG_APE_BINARY structure +BASS_TAG_MUSIC_NAME = 0x10000# MOD music name : ANSI string +BASS_TAG_MUSIC_MESSAGE = 0x10001# MOD message : ANSI string +BASS_TAG_MUSIC_ORDERS = 0x10002# MOD order list : BYTE array of pattern numbers +BASS_TAG_MUSIC_INST = 0x10100# + instrument #, MOD instrument name : ANSI string +BASS_TAG_MUSIC_SAMPLE = 0x10300# + sample #, MOD sample name : ANSI string + +# ID3v1 tag structure +class TAG_ID3(ctypes.Structure): + _fields_ = [('id', ctypes.c_char*3),#char id[3]; + ('title', ctypes.c_char*30),#char title[30]; + ('artist', ctypes.c_char*30),#char artist[30]; + ('album', ctypes.c_char*30),#char album[30]; + ('year', ctypes.c_char*4),#char year[4]; + ('comment', ctypes.c_char*30),#char comment[30]; + ('genre', ctypes.c_byte)#BYTE genre; + ] + +# Binary APE tag structure +class TAG_APE_BINARY(ctypes.Structure): + _fields_ = [('key', ctypes.c_char_p), + ('data', ctypes.c_void_p), + ('length', ctypes.c_ulong)] + +# BWF "bext" tag structure +class TAG_BEXT(ctypes.Structure): + if platform.system().lower() != 'windows': + _pack_ = 1 + _fields_ = [('Description', ctypes.c_char*256),#char Description[256];// description + ('Originator', ctypes.c_char*32),#char Originator[32];// name of the originator + ('OriginatorReference', ctypes.c_char*32),#char OriginatorReference[32];// reference of the originator + ('OriginationDate', ctypes.c_char*10),#char OriginationDate[10];// date of creation (yyyy-mm-dd) + ('OriginationTime', ctypes.c_char*8),#char OriginationTime[8];// time of creation (hh-mm-ss) + ('TimeReference', QWORD),#QWORD TimeReference;// first sample count since midnight (little-endian) + ('Version', ctypes.c_ushort),#WORD Version;// BWF version (little-endian) + ('UMID', ctypes.c_byte*64),#BYTE UMID[64];// SMPTE UMID + ('Reserved', ctypes.c_byte*190),#BYTE Reserved[190]; + ('CodingHistory', ctypes.c_char_p)#char CodingHistory[];// history + ] + +# BWF "cart" tag structures +class TAG_CART_TIMER(ctypes.Structure): + _fields_ = [('dwUsage', ctypes.c_ulong),#DWORD dwUsage;// FOURCC timer usage ID + ('dwValue', ctypes.c_ulong)#DWORD dwValue;// timer value in samples from head + ] + +class TAG_CART(ctypes.Structure): + _fields_ = [('Version', ctypes.c_char*4),#char Version[4];// version of the data structure + ('Title', ctypes.c_char*64),#char Title[64];// title of cart audio sequence + ('Artist', ctypes.c_char*64),#char Artist[64];// artist or creator name + ('CutID', ctypes.c_char*64),#char CutID[64];// cut number identification + ('ClientID', ctypes.c_char*64),#char ClientID[64];// client identification + ('Category', ctypes.c_char*64),#char Category[64];// category ID, PSA, NEWS, etc + ('Classification', ctypes.c_char*64),#char Classification[64];// classification or auxiliary key + ('OutCue', ctypes.c_char*64),#char OutCue[64];// out cue text + ('StartDate', ctypes.c_char*10),#char StartDate[10];// yyyy-mm-dd + ('StartTime', ctypes.c_char*8),#char StartTime[8];// hh:mm:ss + ('EndDate', ctypes.c_char*10),#char EndDate[10];// yyyy-mm-dd + ('EndTime', ctypes.c_char*8),#char EndTime[8];// hh:mm:ss + ('ProducerAppID', ctypes.c_char*64),#char ProducerAppID[64];// name of vendor or application + ('ProducerAppVersion', ctypes.c_char*64),#char ProducerAppVersion[64];// version of producer application + ('UserDef', ctypes.c_char*64),#char UserDef[64];// user defined text + ('dwLevelReference', ctypes.c_ulong),#DWORD dwLevelReference;// sample value for 0 dB reference + ('PostTimer', TAG_CART_TIMER*8),#TAG_CART_TIMER PostTimer[8];// 8 time markers after head + ('Reserved', ctypes.c_char*276),#char Reserved[276]; + ('URL', ctypes.c_char*1024),#char URL[1024];// uniform resource locator + ('TagText', ctypes.c_char_p)#char TagText[];// free form text for scripts or tags + ] + +# CoreAudio codec info structure +class TAG_CA_CODEC(ctypes.Structure): + _fields_ = [('ftype', ctypes.c_ulong),#DWORD ftype;// file format + ('atype', ctypes.c_ulong),#DWORD atype;// audio format + ('name', ctypes.c_char_p)#const char *name;// description + ] + +class WAVEFORMATEX(ctypes.Structure): + _pack_ = 1 + _fields_ = [('wFormatTag', ctypes.c_long), + ('nChannels', ctypes.c_long), + ('nSamplesPerSec', ctypes.c_ulong), + ('nAvgBytesPerSec', ctypes.c_ulong), + ('nBlockAlign', ctypes.c_long), + ('wBitsPerSample', ctypes.c_long), + ('cbSize', ctypes.c_long)] +PWAVEFORMATEX = LPWAVEFORMATEX = ctypes.POINTER(WAVEFORMATEX) + +# BASS_ChannelGetLength/GetPosition/SetPosition modes +BASS_POS_BYTE = 0# byte position +BASS_POS_MUSIC_ORDER = 1# order.row position, MAKELONG(order,row) +BASS_POS_OGG = 3# OGG bitstream number +BASS_POS_DECODE = 0x10000000# flag: get the decoding (not playing) position +BASS_POS_DECODETO = 0x20000000# flag: decode to the position instead of seeking + +# BASS_RecordSetInput flags +BASS_INPUT_OFF = 0x10000 +BASS_INPUT_ON = 0x20000 +BASS_INPUT_TYPE_MASK = 0xff000000#-16777216 +BASS_INPUT_TYPE_UNDEF = 0x00000000 +BASS_INPUT_TYPE_DIGITAL = 0x01000000 +BASS_INPUT_TYPE_LINE = 0x02000000 +BASS_INPUT_TYPE_MIC = 0x03000000 +BASS_INPUT_TYPE_SYNTH = 0x04000000 +BASS_INPUT_TYPE_CD = 0x05000000 +BASS_INPUT_TYPE_PHONE = 0x06000000 +BASS_INPUT_TYPE_SPEAKER = 0x07000000 +BASS_INPUT_TYPE_WAVE = 0x08000000 +BASS_INPUT_TYPE_AUX = 0x09000000 +BASS_INPUT_TYPE_ANALOG = 0x0a000000 + +# DX8 effect types, use with BASS_ChannelSetFX +BASS_FX_DX8_CHORUS = 0 +BASS_FX_DX8_COMPRESSOR = 1 +BASS_FX_DX8_DISTORTION = 2 +BASS_FX_DX8_ECHO = 3 +BASS_FX_DX8_FLANGER = 4 +BASS_FX_DX8_GARGLE = 5 +BASS_FX_DX8_I3DL2REVERB = 6 +BASS_FX_DX8_PARAMEQ = 7 +BASS_FX_DX8_REVERB = 8 + +class BASS_DX8_CHORUS(ctypes.Structure): + _fields_ = [('fWetDryMix', ctypes.c_float),#float fWetDryMix; + ('fDepth', ctypes.c_float),#float fDepth; + ('fFeedback', ctypes.c_float),#float fFeedback; + ('fFrequency', ctypes.c_float),#float fFrequency; + ('lWaveform', ctypes.c_ulong),#DWORD lWaveform;// 0=triangle, 1=sine + ('fDelay', ctypes.c_float),#float fDelay; + ('lPhase', ctypes.c_ulong)#DWORD lPhase;// BASS_DX8_PHASE_xxx + ] + +class BASS_DX8_COMPRESSOR(ctypes.Structure): + _fields_ = [('fGain', ctypes.c_float),#float fGain; + ('fAttack', ctypes.c_float),#float fAttack; + ('fRelease', ctypes.c_float),#float fRelease; + ('fThreshold', ctypes.c_float),#float fThreshold; + ('fRatio', ctypes.c_float),#float fRatio; + ('fPredelay', ctypes.c_float)#float fPredelay; + ] + +class BASS_DX8_DISTORTION(ctypes.Structure): + _fields_ = [('fGain', ctypes.c_float),#float fGain; + ('fEdge', ctypes.c_float),#float fEdge; + ('fPostEQCenterFrequency', ctypes.c_float),#float fPostEQCenterFrequency; + ('fPostEQBandwidth', ctypes.c_float),#float fPostEQBandwidth; + ('fPreLowpassCutoff', ctypes.c_float)#float fPreLowpassCutoff; + ] + +class BASS_DX8_ECHO(ctypes.Structure): + _fields_ = [('fWetDryMix', ctypes.c_float),#float fWetDryMix; + ('fFeedback', ctypes.c_float),#float fFeedback; + ('fLeftDelay', ctypes.c_float),#float fLeftDelay; + ('fRightDelay', ctypes.c_float),#float fRightDelay; + ('lPanDelay', ctypes.c_byte)#BOOL lPanDelay; + ] + +class BASS_DX8_FLANGER(ctypes.Structure): + _fields_ = [('fWetDryMix', ctypes.c_float),#float fWetDryMix; + ('fDepth', ctypes.c_float),#float fDepth; + ('fFeedback', ctypes.c_float),#float fFeedback; + ('fFrequency', ctypes.c_float),#float fFrequency; + ('lWaveform', ctypes.c_ulong),#DWORD lWaveform;// 0=triangle, 1=sine + ('fDelay', ctypes.c_float),#float fDelay; + ('lPhase', ctypes.c_ulong)#DWORD lPhase;// BASS_DX8_PHASE_xxx + ] + +class BASS_DX8_GARGLE(ctypes.Structure): + _fields_ = [('dwRateHz', ctypes.c_ulong),#DWORD dwRateHz;// Rate of modulation in hz + ('dwWaveShape', ctypes.c_ulong)#DWORD dwWaveShape;// 0=triangle, 1=square + ] + +class BASS_DX8_I3DL2REVERB(ctypes.Structure): + _fields_ = [('lRoom', ctypes.c_int),#int lRoom;// [-10000, 0] default: -1000 mB + ('lRoomHF', ctypes.c_int),#int lRoomHF;// [-10000, 0] default: 0 mB + ('flRoomRolloffFactor', ctypes.c_float),#float flRoomRolloffFactor;// [0.0, 10.0] default: 0.0 + ('flDecayTime', ctypes.c_float),#float flDecayTime;// [0.1, 20.0] default: 1.49s + ('flDecayHFRatio', ctypes.c_float),#float flDecayHFRatio;// [0.1, 2.0] default: 0.83 + ('lReflections', ctypes.c_int),#int lReflections;// [-10000, 1000] default: -2602 mB + ('flReflectionsDelay', ctypes.c_float),#float flReflectionsDelay;// [0.0, 0.3] default: 0.007 s + ('lReverb', ctypes.c_int),#int lReverb;// [-10000, 2000] default: 200 mB + ('flReverbDelay', ctypes.c_float),#float flReverbDelay;// [0.0, 0.1] default: 0.011 s + ('flDiffusion', ctypes.c_float),#float flDiffusion;// [0.0, 100.0] default: 100.0 % + ('flDensity', ctypes.c_float),#float flDensity;// [0.0, 100.0] default: 100.0 % + ('flHFReference', ctypes.c_float)#float flHFReference;// [20.0, 20000.0] default: 5000.0 Hz + ] + +class BASS_DX8_PARAMEQ(ctypes.Structure): + _fields_ = [('fCenter', ctypes.c_float),#float fCenter; + ('fBandwidth', ctypes.c_float),#float fBandwidth; + ('fGain', ctypes.c_float)#float fGain; + ] + +class BASS_DX8_REVERB(ctypes.Structure): + _fields_ = [('fInGain', ctypes.c_float),#float fInGain;// [-96.0,0.0] default: 0.0 dB + ('fReverbMix', ctypes.c_float),#float fReverbMix;// [-96.0,0.0] default: 0.0 db + ('fReverbTime', ctypes.c_float),#float fReverbTime;// [0.001,3000.0] default: 1000.0 ms + ('fHighFreqRTRatio', ctypes.c_float)#float fHighFreqRTRatio;// [0.001,0.999] default: 0.001 + ] + +BASS_DX8_PHASE_NEG_180 = 0 +BASS_DX8_PHASE_NEG_90 = 1 +BASS_DX8_PHASE_ZERO = 2 +BASS_DX8_PHASE_90 = 3 +BASS_DX8_PHASE_180 = 4 + +BASS_IOSNOTIFY_INTERRUPT = 1# interruption started +BASS_IOSNOTIFY_INTERRUPT_END = 2# interruption ended \ No newline at end of file