audio_server.cpp 58 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885
  1. /*************************************************************************/
  2. /* audio_server.cpp */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /*************************************************************************/
  30. #include "audio_server.h"
  31. #include "core/config/project_settings.h"
  32. #include "core/debugger/engine_debugger.h"
  33. #include "core/error/error_macros.h"
  34. #include "core/io/file_access.h"
  35. #include "core/io/resource_loader.h"
  36. #include "core/math/audio_frame.h"
  37. #include "core/os/os.h"
  38. #include "core/string/string_name.h"
  39. #include "core/templates/pair.h"
  40. #include "scene/resources/audio_stream_wav.h"
  41. #include "servers/audio/audio_driver_dummy.h"
  42. #include "servers/audio/effects/audio_effect_compressor.h"
  43. #include <cstring>
  44. #ifdef TOOLS_ENABLED
  45. #define MARK_EDITED set_edited(true);
  46. #else
  47. #define MARK_EDITED
  48. #endif
  49. AudioDriver *AudioDriver::singleton = nullptr;
  50. AudioDriver *AudioDriver::get_singleton() {
  51. return singleton;
  52. }
  53. void AudioDriver::set_singleton() {
  54. singleton = this;
  55. }
  56. void AudioDriver::audio_server_process(int p_frames, int32_t *p_buffer, bool p_update_mix_time) {
  57. if (p_update_mix_time) {
  58. update_mix_time(p_frames);
  59. }
  60. if (AudioServer::get_singleton()) {
  61. AudioServer::get_singleton()->_driver_process(p_frames, p_buffer);
  62. }
  63. }
  64. void AudioDriver::update_mix_time(int p_frames) {
  65. _last_mix_frames = p_frames;
  66. if (OS::get_singleton()) {
  67. _last_mix_time = OS::get_singleton()->get_ticks_usec();
  68. }
  69. }
  70. double AudioDriver::get_time_since_last_mix() {
  71. lock();
  72. uint64_t last_mix_time = _last_mix_time;
  73. unlock();
  74. return (OS::get_singleton()->get_ticks_usec() - last_mix_time) / 1000000.0;
  75. }
  76. double AudioDriver::get_time_to_next_mix() {
  77. lock();
  78. uint64_t last_mix_time = _last_mix_time;
  79. uint64_t last_mix_frames = _last_mix_frames;
  80. unlock();
  81. double total = (OS::get_singleton()->get_ticks_usec() - last_mix_time) / 1000000.0;
  82. double mix_buffer = last_mix_frames / (double)get_mix_rate();
  83. return mix_buffer - total;
  84. }
  85. void AudioDriver::input_buffer_init(int driver_buffer_frames) {
  86. const int input_buffer_channels = 2;
  87. input_buffer.resize(driver_buffer_frames * input_buffer_channels * 4);
  88. input_position = 0;
  89. input_size = 0;
  90. }
  91. void AudioDriver::input_buffer_write(int32_t sample) {
  92. if ((int)input_position < input_buffer.size()) {
  93. input_buffer.write[input_position++] = sample;
  94. if ((int)input_position >= input_buffer.size()) {
  95. input_position = 0;
  96. }
  97. if ((int)input_size < input_buffer.size()) {
  98. input_size++;
  99. }
  100. } else {
  101. WARN_PRINT("input_buffer_write: Invalid input_position=" + itos(input_position) + " input_buffer.size()=" + itos(input_buffer.size()));
  102. }
  103. }
  104. AudioDriver::SpeakerMode AudioDriver::get_speaker_mode_by_total_channels(int p_channels) const {
  105. switch (p_channels) {
  106. case 4:
  107. return SPEAKER_SURROUND_31;
  108. case 6:
  109. return SPEAKER_SURROUND_51;
  110. case 8:
  111. return SPEAKER_SURROUND_71;
  112. }
  113. // Default to STEREO
  114. return SPEAKER_MODE_STEREO;
  115. }
  116. int AudioDriver::get_total_channels_by_speaker_mode(AudioDriver::SpeakerMode p_mode) const {
  117. switch (p_mode) {
  118. case SPEAKER_MODE_STEREO:
  119. return 2;
  120. case SPEAKER_SURROUND_31:
  121. return 4;
  122. case SPEAKER_SURROUND_51:
  123. return 6;
  124. case SPEAKER_SURROUND_71:
  125. return 8;
  126. }
  127. ERR_FAIL_V(2);
  128. }
  129. PackedStringArray AudioDriver::get_device_list() {
  130. PackedStringArray list;
  131. list.push_back("Default");
  132. return list;
  133. }
  134. String AudioDriver::get_device() {
  135. return "Default";
  136. }
  137. PackedStringArray AudioDriver::capture_get_device_list() {
  138. PackedStringArray list;
  139. list.push_back("Default");
  140. return list;
  141. }
  142. AudioDriverDummy AudioDriverManager::dummy_driver;
  143. AudioDriver *AudioDriverManager::drivers[MAX_DRIVERS] = {
  144. &AudioDriverManager::dummy_driver,
  145. };
  146. int AudioDriverManager::driver_count = 1;
  147. void AudioDriverManager::add_driver(AudioDriver *p_driver) {
  148. ERR_FAIL_COND(driver_count >= MAX_DRIVERS);
  149. drivers[driver_count - 1] = p_driver;
  150. // Last driver is always our dummy driver
  151. drivers[driver_count++] = &AudioDriverManager::dummy_driver;
  152. }
  153. int AudioDriverManager::get_driver_count() {
  154. return driver_count;
  155. }
  156. void AudioDriverManager::initialize(int p_driver) {
  157. GLOBAL_DEF_RST("audio/driver/enable_input", false);
  158. GLOBAL_DEF_RST("audio/driver/mix_rate", DEFAULT_MIX_RATE);
  159. GLOBAL_DEF_RST("audio/driver/mix_rate.web", 0); // Safer default output_latency for web (use browser default).
  160. GLOBAL_DEF_RST("audio/driver/output_latency", DEFAULT_OUTPUT_LATENCY);
  161. GLOBAL_DEF_RST("audio/driver/output_latency.web", 50); // Safer default output_latency for web.
  162. int failed_driver = -1;
  163. // Check if there is a selected driver
  164. if (p_driver >= 0 && p_driver < driver_count) {
  165. if (drivers[p_driver]->init() == OK) {
  166. drivers[p_driver]->set_singleton();
  167. return;
  168. } else {
  169. failed_driver = p_driver;
  170. }
  171. }
  172. // No selected driver, try them all in order
  173. for (int i = 0; i < driver_count; i++) {
  174. // Don't re-init the driver if it failed above
  175. if (i == failed_driver) {
  176. continue;
  177. }
  178. if (drivers[i]->init() == OK) {
  179. drivers[i]->set_singleton();
  180. break;
  181. }
  182. }
  183. if (driver_count > 1 && String(AudioDriver::get_singleton()->get_name()) == "Dummy") {
  184. WARN_PRINT("All audio drivers failed, falling back to the dummy driver.");
  185. }
  186. }
  187. AudioDriver *AudioDriverManager::get_driver(int p_driver) {
  188. ERR_FAIL_INDEX_V(p_driver, driver_count, nullptr);
  189. return drivers[p_driver];
  190. }
  191. //////////////////////////////////////////////
  192. //////////////////////////////////////////////
  193. //////////////////////////////////////////////
  194. //////////////////////////////////////////////
  195. void AudioServer::_driver_process(int p_frames, int32_t *p_buffer) {
  196. mix_count++;
  197. int todo = p_frames;
  198. #ifdef DEBUG_ENABLED
  199. uint64_t prof_ticks = OS::get_singleton()->get_ticks_usec();
  200. #endif
  201. if (channel_count != get_channel_count()) {
  202. // Amount of channels changed due to a device change
  203. // reinitialize the buses channels and buffers
  204. init_channels_and_buffers();
  205. }
  206. ERR_FAIL_COND_MSG(buses.is_empty() && todo, "AudioServer bus count is less than 1.");
  207. while (todo) {
  208. if (to_mix == 0) {
  209. _mix_step();
  210. }
  211. int to_copy = MIN(to_mix, todo);
  212. Bus *master = buses[0];
  213. int from = buffer_size - to_mix;
  214. int from_buf = p_frames - todo;
  215. //master master, send to output
  216. int cs = master->channels.size();
  217. for (int k = 0; k < cs; k++) {
  218. if (master->channels[k].active) {
  219. const AudioFrame *buf = master->channels[k].buffer.ptr();
  220. for (int j = 0; j < to_copy; j++) {
  221. float l = CLAMP(buf[from + j].l, -1.0, 1.0);
  222. int32_t vl = l * ((1 << 20) - 1);
  223. int32_t vl2 = (vl < 0 ? -1 : 1) * (ABS(vl) << 11);
  224. p_buffer[(from_buf + j) * (cs * 2) + k * 2 + 0] = vl2;
  225. float r = CLAMP(buf[from + j].r, -1.0, 1.0);
  226. int32_t vr = r * ((1 << 20) - 1);
  227. int32_t vr2 = (vr < 0 ? -1 : 1) * (ABS(vr) << 11);
  228. p_buffer[(from_buf + j) * (cs * 2) + k * 2 + 1] = vr2;
  229. }
  230. } else {
  231. for (int j = 0; j < to_copy; j++) {
  232. p_buffer[(from_buf + j) * (cs * 2) + k * 2 + 0] = 0;
  233. p_buffer[(from_buf + j) * (cs * 2) + k * 2 + 1] = 0;
  234. }
  235. }
  236. }
  237. todo -= to_copy;
  238. to_mix -= to_copy;
  239. }
  240. #ifdef DEBUG_ENABLED
  241. prof_time += OS::get_singleton()->get_ticks_usec() - prof_ticks;
  242. #endif
  243. }
  244. void AudioServer::_mix_step() {
  245. bool solo_mode = false;
  246. for (int i = 0; i < buses.size(); i++) {
  247. Bus *bus = buses[i];
  248. bus->index_cache = i; //might be moved around by editor, so..
  249. for (int k = 0; k < bus->channels.size(); k++) {
  250. bus->channels.write[k].used = false;
  251. }
  252. if (bus->solo) {
  253. //solo chain
  254. solo_mode = true;
  255. bus->soloed = true;
  256. do {
  257. if (bus != buses[0]) {
  258. //everything has a send save for master bus
  259. if (!bus_map.has(bus->send)) {
  260. bus = buses[0]; //send to master
  261. } else {
  262. int prev_index_cache = bus->index_cache;
  263. bus = bus_map[bus->send];
  264. if (prev_index_cache >= bus->index_cache) { //invalid, send to master
  265. bus = buses[0];
  266. }
  267. }
  268. bus->soloed = true;
  269. } else {
  270. bus = nullptr;
  271. }
  272. } while (bus);
  273. } else {
  274. bus->soloed = false;
  275. }
  276. }
  277. for (CallbackItem *ci : mix_callback_list) {
  278. ci->callback(ci->userdata);
  279. }
  280. for (AudioStreamPlaybackListNode *playback : playback_list) {
  281. // Paused streams are no-ops. Don't even mix audio from the stream playback.
  282. if (playback->state.load() == AudioStreamPlaybackListNode::PAUSED) {
  283. continue;
  284. }
  285. bool fading_out = playback->state.load() == AudioStreamPlaybackListNode::FADE_OUT_TO_DELETION || playback->state.load() == AudioStreamPlaybackListNode::FADE_OUT_TO_PAUSE;
  286. AudioFrame *buf = mix_buffer.ptrw();
  287. // Copy the lookeahead buffer into the mix buffer.
  288. for (int i = 0; i < LOOKAHEAD_BUFFER_SIZE; i++) {
  289. buf[i] = playback->lookahead[i];
  290. }
  291. // Mix the audio stream
  292. unsigned int mixed_frames = playback->stream_playback->mix(&buf[LOOKAHEAD_BUFFER_SIZE], playback->pitch_scale.get(), buffer_size);
  293. if (tag_used_audio_streams && playback->stream_playback->is_playing()) {
  294. playback->stream_playback->tag_used_streams();
  295. }
  296. if (mixed_frames != buffer_size) {
  297. // We know we have at least the size of our lookahead buffer for fade-out purposes.
  298. float fadeout_base = 0.94;
  299. float fadeout_coefficient = 1;
  300. static_assert(LOOKAHEAD_BUFFER_SIZE == 64, "Update fadeout_base and comment here if you change LOOKAHEAD_BUFFER_SIZE.");
  301. // 0.94 ^ 64 = 0.01906. There might still be a pop but it'll be way better than if we didn't do this.
  302. for (unsigned int idx = mixed_frames; idx < buffer_size; idx++) {
  303. fadeout_coefficient *= fadeout_base;
  304. buf[idx] *= fadeout_coefficient;
  305. }
  306. AudioStreamPlaybackListNode::PlaybackState new_state;
  307. new_state = AudioStreamPlaybackListNode::AWAITING_DELETION;
  308. playback->state.store(new_state);
  309. } else {
  310. // Move the last little bit of what we just mixed into our lookahead buffer.
  311. for (int i = 0; i < LOOKAHEAD_BUFFER_SIZE; i++) {
  312. playback->lookahead[i] = buf[buffer_size + i];
  313. }
  314. }
  315. AudioStreamPlaybackBusDetails *ptr = playback->bus_details.load();
  316. ERR_FAIL_COND(ptr == nullptr);
  317. // By putting null into the bus details pointers, we're taking ownership of their memory for the duration of this mix.
  318. AudioStreamPlaybackBusDetails bus_details = *ptr;
  319. // Mix to any active buses.
  320. for (int idx = 0; idx < MAX_BUSES_PER_PLAYBACK; idx++) {
  321. if (!bus_details.bus_active[idx]) {
  322. continue;
  323. }
  324. int bus_idx = thread_find_bus_index(bus_details.bus[idx]);
  325. int prev_bus_idx = -1;
  326. for (int search_idx = 0; search_idx < MAX_BUSES_PER_PLAYBACK; search_idx++) {
  327. if (!playback->prev_bus_details->bus_active[search_idx]) {
  328. continue;
  329. }
  330. if (playback->prev_bus_details->bus[search_idx].hash() == bus_details.bus[idx].hash()) {
  331. prev_bus_idx = search_idx;
  332. }
  333. }
  334. for (int channel_idx = 0; channel_idx < channel_count; channel_idx++) {
  335. AudioFrame *channel_buf = thread_get_channel_mix_buffer(bus_idx, channel_idx);
  336. if (fading_out) {
  337. bus_details.volume[idx][channel_idx] = AudioFrame(0, 0);
  338. }
  339. AudioFrame channel_vol = bus_details.volume[idx][channel_idx];
  340. AudioFrame prev_channel_vol = AudioFrame(0, 0);
  341. if (prev_bus_idx != -1) {
  342. prev_channel_vol = playback->prev_bus_details->volume[prev_bus_idx][channel_idx];
  343. }
  344. _mix_step_for_channel(channel_buf, buf, prev_channel_vol, channel_vol, playback->attenuation_filter_cutoff_hz.get(), playback->highshelf_gain.get(), &playback->filter_process[channel_idx * 2], &playback->filter_process[channel_idx * 2 + 1]);
  345. }
  346. }
  347. // Now go through and fade-out any buses that were being played to previously that we missed by going through current data.
  348. for (int idx = 0; idx < MAX_BUSES_PER_PLAYBACK; idx++) {
  349. if (!playback->prev_bus_details->bus_active[idx]) {
  350. continue;
  351. }
  352. int bus_idx = thread_find_bus_index(playback->prev_bus_details->bus[idx]);
  353. int current_bus_idx = -1;
  354. for (int search_idx = 0; search_idx < MAX_BUSES_PER_PLAYBACK; search_idx++) {
  355. if (bus_details.bus[search_idx] == playback->prev_bus_details->bus[idx]) {
  356. current_bus_idx = search_idx;
  357. }
  358. }
  359. if (current_bus_idx != -1) {
  360. // If we found a corresponding bus in the current bus assignments, we've already mixed to this bus.
  361. continue;
  362. }
  363. for (int channel_idx = 0; channel_idx < channel_count; channel_idx++) {
  364. AudioFrame *channel_buf = thread_get_channel_mix_buffer(bus_idx, channel_idx);
  365. AudioFrame prev_channel_vol = playback->prev_bus_details->volume[idx][channel_idx];
  366. // Fade out to silence
  367. _mix_step_for_channel(channel_buf, buf, prev_channel_vol, AudioFrame(0, 0), playback->attenuation_filter_cutoff_hz.get(), playback->highshelf_gain.get(), &playback->filter_process[channel_idx * 2], &playback->filter_process[channel_idx * 2 + 1]);
  368. }
  369. }
  370. // Copy the bus details we mixed with to the previous bus details to maintain volume ramps.
  371. std::copy(std::begin(bus_details.bus_active), std::end(bus_details.bus_active), std::begin(playback->prev_bus_details->bus_active));
  372. std::copy(std::begin(bus_details.bus), std::end(bus_details.bus), std::begin(playback->prev_bus_details->bus));
  373. for (int bus_idx = 0; bus_idx < MAX_BUSES_PER_PLAYBACK; bus_idx++) {
  374. std::copy(std::begin(bus_details.volume[bus_idx]), std::end(bus_details.volume[bus_idx]), std::begin(playback->prev_bus_details->volume[bus_idx]));
  375. }
  376. switch (playback->state.load()) {
  377. case AudioStreamPlaybackListNode::AWAITING_DELETION:
  378. case AudioStreamPlaybackListNode::FADE_OUT_TO_DELETION:
  379. playback_list.erase(playback, [](AudioStreamPlaybackListNode *p) {
  380. if (p->prev_bus_details) {
  381. delete p->prev_bus_details;
  382. }
  383. if (p->bus_details) {
  384. delete p->bus_details;
  385. }
  386. p->stream_playback.unref();
  387. delete p;
  388. });
  389. break;
  390. case AudioStreamPlaybackListNode::FADE_OUT_TO_PAUSE: {
  391. // Pause the stream.
  392. AudioStreamPlaybackListNode::PlaybackState old_state, new_state;
  393. do {
  394. old_state = playback->state.load();
  395. new_state = AudioStreamPlaybackListNode::PAUSED;
  396. } while (!playback->state.compare_exchange_strong(/* expected= */ old_state, new_state));
  397. } break;
  398. case AudioStreamPlaybackListNode::PLAYING:
  399. case AudioStreamPlaybackListNode::PAUSED:
  400. // No-op!
  401. break;
  402. }
  403. }
  404. for (int i = buses.size() - 1; i >= 0; i--) {
  405. //go bus by bus
  406. Bus *bus = buses[i];
  407. for (int k = 0; k < bus->channels.size(); k++) {
  408. if (bus->channels[k].active && !bus->channels[k].used) {
  409. //buffer was not used, but it's still active, so it must be cleaned
  410. AudioFrame *buf = bus->channels.write[k].buffer.ptrw();
  411. for (uint32_t j = 0; j < buffer_size; j++) {
  412. buf[j] = AudioFrame(0, 0);
  413. }
  414. }
  415. }
  416. //process effects
  417. if (!bus->bypass) {
  418. for (int j = 0; j < bus->effects.size(); j++) {
  419. if (!bus->effects[j].enabled) {
  420. continue;
  421. }
  422. #ifdef DEBUG_ENABLED
  423. uint64_t ticks = OS::get_singleton()->get_ticks_usec();
  424. #endif
  425. for (int k = 0; k < bus->channels.size(); k++) {
  426. if (!(bus->channels[k].active || bus->channels[k].effect_instances[j]->process_silence())) {
  427. continue;
  428. }
  429. bus->channels.write[k].effect_instances.write[j]->process(bus->channels[k].buffer.ptr(), temp_buffer.write[k].ptrw(), buffer_size);
  430. }
  431. //swap buffers, so internal buffer always has the right data
  432. for (int k = 0; k < bus->channels.size(); k++) {
  433. if (!(buses[i]->channels[k].active || bus->channels[k].effect_instances[j]->process_silence())) {
  434. continue;
  435. }
  436. SWAP(bus->channels.write[k].buffer, temp_buffer.write[k]);
  437. }
  438. #ifdef DEBUG_ENABLED
  439. bus->effects.write[j].prof_time += OS::get_singleton()->get_ticks_usec() - ticks;
  440. #endif
  441. }
  442. }
  443. //process send
  444. Bus *send = nullptr;
  445. if (i > 0) {
  446. //everything has a send save for master bus
  447. if (!bus_map.has(bus->send)) {
  448. send = buses[0];
  449. } else {
  450. send = bus_map[bus->send];
  451. if (send->index_cache >= bus->index_cache) { //invalid, send to master
  452. send = buses[0];
  453. }
  454. }
  455. }
  456. for (int k = 0; k < bus->channels.size(); k++) {
  457. if (!bus->channels[k].active) {
  458. bus->channels.write[k].peak_volume = AudioFrame(AUDIO_MIN_PEAK_DB, AUDIO_MIN_PEAK_DB);
  459. continue;
  460. }
  461. AudioFrame *buf = bus->channels.write[k].buffer.ptrw();
  462. AudioFrame peak = AudioFrame(0, 0);
  463. float volume = Math::db_to_linear(bus->volume_db);
  464. if (solo_mode) {
  465. if (!bus->soloed) {
  466. volume = 0.0;
  467. }
  468. } else {
  469. if (bus->mute) {
  470. volume = 0.0;
  471. }
  472. }
  473. //apply volume and compute peak
  474. for (uint32_t j = 0; j < buffer_size; j++) {
  475. buf[j] *= volume;
  476. float l = ABS(buf[j].l);
  477. if (l > peak.l) {
  478. peak.l = l;
  479. }
  480. float r = ABS(buf[j].r);
  481. if (r > peak.r) {
  482. peak.r = r;
  483. }
  484. }
  485. bus->channels.write[k].peak_volume = AudioFrame(Math::linear_to_db(peak.l + AUDIO_PEAK_OFFSET), Math::linear_to_db(peak.r + AUDIO_PEAK_OFFSET));
  486. if (!bus->channels[k].used) {
  487. //see if any audio is contained, because channel was not used
  488. if (MAX(peak.r, peak.l) > Math::db_to_linear(channel_disable_threshold_db)) {
  489. bus->channels.write[k].last_mix_with_audio = mix_frames;
  490. } else if (mix_frames - bus->channels[k].last_mix_with_audio > channel_disable_frames) {
  491. bus->channels.write[k].active = false;
  492. continue; //went inactive, don't mix.
  493. }
  494. }
  495. if (send) {
  496. //if not master bus, send
  497. AudioFrame *target_buf = thread_get_channel_mix_buffer(send->index_cache, k);
  498. for (uint32_t j = 0; j < buffer_size; j++) {
  499. target_buf[j] += buf[j];
  500. }
  501. }
  502. }
  503. }
  504. mix_frames += buffer_size;
  505. to_mix = buffer_size;
  506. }
  507. void AudioServer::_mix_step_for_channel(AudioFrame *p_out_buf, AudioFrame *p_source_buf, AudioFrame p_vol_start, AudioFrame p_vol_final, float p_attenuation_filter_cutoff_hz, float p_highshelf_gain, AudioFilterSW::Processor *p_processor_l, AudioFilterSW::Processor *p_processor_r) {
  508. if (p_highshelf_gain != 0) {
  509. AudioFilterSW filter;
  510. filter.set_mode(AudioFilterSW::HIGHSHELF);
  511. filter.set_sampling_rate(AudioServer::get_singleton()->get_mix_rate());
  512. filter.set_cutoff(p_attenuation_filter_cutoff_hz);
  513. filter.set_resonance(1);
  514. filter.set_stages(1);
  515. filter.set_gain(p_highshelf_gain);
  516. ERR_FAIL_COND(p_processor_l == nullptr);
  517. ERR_FAIL_COND(p_processor_r == nullptr);
  518. bool is_just_started = p_vol_start.l == 0 && p_vol_start.r == 0;
  519. p_processor_l->set_filter(&filter, /* clear_history= */ is_just_started);
  520. p_processor_l->update_coeffs(buffer_size);
  521. p_processor_r->set_filter(&filter, /* clear_history= */ is_just_started);
  522. p_processor_r->update_coeffs(buffer_size);
  523. for (unsigned int frame_idx = 0; frame_idx < buffer_size; frame_idx++) {
  524. // Make this buffer size invariant if buffer_size ever becomes a project setting.
  525. float lerp_param = (float)frame_idx / buffer_size;
  526. AudioFrame vol = p_vol_final * lerp_param + (1 - lerp_param) * p_vol_start;
  527. AudioFrame mixed = vol * p_source_buf[frame_idx];
  528. p_processor_l->process_one_interp(mixed.l);
  529. p_processor_r->process_one_interp(mixed.r);
  530. p_out_buf[frame_idx] += mixed;
  531. }
  532. } else {
  533. for (unsigned int frame_idx = 0; frame_idx < buffer_size; frame_idx++) {
  534. // Make this buffer size invariant if buffer_size ever becomes a project setting.
  535. float lerp_param = (float)frame_idx / buffer_size;
  536. p_out_buf[frame_idx] += (p_vol_final * lerp_param + (1 - lerp_param) * p_vol_start) * p_source_buf[frame_idx];
  537. }
  538. }
  539. }
  540. AudioServer::AudioStreamPlaybackListNode *AudioServer::_find_playback_list_node(Ref<AudioStreamPlayback> p_playback) {
  541. for (AudioStreamPlaybackListNode *playback_list_node : playback_list) {
  542. if (playback_list_node->stream_playback == p_playback) {
  543. return playback_list_node;
  544. }
  545. }
  546. return nullptr;
  547. }
  548. bool AudioServer::thread_has_channel_mix_buffer(int p_bus, int p_buffer) const {
  549. if (p_bus < 0 || p_bus >= buses.size()) {
  550. return false;
  551. }
  552. if (p_buffer < 0 || p_buffer >= buses[p_bus]->channels.size()) {
  553. return false;
  554. }
  555. return true;
  556. }
  557. AudioFrame *AudioServer::thread_get_channel_mix_buffer(int p_bus, int p_buffer) {
  558. ERR_FAIL_INDEX_V(p_bus, buses.size(), nullptr);
  559. ERR_FAIL_INDEX_V(p_buffer, buses[p_bus]->channels.size(), nullptr);
  560. AudioFrame *data = buses.write[p_bus]->channels.write[p_buffer].buffer.ptrw();
  561. if (!buses[p_bus]->channels[p_buffer].used) {
  562. buses.write[p_bus]->channels.write[p_buffer].used = true;
  563. buses.write[p_bus]->channels.write[p_buffer].active = true;
  564. buses.write[p_bus]->channels.write[p_buffer].last_mix_with_audio = mix_frames;
  565. for (uint32_t i = 0; i < buffer_size; i++) {
  566. data[i] = AudioFrame(0, 0);
  567. }
  568. }
  569. return data;
  570. }
  571. int AudioServer::thread_get_mix_buffer_size() const {
  572. return buffer_size;
  573. }
  574. int AudioServer::thread_find_bus_index(const StringName &p_name) {
  575. if (bus_map.has(p_name)) {
  576. return bus_map[p_name]->index_cache;
  577. } else {
  578. return 0;
  579. }
  580. }
  581. void AudioServer::set_bus_count(int p_count) {
  582. ERR_FAIL_COND(p_count < 1);
  583. ERR_FAIL_INDEX(p_count, 256);
  584. MARK_EDITED
  585. lock();
  586. int cb = buses.size();
  587. if (p_count < buses.size()) {
  588. for (int i = p_count; i < buses.size(); i++) {
  589. bus_map.erase(buses[i]->name);
  590. memdelete(buses[i]);
  591. }
  592. }
  593. buses.resize(p_count);
  594. for (int i = cb; i < buses.size(); i++) {
  595. String attempt = "New Bus";
  596. int attempts = 1;
  597. while (true) {
  598. bool name_free = true;
  599. for (int j = 0; j < i; j++) {
  600. if (buses[j]->name == attempt) {
  601. name_free = false;
  602. break;
  603. }
  604. }
  605. if (!name_free) {
  606. attempts++;
  607. attempt = "New Bus " + itos(attempts);
  608. } else {
  609. break;
  610. }
  611. }
  612. buses.write[i] = memnew(Bus);
  613. buses.write[i]->channels.resize(channel_count);
  614. for (int j = 0; j < channel_count; j++) {
  615. buses.write[i]->channels.write[j].buffer.resize(buffer_size);
  616. }
  617. buses[i]->name = attempt;
  618. buses[i]->solo = false;
  619. buses[i]->mute = false;
  620. buses[i]->bypass = false;
  621. buses[i]->volume_db = 0;
  622. if (i > 0) {
  623. buses[i]->send = "Master";
  624. }
  625. bus_map[attempt] = buses[i];
  626. }
  627. unlock();
  628. emit_signal(SNAME("bus_layout_changed"));
  629. }
  630. void AudioServer::remove_bus(int p_index) {
  631. ERR_FAIL_INDEX(p_index, buses.size());
  632. ERR_FAIL_COND(p_index == 0);
  633. MARK_EDITED
  634. lock();
  635. bus_map.erase(buses[p_index]->name);
  636. memdelete(buses[p_index]);
  637. buses.remove_at(p_index);
  638. unlock();
  639. emit_signal(SNAME("bus_layout_changed"));
  640. }
  641. void AudioServer::add_bus(int p_at_pos) {
  642. MARK_EDITED
  643. if (p_at_pos >= buses.size()) {
  644. p_at_pos = -1;
  645. } else if (p_at_pos == 0) {
  646. if (buses.size() > 1) {
  647. p_at_pos = 1;
  648. } else {
  649. p_at_pos = -1;
  650. }
  651. }
  652. String attempt = "New Bus";
  653. int attempts = 1;
  654. while (true) {
  655. bool name_free = true;
  656. for (int j = 0; j < buses.size(); j++) {
  657. if (buses[j]->name == attempt) {
  658. name_free = false;
  659. break;
  660. }
  661. }
  662. if (!name_free) {
  663. attempts++;
  664. attempt = "New Bus " + itos(attempts);
  665. } else {
  666. break;
  667. }
  668. }
  669. Bus *bus = memnew(Bus);
  670. bus->channels.resize(channel_count);
  671. for (int j = 0; j < channel_count; j++) {
  672. bus->channels.write[j].buffer.resize(buffer_size);
  673. }
  674. bus->name = attempt;
  675. bus->solo = false;
  676. bus->mute = false;
  677. bus->bypass = false;
  678. bus->volume_db = 0;
  679. bus_map[attempt] = bus;
  680. if (p_at_pos == -1) {
  681. buses.push_back(bus);
  682. } else {
  683. buses.insert(p_at_pos, bus);
  684. }
  685. emit_signal(SNAME("bus_layout_changed"));
  686. }
  687. void AudioServer::move_bus(int p_bus, int p_to_pos) {
  688. ERR_FAIL_COND(p_bus < 1 || p_bus >= buses.size());
  689. ERR_FAIL_COND(p_to_pos != -1 && (p_to_pos < 1 || p_to_pos > buses.size()));
  690. MARK_EDITED
  691. if (p_bus == p_to_pos) {
  692. return;
  693. }
  694. Bus *bus = buses[p_bus];
  695. buses.remove_at(p_bus);
  696. if (p_to_pos == -1) {
  697. buses.push_back(bus);
  698. } else if (p_to_pos < p_bus) {
  699. buses.insert(p_to_pos, bus);
  700. } else {
  701. buses.insert(p_to_pos - 1, bus);
  702. }
  703. emit_signal(SNAME("bus_layout_changed"));
  704. }
  705. int AudioServer::get_bus_count() const {
  706. return buses.size();
  707. }
  708. void AudioServer::set_bus_name(int p_bus, const String &p_name) {
  709. ERR_FAIL_INDEX(p_bus, buses.size());
  710. if (p_bus == 0 && p_name != "Master") {
  711. return; //bus 0 is always master
  712. }
  713. MARK_EDITED
  714. lock();
  715. if (buses[p_bus]->name == p_name) {
  716. unlock();
  717. return;
  718. }
  719. String attempt = p_name;
  720. int attempts = 1;
  721. while (true) {
  722. bool name_free = true;
  723. for (int i = 0; i < buses.size(); i++) {
  724. if (buses[i]->name == attempt) {
  725. name_free = false;
  726. break;
  727. }
  728. }
  729. if (name_free) {
  730. break;
  731. }
  732. attempts++;
  733. attempt = p_name + " " + itos(attempts);
  734. }
  735. bus_map.erase(buses[p_bus]->name);
  736. buses[p_bus]->name = attempt;
  737. bus_map[attempt] = buses[p_bus];
  738. unlock();
  739. emit_signal(SNAME("bus_layout_changed"));
  740. }
  741. String AudioServer::get_bus_name(int p_bus) const {
  742. ERR_FAIL_INDEX_V(p_bus, buses.size(), String());
  743. return buses[p_bus]->name;
  744. }
  745. int AudioServer::get_bus_index(const StringName &p_bus_name) const {
  746. for (int i = 0; i < buses.size(); ++i) {
  747. if (buses[i]->name == p_bus_name) {
  748. return i;
  749. }
  750. }
  751. return -1;
  752. }
  753. void AudioServer::set_bus_volume_db(int p_bus, float p_volume_db) {
  754. ERR_FAIL_INDEX(p_bus, buses.size());
  755. MARK_EDITED
  756. buses[p_bus]->volume_db = p_volume_db;
  757. }
  758. float AudioServer::get_bus_volume_db(int p_bus) const {
  759. ERR_FAIL_INDEX_V(p_bus, buses.size(), 0);
  760. return buses[p_bus]->volume_db;
  761. }
  762. int AudioServer::get_bus_channels(int p_bus) const {
  763. ERR_FAIL_INDEX_V(p_bus, buses.size(), 0);
  764. return buses[p_bus]->channels.size();
  765. }
  766. void AudioServer::set_bus_send(int p_bus, const StringName &p_send) {
  767. ERR_FAIL_INDEX(p_bus, buses.size());
  768. MARK_EDITED
  769. buses[p_bus]->send = p_send;
  770. }
  771. StringName AudioServer::get_bus_send(int p_bus) const {
  772. ERR_FAIL_INDEX_V(p_bus, buses.size(), StringName());
  773. return buses[p_bus]->send;
  774. }
  775. void AudioServer::set_bus_solo(int p_bus, bool p_enable) {
  776. ERR_FAIL_INDEX(p_bus, buses.size());
  777. MARK_EDITED
  778. buses[p_bus]->solo = p_enable;
  779. }
  780. bool AudioServer::is_bus_solo(int p_bus) const {
  781. ERR_FAIL_INDEX_V(p_bus, buses.size(), false);
  782. return buses[p_bus]->solo;
  783. }
  784. void AudioServer::set_bus_mute(int p_bus, bool p_enable) {
  785. ERR_FAIL_INDEX(p_bus, buses.size());
  786. MARK_EDITED
  787. buses[p_bus]->mute = p_enable;
  788. }
  789. bool AudioServer::is_bus_mute(int p_bus) const {
  790. ERR_FAIL_INDEX_V(p_bus, buses.size(), false);
  791. return buses[p_bus]->mute;
  792. }
  793. void AudioServer::set_bus_bypass_effects(int p_bus, bool p_enable) {
  794. ERR_FAIL_INDEX(p_bus, buses.size());
  795. MARK_EDITED
  796. buses[p_bus]->bypass = p_enable;
  797. }
  798. bool AudioServer::is_bus_bypassing_effects(int p_bus) const {
  799. ERR_FAIL_INDEX_V(p_bus, buses.size(), false);
  800. return buses[p_bus]->bypass;
  801. }
  802. void AudioServer::_update_bus_effects(int p_bus) {
  803. for (int i = 0; i < buses[p_bus]->channels.size(); i++) {
  804. buses.write[p_bus]->channels.write[i].effect_instances.resize(buses[p_bus]->effects.size());
  805. for (int j = 0; j < buses[p_bus]->effects.size(); j++) {
  806. Ref<AudioEffectInstance> fx = buses.write[p_bus]->effects.write[j].effect->instantiate();
  807. if (Object::cast_to<AudioEffectCompressorInstance>(*fx)) {
  808. Object::cast_to<AudioEffectCompressorInstance>(*fx)->set_current_channel(i);
  809. }
  810. buses.write[p_bus]->channels.write[i].effect_instances.write[j] = fx;
  811. }
  812. }
  813. }
  814. void AudioServer::add_bus_effect(int p_bus, const Ref<AudioEffect> &p_effect, int p_at_pos) {
  815. ERR_FAIL_COND(p_effect.is_null());
  816. ERR_FAIL_INDEX(p_bus, buses.size());
  817. MARK_EDITED
  818. lock();
  819. Bus::Effect fx;
  820. fx.effect = p_effect;
  821. //fx.instance=p_effect->instantiate();
  822. fx.enabled = true;
  823. #ifdef DEBUG_ENABLED
  824. fx.prof_time = 0;
  825. #endif
  826. if (p_at_pos >= buses[p_bus]->effects.size() || p_at_pos < 0) {
  827. buses[p_bus]->effects.push_back(fx);
  828. } else {
  829. buses[p_bus]->effects.insert(p_at_pos, fx);
  830. }
  831. _update_bus_effects(p_bus);
  832. unlock();
  833. }
  834. void AudioServer::remove_bus_effect(int p_bus, int p_effect) {
  835. ERR_FAIL_INDEX(p_bus, buses.size());
  836. MARK_EDITED
  837. lock();
  838. buses[p_bus]->effects.remove_at(p_effect);
  839. _update_bus_effects(p_bus);
  840. unlock();
  841. }
  842. int AudioServer::get_bus_effect_count(int p_bus) {
  843. ERR_FAIL_INDEX_V(p_bus, buses.size(), 0);
  844. return buses[p_bus]->effects.size();
  845. }
  846. Ref<AudioEffectInstance> AudioServer::get_bus_effect_instance(int p_bus, int p_effect, int p_channel) {
  847. ERR_FAIL_INDEX_V(p_bus, buses.size(), Ref<AudioEffectInstance>());
  848. ERR_FAIL_INDEX_V(p_effect, buses[p_bus]->effects.size(), Ref<AudioEffectInstance>());
  849. ERR_FAIL_INDEX_V(p_channel, buses[p_bus]->channels.size(), Ref<AudioEffectInstance>());
  850. return buses[p_bus]->channels[p_channel].effect_instances[p_effect];
  851. }
  852. Ref<AudioEffect> AudioServer::get_bus_effect(int p_bus, int p_effect) {
  853. ERR_FAIL_INDEX_V(p_bus, buses.size(), Ref<AudioEffect>());
  854. ERR_FAIL_INDEX_V(p_effect, buses[p_bus]->effects.size(), Ref<AudioEffect>());
  855. return buses[p_bus]->effects[p_effect].effect;
  856. }
  857. void AudioServer::swap_bus_effects(int p_bus, int p_effect, int p_by_effect) {
  858. ERR_FAIL_INDEX(p_bus, buses.size());
  859. ERR_FAIL_INDEX(p_effect, buses[p_bus]->effects.size());
  860. ERR_FAIL_INDEX(p_by_effect, buses[p_bus]->effects.size());
  861. MARK_EDITED
  862. lock();
  863. SWAP(buses.write[p_bus]->effects.write[p_effect], buses.write[p_bus]->effects.write[p_by_effect]);
  864. _update_bus_effects(p_bus);
  865. unlock();
  866. }
  867. void AudioServer::set_bus_effect_enabled(int p_bus, int p_effect, bool p_enabled) {
  868. ERR_FAIL_INDEX(p_bus, buses.size());
  869. ERR_FAIL_INDEX(p_effect, buses[p_bus]->effects.size());
  870. MARK_EDITED
  871. buses.write[p_bus]->effects.write[p_effect].enabled = p_enabled;
  872. }
  873. bool AudioServer::is_bus_effect_enabled(int p_bus, int p_effect) const {
  874. ERR_FAIL_INDEX_V(p_bus, buses.size(), false);
  875. ERR_FAIL_INDEX_V(p_effect, buses[p_bus]->effects.size(), false);
  876. return buses[p_bus]->effects[p_effect].enabled;
  877. }
  878. float AudioServer::get_bus_peak_volume_left_db(int p_bus, int p_channel) const {
  879. ERR_FAIL_INDEX_V(p_bus, buses.size(), 0);
  880. ERR_FAIL_INDEX_V(p_channel, buses[p_bus]->channels.size(), 0);
  881. return buses[p_bus]->channels[p_channel].peak_volume.l;
  882. }
  883. float AudioServer::get_bus_peak_volume_right_db(int p_bus, int p_channel) const {
  884. ERR_FAIL_INDEX_V(p_bus, buses.size(), 0);
  885. ERR_FAIL_INDEX_V(p_channel, buses[p_bus]->channels.size(), 0);
  886. return buses[p_bus]->channels[p_channel].peak_volume.r;
  887. }
  888. bool AudioServer::is_bus_channel_active(int p_bus, int p_channel) const {
  889. ERR_FAIL_INDEX_V(p_bus, buses.size(), false);
  890. ERR_FAIL_INDEX_V(p_channel, buses[p_bus]->channels.size(), false);
  891. return buses[p_bus]->channels[p_channel].active;
  892. }
  893. void AudioServer::set_playback_speed_scale(float p_scale) {
  894. ERR_FAIL_COND(p_scale <= 0);
  895. playback_speed_scale = p_scale;
  896. }
  897. float AudioServer::get_playback_speed_scale() const {
  898. return playback_speed_scale;
  899. }
  900. void AudioServer::start_playback_stream(Ref<AudioStreamPlayback> p_playback, StringName p_bus, Vector<AudioFrame> p_volume_db_vector, float p_start_time, float p_pitch_scale) {
  901. ERR_FAIL_COND(p_playback.is_null());
  902. HashMap<StringName, Vector<AudioFrame>> map;
  903. map[p_bus] = p_volume_db_vector;
  904. start_playback_stream(p_playback, map, p_start_time, p_pitch_scale);
  905. }
  906. void AudioServer::start_playback_stream(Ref<AudioStreamPlayback> p_playback, HashMap<StringName, Vector<AudioFrame>> p_bus_volumes, float p_start_time, float p_pitch_scale, float p_highshelf_gain, float p_attenuation_cutoff_hz) {
  907. ERR_FAIL_COND(p_playback.is_null());
  908. AudioStreamPlaybackListNode *playback_node = new AudioStreamPlaybackListNode();
  909. playback_node->stream_playback = p_playback;
  910. playback_node->stream_playback->start(p_start_time);
  911. AudioStreamPlaybackBusDetails *new_bus_details = new AudioStreamPlaybackBusDetails();
  912. int idx = 0;
  913. for (KeyValue<StringName, Vector<AudioFrame>> pair : p_bus_volumes) {
  914. if (pair.value.size() < channel_count || pair.value.size() != MAX_CHANNELS_PER_BUS) {
  915. delete new_bus_details;
  916. ERR_FAIL();
  917. }
  918. new_bus_details->bus_active[idx] = true;
  919. new_bus_details->bus[idx] = pair.key;
  920. for (int channel_idx = 0; channel_idx < MAX_CHANNELS_PER_BUS; channel_idx++) {
  921. new_bus_details->volume[idx][channel_idx] = pair.value[channel_idx];
  922. }
  923. }
  924. playback_node->bus_details = new_bus_details;
  925. playback_node->prev_bus_details = new AudioStreamPlaybackBusDetails();
  926. playback_node->pitch_scale.set(p_pitch_scale);
  927. playback_node->highshelf_gain.set(p_highshelf_gain);
  928. playback_node->attenuation_filter_cutoff_hz.set(p_attenuation_cutoff_hz);
  929. memset(playback_node->prev_bus_details->volume, 0, sizeof(playback_node->prev_bus_details->volume));
  930. for (AudioFrame &frame : playback_node->lookahead) {
  931. frame = AudioFrame(0, 0);
  932. }
  933. playback_node->state.store(AudioStreamPlaybackListNode::PLAYING);
  934. playback_list.insert(playback_node);
  935. }
  936. void AudioServer::stop_playback_stream(Ref<AudioStreamPlayback> p_playback) {
  937. ERR_FAIL_COND(p_playback.is_null());
  938. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  939. if (!playback_node) {
  940. return;
  941. }
  942. AudioStreamPlaybackListNode::PlaybackState new_state, old_state;
  943. do {
  944. old_state = playback_node->state.load();
  945. if (old_state == AudioStreamPlaybackListNode::AWAITING_DELETION) {
  946. break; // Don't fade out again.
  947. }
  948. new_state = AudioStreamPlaybackListNode::FADE_OUT_TO_DELETION;
  949. } while (!playback_node->state.compare_exchange_strong(old_state, new_state));
  950. }
  951. void AudioServer::set_playback_bus_exclusive(Ref<AudioStreamPlayback> p_playback, StringName p_bus, Vector<AudioFrame> p_volumes) {
  952. ERR_FAIL_COND(p_volumes.size() != MAX_CHANNELS_PER_BUS);
  953. HashMap<StringName, Vector<AudioFrame>> map;
  954. map[p_bus] = p_volumes;
  955. set_playback_bus_volumes_linear(p_playback, map);
  956. }
  957. void AudioServer::set_playback_bus_volumes_linear(Ref<AudioStreamPlayback> p_playback, HashMap<StringName, Vector<AudioFrame>> p_bus_volumes) {
  958. ERR_FAIL_COND(p_bus_volumes.size() > MAX_BUSES_PER_PLAYBACK);
  959. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  960. if (!playback_node) {
  961. return;
  962. }
  963. AudioStreamPlaybackBusDetails *old_bus_details, *new_bus_details = new AudioStreamPlaybackBusDetails();
  964. int idx = 0;
  965. for (KeyValue<StringName, Vector<AudioFrame>> pair : p_bus_volumes) {
  966. if (idx >= MAX_BUSES_PER_PLAYBACK) {
  967. break;
  968. }
  969. ERR_FAIL_COND(pair.value.size() < channel_count);
  970. ERR_FAIL_COND(pair.value.size() != MAX_CHANNELS_PER_BUS);
  971. new_bus_details->bus_active[idx] = true;
  972. new_bus_details->bus[idx] = pair.key;
  973. for (int channel_idx = 0; channel_idx < MAX_CHANNELS_PER_BUS; channel_idx++) {
  974. new_bus_details->volume[idx][channel_idx] = pair.value[channel_idx];
  975. }
  976. idx++;
  977. }
  978. do {
  979. old_bus_details = playback_node->bus_details.load();
  980. } while (!playback_node->bus_details.compare_exchange_strong(old_bus_details, new_bus_details));
  981. bus_details_graveyard.insert(old_bus_details);
  982. }
  983. void AudioServer::set_playback_all_bus_volumes_linear(Ref<AudioStreamPlayback> p_playback, Vector<AudioFrame> p_volumes) {
  984. ERR_FAIL_COND(p_playback.is_null());
  985. ERR_FAIL_COND(p_volumes.size() != MAX_CHANNELS_PER_BUS);
  986. HashMap<StringName, Vector<AudioFrame>> map;
  987. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  988. if (!playback_node) {
  989. return;
  990. }
  991. for (int bus_idx = 0; bus_idx < MAX_BUSES_PER_PLAYBACK; bus_idx++) {
  992. if (playback_node->bus_details.load()->bus_active[bus_idx]) {
  993. map[playback_node->bus_details.load()->bus[bus_idx]] = p_volumes;
  994. }
  995. }
  996. set_playback_bus_volumes_linear(p_playback, map);
  997. }
  998. void AudioServer::set_playback_pitch_scale(Ref<AudioStreamPlayback> p_playback, float p_pitch_scale) {
  999. ERR_FAIL_COND(p_playback.is_null());
  1000. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  1001. if (!playback_node) {
  1002. return;
  1003. }
  1004. playback_node->pitch_scale.set(p_pitch_scale);
  1005. }
  1006. void AudioServer::set_playback_paused(Ref<AudioStreamPlayback> p_playback, bool p_paused) {
  1007. ERR_FAIL_COND(p_playback.is_null());
  1008. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  1009. if (!playback_node) {
  1010. return;
  1011. }
  1012. AudioStreamPlaybackListNode::PlaybackState new_state, old_state;
  1013. do {
  1014. old_state = playback_node->state.load();
  1015. new_state = p_paused ? AudioStreamPlaybackListNode::FADE_OUT_TO_PAUSE : AudioStreamPlaybackListNode::PLAYING;
  1016. if (!p_paused && old_state == AudioStreamPlaybackListNode::PLAYING) {
  1017. return; // No-op.
  1018. }
  1019. if (p_paused && (old_state == AudioStreamPlaybackListNode::PAUSED || old_state == AudioStreamPlaybackListNode::FADE_OUT_TO_PAUSE)) {
  1020. return; // No-op.
  1021. }
  1022. } while (!playback_node->state.compare_exchange_strong(old_state, new_state));
  1023. }
  1024. void AudioServer::set_playback_highshelf_params(Ref<AudioStreamPlayback> p_playback, float p_gain, float p_attenuation_cutoff_hz) {
  1025. ERR_FAIL_COND(p_playback.is_null());
  1026. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  1027. if (!playback_node) {
  1028. return;
  1029. }
  1030. playback_node->attenuation_filter_cutoff_hz.set(p_attenuation_cutoff_hz);
  1031. playback_node->highshelf_gain.set(p_gain);
  1032. }
  1033. bool AudioServer::is_playback_active(Ref<AudioStreamPlayback> p_playback) {
  1034. ERR_FAIL_COND_V(p_playback.is_null(), false);
  1035. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  1036. if (!playback_node) {
  1037. return false;
  1038. }
  1039. return playback_node->state.load() == AudioStreamPlaybackListNode::PLAYING;
  1040. }
  1041. float AudioServer::get_playback_position(Ref<AudioStreamPlayback> p_playback) {
  1042. ERR_FAIL_COND_V(p_playback.is_null(), 0);
  1043. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  1044. if (!playback_node) {
  1045. return 0;
  1046. }
  1047. return playback_node->stream_playback->get_playback_position();
  1048. }
  1049. bool AudioServer::is_playback_paused(Ref<AudioStreamPlayback> p_playback) {
  1050. ERR_FAIL_COND_V(p_playback.is_null(), false);
  1051. AudioStreamPlaybackListNode *playback_node = _find_playback_list_node(p_playback);
  1052. if (!playback_node) {
  1053. return false;
  1054. }
  1055. return playback_node->state.load() == AudioStreamPlaybackListNode::PAUSED || playback_node->state.load() == AudioStreamPlaybackListNode::FADE_OUT_TO_PAUSE;
  1056. }
  1057. uint64_t AudioServer::get_mix_count() const {
  1058. return mix_count;
  1059. }
  1060. uint64_t AudioServer::get_mixed_frames() const {
  1061. return mix_frames;
  1062. }
  1063. void AudioServer::notify_listener_changed() {
  1064. for (CallbackItem *ci : listener_changed_callback_list) {
  1065. ci->callback(ci->userdata);
  1066. }
  1067. }
  1068. void AudioServer::init_channels_and_buffers() {
  1069. channel_count = get_channel_count();
  1070. temp_buffer.resize(channel_count);
  1071. mix_buffer.resize(buffer_size + LOOKAHEAD_BUFFER_SIZE);
  1072. for (int i = 0; i < temp_buffer.size(); i++) {
  1073. temp_buffer.write[i].resize(buffer_size);
  1074. }
  1075. for (int i = 0; i < buses.size(); i++) {
  1076. buses[i]->channels.resize(channel_count);
  1077. for (int j = 0; j < channel_count; j++) {
  1078. buses.write[i]->channels.write[j].buffer.resize(buffer_size);
  1079. }
  1080. _update_bus_effects(i);
  1081. }
  1082. }
  1083. void AudioServer::init() {
  1084. channel_disable_threshold_db = GLOBAL_DEF_RST("audio/buses/channel_disable_threshold_db", -60.0);
  1085. channel_disable_frames = float(GLOBAL_DEF_RST("audio/buses/channel_disable_time", 2.0)) * get_mix_rate();
  1086. ProjectSettings::get_singleton()->set_custom_property_info("audio/buses/channel_disable_time", PropertyInfo(Variant::FLOAT, "audio/buses/channel_disable_time", PROPERTY_HINT_RANGE, "0,5,0.01,or_greater"));
  1087. buffer_size = 512; //hardcoded for now
  1088. init_channels_and_buffers();
  1089. mix_count = 0;
  1090. set_bus_count(1);
  1091. set_bus_name(0, "Master");
  1092. if (AudioDriver::get_singleton()) {
  1093. AudioDriver::get_singleton()->start();
  1094. }
  1095. #ifdef TOOLS_ENABLED
  1096. set_edited(false); //avoid editors from thinking this was edited
  1097. #endif
  1098. GLOBAL_DEF_RST("audio/video/video_delay_compensation_ms", 0);
  1099. }
  1100. void AudioServer::update() {
  1101. #ifdef DEBUG_ENABLED
  1102. if (EngineDebugger::is_profiling("servers")) {
  1103. // Driver time includes server time + effects times
  1104. // Server time includes effects times
  1105. uint64_t driver_time = AudioDriver::get_singleton()->get_profiling_time();
  1106. uint64_t server_time = prof_time;
  1107. // Subtract the server time from the driver time
  1108. if (driver_time > server_time) {
  1109. driver_time -= server_time;
  1110. }
  1111. Array values;
  1112. for (int i = buses.size() - 1; i >= 0; i--) {
  1113. Bus *bus = buses[i];
  1114. if (bus->bypass) {
  1115. continue;
  1116. }
  1117. for (int j = 0; j < bus->effects.size(); j++) {
  1118. if (!bus->effects[j].enabled) {
  1119. continue;
  1120. }
  1121. values.push_back(String(bus->name) + bus->effects[j].effect->get_name());
  1122. values.push_back(USEC_TO_SEC(bus->effects[j].prof_time));
  1123. // Subtract the effect time from the driver and server times
  1124. if (driver_time > bus->effects[j].prof_time) {
  1125. driver_time -= bus->effects[j].prof_time;
  1126. }
  1127. if (server_time > bus->effects[j].prof_time) {
  1128. server_time -= bus->effects[j].prof_time;
  1129. }
  1130. }
  1131. }
  1132. values.push_back("audio_server");
  1133. values.push_back(USEC_TO_SEC(server_time));
  1134. values.push_back("audio_driver");
  1135. values.push_back(USEC_TO_SEC(driver_time));
  1136. values.push_front("audio_thread");
  1137. EngineDebugger::profiler_add_frame_data("servers", values);
  1138. }
  1139. // Reset profiling times
  1140. for (int i = buses.size() - 1; i >= 0; i--) {
  1141. Bus *bus = buses[i];
  1142. if (bus->bypass) {
  1143. continue;
  1144. }
  1145. for (int j = 0; j < bus->effects.size(); j++) {
  1146. if (!bus->effects[j].enabled) {
  1147. continue;
  1148. }
  1149. bus->effects.write[j].prof_time = 0;
  1150. }
  1151. }
  1152. AudioDriver::get_singleton()->reset_profiling_time();
  1153. prof_time = 0;
  1154. #endif
  1155. for (CallbackItem *ci : update_callback_list) {
  1156. ci->callback(ci->userdata);
  1157. }
  1158. mix_callback_list.maybe_cleanup();
  1159. update_callback_list.maybe_cleanup();
  1160. listener_changed_callback_list.maybe_cleanup();
  1161. playback_list.maybe_cleanup();
  1162. for (AudioStreamPlaybackBusDetails *bus_details : bus_details_graveyard_frame_old) {
  1163. bus_details_graveyard_frame_old.erase(bus_details, [](AudioStreamPlaybackBusDetails *d) { delete d; });
  1164. }
  1165. for (AudioStreamPlaybackBusDetails *bus_details : bus_details_graveyard) {
  1166. bus_details_graveyard_frame_old.insert(bus_details);
  1167. bus_details_graveyard.erase(bus_details);
  1168. }
  1169. bus_details_graveyard.maybe_cleanup();
  1170. bus_details_graveyard_frame_old.maybe_cleanup();
  1171. }
  1172. void AudioServer::load_default_bus_layout() {
  1173. String layout_path = GLOBAL_GET("audio/buses/default_bus_layout");
  1174. if (ResourceLoader::exists(layout_path)) {
  1175. Ref<AudioBusLayout> default_layout = ResourceLoader::load(layout_path);
  1176. if (default_layout.is_valid()) {
  1177. set_bus_layout(default_layout);
  1178. }
  1179. }
  1180. }
  1181. void AudioServer::finish() {
  1182. for (int i = 0; i < AudioDriverManager::get_driver_count(); i++) {
  1183. AudioDriverManager::get_driver(i)->finish();
  1184. }
  1185. for (int i = 0; i < buses.size(); i++) {
  1186. memdelete(buses[i]);
  1187. }
  1188. buses.clear();
  1189. }
  1190. /* MISC config */
  1191. void AudioServer::lock() {
  1192. AudioDriver::get_singleton()->lock();
  1193. }
  1194. void AudioServer::unlock() {
  1195. AudioDriver::get_singleton()->unlock();
  1196. }
  1197. AudioServer::SpeakerMode AudioServer::get_speaker_mode() const {
  1198. return (AudioServer::SpeakerMode)AudioDriver::get_singleton()->get_speaker_mode();
  1199. }
  1200. float AudioServer::get_mix_rate() const {
  1201. return AudioDriver::get_singleton()->get_mix_rate();
  1202. }
  1203. float AudioServer::read_output_peak_db() const {
  1204. return 0;
  1205. }
  1206. AudioServer *AudioServer::get_singleton() {
  1207. return singleton;
  1208. }
  1209. double AudioServer::get_output_latency() const {
  1210. return AudioDriver::get_singleton()->get_latency();
  1211. }
  1212. double AudioServer::get_time_to_next_mix() const {
  1213. return AudioDriver::get_singleton()->get_time_to_next_mix();
  1214. }
  1215. double AudioServer::get_time_since_last_mix() const {
  1216. return AudioDriver::get_singleton()->get_time_since_last_mix();
  1217. }
  1218. AudioServer *AudioServer::singleton = nullptr;
  1219. void AudioServer::add_update_callback(AudioCallback p_callback, void *p_userdata) {
  1220. CallbackItem *ci = new CallbackItem();
  1221. ci->callback = p_callback;
  1222. ci->userdata = p_userdata;
  1223. update_callback_list.insert(ci);
  1224. }
  1225. void AudioServer::remove_update_callback(AudioCallback p_callback, void *p_userdata) {
  1226. for (CallbackItem *ci : update_callback_list) {
  1227. if (ci->callback == p_callback && ci->userdata == p_userdata) {
  1228. update_callback_list.erase(ci, [](CallbackItem *c) { delete c; });
  1229. }
  1230. }
  1231. }
  1232. void AudioServer::add_mix_callback(AudioCallback p_callback, void *p_userdata) {
  1233. CallbackItem *ci = new CallbackItem();
  1234. ci->callback = p_callback;
  1235. ci->userdata = p_userdata;
  1236. mix_callback_list.insert(ci);
  1237. }
  1238. void AudioServer::remove_mix_callback(AudioCallback p_callback, void *p_userdata) {
  1239. for (CallbackItem *ci : mix_callback_list) {
  1240. if (ci->callback == p_callback && ci->userdata == p_userdata) {
  1241. mix_callback_list.erase(ci, [](CallbackItem *c) { delete c; });
  1242. }
  1243. }
  1244. }
  1245. void AudioServer::add_listener_changed_callback(AudioCallback p_callback, void *p_userdata) {
  1246. CallbackItem *ci = new CallbackItem();
  1247. ci->callback = p_callback;
  1248. ci->userdata = p_userdata;
  1249. listener_changed_callback_list.insert(ci);
  1250. }
  1251. void AudioServer::remove_listener_changed_callback(AudioCallback p_callback, void *p_userdata) {
  1252. for (CallbackItem *ci : listener_changed_callback_list) {
  1253. if (ci->callback == p_callback && ci->userdata == p_userdata) {
  1254. listener_changed_callback_list.erase(ci, [](CallbackItem *c) { delete c; });
  1255. }
  1256. }
  1257. }
  1258. void AudioServer::set_bus_layout(const Ref<AudioBusLayout> &p_bus_layout) {
  1259. ERR_FAIL_COND(p_bus_layout.is_null() || p_bus_layout->buses.size() == 0);
  1260. lock();
  1261. for (int i = 0; i < buses.size(); i++) {
  1262. memdelete(buses[i]);
  1263. }
  1264. buses.resize(p_bus_layout->buses.size());
  1265. bus_map.clear();
  1266. for (int i = 0; i < p_bus_layout->buses.size(); i++) {
  1267. Bus *bus = memnew(Bus);
  1268. if (i == 0) {
  1269. bus->name = "Master";
  1270. } else {
  1271. bus->name = p_bus_layout->buses[i].name;
  1272. bus->send = p_bus_layout->buses[i].send;
  1273. }
  1274. bus->solo = p_bus_layout->buses[i].solo;
  1275. bus->mute = p_bus_layout->buses[i].mute;
  1276. bus->bypass = p_bus_layout->buses[i].bypass;
  1277. bus->volume_db = p_bus_layout->buses[i].volume_db;
  1278. for (int j = 0; j < p_bus_layout->buses[i].effects.size(); j++) {
  1279. Ref<AudioEffect> fx = p_bus_layout->buses[i].effects[j].effect;
  1280. if (fx.is_valid()) {
  1281. Bus::Effect bfx;
  1282. bfx.effect = fx;
  1283. bfx.enabled = p_bus_layout->buses[i].effects[j].enabled;
  1284. #ifdef DEBUG_ENABLED
  1285. bfx.prof_time = 0;
  1286. #endif
  1287. bus->effects.push_back(bfx);
  1288. }
  1289. }
  1290. bus_map[bus->name] = bus;
  1291. buses.write[i] = bus;
  1292. buses[i]->channels.resize(channel_count);
  1293. for (int j = 0; j < channel_count; j++) {
  1294. buses.write[i]->channels.write[j].buffer.resize(buffer_size);
  1295. }
  1296. _update_bus_effects(i);
  1297. }
  1298. #ifdef TOOLS_ENABLED
  1299. set_edited(false);
  1300. #endif
  1301. unlock();
  1302. }
  1303. Ref<AudioBusLayout> AudioServer::generate_bus_layout() const {
  1304. Ref<AudioBusLayout> state;
  1305. state.instantiate();
  1306. state->buses.resize(buses.size());
  1307. for (int i = 0; i < buses.size(); i++) {
  1308. state->buses.write[i].name = buses[i]->name;
  1309. state->buses.write[i].send = buses[i]->send;
  1310. state->buses.write[i].mute = buses[i]->mute;
  1311. state->buses.write[i].solo = buses[i]->solo;
  1312. state->buses.write[i].bypass = buses[i]->bypass;
  1313. state->buses.write[i].volume_db = buses[i]->volume_db;
  1314. for (int j = 0; j < buses[i]->effects.size(); j++) {
  1315. AudioBusLayout::Bus::Effect fx;
  1316. fx.effect = buses[i]->effects[j].effect;
  1317. fx.enabled = buses[i]->effects[j].enabled;
  1318. state->buses.write[i].effects.push_back(fx);
  1319. }
  1320. }
  1321. return state;
  1322. }
  1323. PackedStringArray AudioServer::get_device_list() {
  1324. return AudioDriver::get_singleton()->get_device_list();
  1325. }
  1326. String AudioServer::get_device() {
  1327. return AudioDriver::get_singleton()->get_device();
  1328. }
  1329. void AudioServer::set_device(String device) {
  1330. AudioDriver::get_singleton()->set_device(device);
  1331. }
  1332. PackedStringArray AudioServer::capture_get_device_list() {
  1333. return AudioDriver::get_singleton()->capture_get_device_list();
  1334. }
  1335. String AudioServer::capture_get_device() {
  1336. return AudioDriver::get_singleton()->capture_get_device();
  1337. }
  1338. void AudioServer::capture_set_device(const String &p_name) {
  1339. AudioDriver::get_singleton()->capture_set_device(p_name);
  1340. }
  1341. void AudioServer::set_enable_tagging_used_audio_streams(bool p_enable) {
  1342. tag_used_audio_streams = p_enable;
  1343. }
  1344. void AudioServer::_bind_methods() {
  1345. ClassDB::bind_method(D_METHOD("set_bus_count", "amount"), &AudioServer::set_bus_count);
  1346. ClassDB::bind_method(D_METHOD("get_bus_count"), &AudioServer::get_bus_count);
  1347. ClassDB::bind_method(D_METHOD("remove_bus", "index"), &AudioServer::remove_bus);
  1348. ClassDB::bind_method(D_METHOD("add_bus", "at_position"), &AudioServer::add_bus, DEFVAL(-1));
  1349. ClassDB::bind_method(D_METHOD("move_bus", "index", "to_index"), &AudioServer::move_bus);
  1350. ClassDB::bind_method(D_METHOD("set_bus_name", "bus_idx", "name"), &AudioServer::set_bus_name);
  1351. ClassDB::bind_method(D_METHOD("get_bus_name", "bus_idx"), &AudioServer::get_bus_name);
  1352. ClassDB::bind_method(D_METHOD("get_bus_index", "bus_name"), &AudioServer::get_bus_index);
  1353. ClassDB::bind_method(D_METHOD("get_bus_channels", "bus_idx"), &AudioServer::get_bus_channels);
  1354. ClassDB::bind_method(D_METHOD("set_bus_volume_db", "bus_idx", "volume_db"), &AudioServer::set_bus_volume_db);
  1355. ClassDB::bind_method(D_METHOD("get_bus_volume_db", "bus_idx"), &AudioServer::get_bus_volume_db);
  1356. ClassDB::bind_method(D_METHOD("set_bus_send", "bus_idx", "send"), &AudioServer::set_bus_send);
  1357. ClassDB::bind_method(D_METHOD("get_bus_send", "bus_idx"), &AudioServer::get_bus_send);
  1358. ClassDB::bind_method(D_METHOD("set_bus_solo", "bus_idx", "enable"), &AudioServer::set_bus_solo);
  1359. ClassDB::bind_method(D_METHOD("is_bus_solo", "bus_idx"), &AudioServer::is_bus_solo);
  1360. ClassDB::bind_method(D_METHOD("set_bus_mute", "bus_idx", "enable"), &AudioServer::set_bus_mute);
  1361. ClassDB::bind_method(D_METHOD("is_bus_mute", "bus_idx"), &AudioServer::is_bus_mute);
  1362. ClassDB::bind_method(D_METHOD("set_bus_bypass_effects", "bus_idx", "enable"), &AudioServer::set_bus_bypass_effects);
  1363. ClassDB::bind_method(D_METHOD("is_bus_bypassing_effects", "bus_idx"), &AudioServer::is_bus_bypassing_effects);
  1364. ClassDB::bind_method(D_METHOD("add_bus_effect", "bus_idx", "effect", "at_position"), &AudioServer::add_bus_effect, DEFVAL(-1));
  1365. ClassDB::bind_method(D_METHOD("remove_bus_effect", "bus_idx", "effect_idx"), &AudioServer::remove_bus_effect);
  1366. ClassDB::bind_method(D_METHOD("get_bus_effect_count", "bus_idx"), &AudioServer::get_bus_effect_count);
  1367. ClassDB::bind_method(D_METHOD("get_bus_effect", "bus_idx", "effect_idx"), &AudioServer::get_bus_effect);
  1368. ClassDB::bind_method(D_METHOD("get_bus_effect_instance", "bus_idx", "effect_idx", "channel"), &AudioServer::get_bus_effect_instance, DEFVAL(0));
  1369. ClassDB::bind_method(D_METHOD("swap_bus_effects", "bus_idx", "effect_idx", "by_effect_idx"), &AudioServer::swap_bus_effects);
  1370. ClassDB::bind_method(D_METHOD("set_bus_effect_enabled", "bus_idx", "effect_idx", "enabled"), &AudioServer::set_bus_effect_enabled);
  1371. ClassDB::bind_method(D_METHOD("is_bus_effect_enabled", "bus_idx", "effect_idx"), &AudioServer::is_bus_effect_enabled);
  1372. ClassDB::bind_method(D_METHOD("get_bus_peak_volume_left_db", "bus_idx", "channel"), &AudioServer::get_bus_peak_volume_left_db);
  1373. ClassDB::bind_method(D_METHOD("get_bus_peak_volume_right_db", "bus_idx", "channel"), &AudioServer::get_bus_peak_volume_right_db);
  1374. ClassDB::bind_method(D_METHOD("set_playback_speed_scale", "scale"), &AudioServer::set_playback_speed_scale);
  1375. ClassDB::bind_method(D_METHOD("get_playback_speed_scale"), &AudioServer::get_playback_speed_scale);
  1376. ClassDB::bind_method(D_METHOD("lock"), &AudioServer::lock);
  1377. ClassDB::bind_method(D_METHOD("unlock"), &AudioServer::unlock);
  1378. ClassDB::bind_method(D_METHOD("get_speaker_mode"), &AudioServer::get_speaker_mode);
  1379. ClassDB::bind_method(D_METHOD("get_mix_rate"), &AudioServer::get_mix_rate);
  1380. ClassDB::bind_method(D_METHOD("get_device_list"), &AudioServer::get_device_list);
  1381. ClassDB::bind_method(D_METHOD("get_device"), &AudioServer::get_device);
  1382. ClassDB::bind_method(D_METHOD("set_device", "device"), &AudioServer::set_device);
  1383. ClassDB::bind_method(D_METHOD("get_time_to_next_mix"), &AudioServer::get_time_to_next_mix);
  1384. ClassDB::bind_method(D_METHOD("get_time_since_last_mix"), &AudioServer::get_time_since_last_mix);
  1385. ClassDB::bind_method(D_METHOD("get_output_latency"), &AudioServer::get_output_latency);
  1386. ClassDB::bind_method(D_METHOD("capture_get_device_list"), &AudioServer::capture_get_device_list);
  1387. ClassDB::bind_method(D_METHOD("capture_get_device"), &AudioServer::capture_get_device);
  1388. ClassDB::bind_method(D_METHOD("capture_set_device", "name"), &AudioServer::capture_set_device);
  1389. ClassDB::bind_method(D_METHOD("set_bus_layout", "bus_layout"), &AudioServer::set_bus_layout);
  1390. ClassDB::bind_method(D_METHOD("generate_bus_layout"), &AudioServer::generate_bus_layout);
  1391. ClassDB::bind_method(D_METHOD("set_enable_tagging_used_audio_streams", "enable"), &AudioServer::set_enable_tagging_used_audio_streams);
  1392. ADD_PROPERTY(PropertyInfo(Variant::INT, "bus_count"), "set_bus_count", "get_bus_count");
  1393. ADD_PROPERTY(PropertyInfo(Variant::STRING, "device"), "set_device", "get_device");
  1394. ADD_PROPERTY(PropertyInfo(Variant::STRING, "capture_device"), "capture_set_device", "capture_get_device");
  1395. // The default value may be set to an empty string by the platform-specific audio driver.
  1396. // Override for class reference generation purposes.
  1397. ADD_PROPERTY_DEFAULT("capture_device", "Default");
  1398. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "playback_speed_scale"), "set_playback_speed_scale", "get_playback_speed_scale");
  1399. ADD_SIGNAL(MethodInfo("bus_layout_changed"));
  1400. BIND_ENUM_CONSTANT(SPEAKER_MODE_STEREO);
  1401. BIND_ENUM_CONSTANT(SPEAKER_SURROUND_31);
  1402. BIND_ENUM_CONSTANT(SPEAKER_SURROUND_51);
  1403. BIND_ENUM_CONSTANT(SPEAKER_SURROUND_71);
  1404. }
  1405. AudioServer::AudioServer() {
  1406. singleton = this;
  1407. }
  1408. AudioServer::~AudioServer() {
  1409. singleton = nullptr;
  1410. }
  1411. /////////////////////////////////
  1412. bool AudioBusLayout::_set(const StringName &p_name, const Variant &p_value) {
  1413. String s = p_name;
  1414. if (s.begins_with("bus/")) {
  1415. int index = s.get_slice("/", 1).to_int();
  1416. if (buses.size() <= index) {
  1417. buses.resize(index + 1);
  1418. }
  1419. Bus &bus = buses.write[index];
  1420. String what = s.get_slice("/", 2);
  1421. if (what == "name") {
  1422. bus.name = p_value;
  1423. } else if (what == "solo") {
  1424. bus.solo = p_value;
  1425. } else if (what == "mute") {
  1426. bus.mute = p_value;
  1427. } else if (what == "bypass_fx") {
  1428. bus.bypass = p_value;
  1429. } else if (what == "volume_db") {
  1430. bus.volume_db = p_value;
  1431. } else if (what == "send") {
  1432. bus.send = p_value;
  1433. } else if (what == "effect") {
  1434. int which = s.get_slice("/", 3).to_int();
  1435. if (bus.effects.size() <= which) {
  1436. bus.effects.resize(which + 1);
  1437. }
  1438. Bus::Effect &fx = bus.effects.write[which];
  1439. String fxwhat = s.get_slice("/", 4);
  1440. if (fxwhat == "effect") {
  1441. fx.effect = p_value;
  1442. } else if (fxwhat == "enabled") {
  1443. fx.enabled = p_value;
  1444. } else {
  1445. return false;
  1446. }
  1447. return true;
  1448. } else {
  1449. return false;
  1450. }
  1451. return true;
  1452. }
  1453. return false;
  1454. }
  1455. bool AudioBusLayout::_get(const StringName &p_name, Variant &r_ret) const {
  1456. String s = p_name;
  1457. if (s.begins_with("bus/")) {
  1458. int index = s.get_slice("/", 1).to_int();
  1459. if (index < 0 || index >= buses.size()) {
  1460. return false;
  1461. }
  1462. const Bus &bus = buses[index];
  1463. String what = s.get_slice("/", 2);
  1464. if (what == "name") {
  1465. r_ret = bus.name;
  1466. } else if (what == "solo") {
  1467. r_ret = bus.solo;
  1468. } else if (what == "mute") {
  1469. r_ret = bus.mute;
  1470. } else if (what == "bypass_fx") {
  1471. r_ret = bus.bypass;
  1472. } else if (what == "volume_db") {
  1473. r_ret = bus.volume_db;
  1474. } else if (what == "send") {
  1475. r_ret = bus.send;
  1476. } else if (what == "effect") {
  1477. int which = s.get_slice("/", 3).to_int();
  1478. if (which < 0 || which >= bus.effects.size()) {
  1479. return false;
  1480. }
  1481. const Bus::Effect &fx = bus.effects[which];
  1482. String fxwhat = s.get_slice("/", 4);
  1483. if (fxwhat == "effect") {
  1484. r_ret = fx.effect;
  1485. } else if (fxwhat == "enabled") {
  1486. r_ret = fx.enabled;
  1487. } else {
  1488. return false;
  1489. }
  1490. return true;
  1491. } else {
  1492. return false;
  1493. }
  1494. return true;
  1495. }
  1496. return false;
  1497. }
  1498. void AudioBusLayout::_get_property_list(List<PropertyInfo> *p_list) const {
  1499. for (int i = 0; i < buses.size(); i++) {
  1500. p_list->push_back(PropertyInfo(Variant::STRING, "bus/" + itos(i) + "/name", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1501. p_list->push_back(PropertyInfo(Variant::BOOL, "bus/" + itos(i) + "/solo", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1502. p_list->push_back(PropertyInfo(Variant::BOOL, "bus/" + itos(i) + "/mute", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1503. p_list->push_back(PropertyInfo(Variant::BOOL, "bus/" + itos(i) + "/bypass_fx", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1504. p_list->push_back(PropertyInfo(Variant::FLOAT, "bus/" + itos(i) + "/volume_db", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1505. p_list->push_back(PropertyInfo(Variant::FLOAT, "bus/" + itos(i) + "/send", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1506. for (int j = 0; j < buses[i].effects.size(); j++) {
  1507. p_list->push_back(PropertyInfo(Variant::OBJECT, "bus/" + itos(i) + "/effect/" + itos(j) + "/effect", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1508. p_list->push_back(PropertyInfo(Variant::BOOL, "bus/" + itos(i) + "/effect/" + itos(j) + "/enabled", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  1509. }
  1510. }
  1511. }
  1512. AudioBusLayout::AudioBusLayout() {
  1513. buses.resize(1);
  1514. buses.write[0].name = "Master";
  1515. }