========================================================================================== REVISION HISTORY : FMOD Studio API Copyright (c) Firelight Technologies, Pty, Ltd, 2011-2023 https://www.fmod.com ========================================================================================== Legend ------ Win: Microsoft Windows XboxOne: Microsoft Xbox One Mac: Apple macOS GameCore: Microsoft Game Core Linux: Linux PS4: Sony PlayStation 4 iOS: Apple iOS / tvOS PS5: Sony PlayStation 5 Android: Google Android Switch: Nintendo Switch HTML5: JavaScript WebAssembly UWP: Microsoft Universal Windows Platform 27/9/23 2.02.18 - Studio API minor release (build 137105) ------------------------------------------------------------------------------------------ Features: * Core API - iOS - A new output plugin called FMOD_OUTPUTTYPE_PHASE has been enabled, which supports 3D spatial objects. For iOS 16.4. * Core API - PS5 - From SDK 8.00 we now support Dolby Atmos and thus 7.1.4 output. To enable this set FMOD_SPEAKERMODE_7POINT1POINT4. * Unity - Emitters are now able to be triggered from UI elements using mouse events. Fixes: * Studio API - Fixed programmer sounds getting spatialized by the Core API if the passed in Sound had the FMOD_3D mode set. * Studio API - Fixed shared streaming assets being forced to stop when the bank they are streaming from is unloaded if the bank was loaded via Studio::System::loadBankCustom. * Studio API - Fixed pops when calling Studio::EventInstance::setTimelinePosition on events with only one sound on the timeline. * Studio API - Fixed streaming instruments failing to stop at the right time if they were started too close to the end. * Studio API - Multi instruments/scatterers now factor in silence instruments when determining whether to play an instrument from a playlist in shuffle mode. If an instrument is followed by one or more silence instruments, that instrument will not be selected to play next. * Core API - Fixed cycles created using DSP connections not causing a feedback loop. * Core API - Slight improvement to Multiband EQ filter stability near the upper end of the frequency range on 24kHz devices. * Core API - Clamp and log a warning when setting a high pitch value rather than returning an error. * Core API - Fixed some DSP effects incorrectly skipping processing as if bypassed via DSP::setBypass when DSP::setWetDryMix is called with prewet set to 0. * Core API - Fixed potential crash in the transceiver DSP if certain pre-init calls are made in sequence, such as System::setDSPBufferSize followed by System::setOutput. * Core API - Fixed potential crash (or assert) when opening and closing ports. * Core API - Fixed potential audio corruption for 3D objects if the mixer is under heavy load. * Core API - PS5 - Fixed internal error from sceAudioOut2PortSetAttributes returning "not-ready" caused by a race condition in opening a port. * Core API - Windows - Fixed WASAPI device enumeration memory leaks when devices fail. * Unreal - Fixed Sequencer ignoring Start keys at frame 0. * Unreal - Restore "Reload Banks' option to File dropdown menu. * Unreal - Added validation to fix lack of leading or trailing forward slash in Content Browser Prefix. * Unreal - Fixed FMODAudioComponent ignoring "When Finished" behavior when Sequencer finishes playback. * Unreal - Fixed localized banks not working. * Unity - Fixed non-rigidbody doppler dividing by 0 if Time.timescale = 0. * Unity - Fixed issue when playing in Editor where the path plugins were attempted to be loaded from contained "/Assets" twice. * Android - Fixed playerSetVolume crash on devices with Android OS below Android T. * Windows - Removed hard dependency on msacm32.dll. Notes: * Core API - Calling the DSP plugin API functions, FMOD_DSP_GETSAMPLERATE, FMOD_DSP_GETBLOCKSIZE, or FMOD_DSP_GETSPEAKERMODE before init will now return an error as those settings are not confirmed until after initialization. * PS4 - Now built with SDK 10.508.001. * PS5 - Now built with SDK 7.00.00.38. 21/8/23 2.02.17 - Studio API minor release (build 136061) ------------------------------------------------------------------------------------------ Fixes: * Studio API - Fixed Studio::EventInstance::getTimelinePosition occasionally reporting incorrect position. * Studio API - Fixed hang after running an Event for 12 hours with beat callbacks. * Studio API - Fixed instruments that are automated on the timeline having incorrect automated values when they start. * Core API - Fixed virtual voice issue that could cause Channels to restart. * Core API - Fixed assert firing from resampler for wildly varying pitch values. * Core API - Fixed FMOD_INIT_3D_RIGHTHANDED to work correctly when using FMOD_3D_HEADRELATIVE. * Core API - GameCore/PS5 - Fixed the Opus and XMA codecs to display an appropriate error log if the DSP buffer size is not 512. * Core API - HTML5 - Fixed compiler errors to do with using Strict Mode. * Unity - Fixed Studio Global Parameter Trigger silently failing on awake. * Unity - FMOD Studio system failing to initialize will no longer throw as an exception. * Unity - Fixed error when auditioning Events containing global parameters in Event Browser. * Unreal - Fixed FMODAudioComponents always using default parameter values. * Unreal - Fixed Sequencer restarting AudioComponents when Sequencer Editor open. * Unreal - Fixed crash when FMOD Studio project contains folders with "." character. * Unreal - Fixed FMODGenerateAssets commandlet not deleting old assets on rebuild. * Android - Fixed exported symbols to avoid issues with unwinder on armeabi-v7a. 13/7/23 2.02.16 - Studio API minor release (build 135072) ------------------------------------------------------------------------------------------ Fixes: * Studio API - Fixed voice stealing behavior not updating when connected to live update. * Studio API - Fixed instruments with AHDSR not stopping after release, introduced in 2.02.15. * Unity - Fixed ApplyMuteState and PauseAllEvents functions when when using Addressables * Unity - Fixed Editor Platform settings inheriting from the Default Platform. * Unity - Fixed folder references to allow the FMOD Plugin base folder to be moved anywhere on disk for use with the Unity Package Manager. * Unreal - Fixed potential crash when linking to Studio project locales. * iOS/Mac - Fixed example Xcode projects with incorrect paths failing to load. Notes: * Unity - Added support for Unity 2023.1. 2/6/23 2.02.15 - Studio API minor release (build 134211) ------------------------------------------------------------------------------------------ Features: * Unreal - Added FMODStudioModule::GetDefaultLocale to get the default locale which can be changed in the FMOD Settings. Fixes: * Studio API - Fixed live update crash if tweaking an Event with an empty single sound instrument. * Studio API - Fixed potential crash if releasing an EventInstance from the Stop callback. * Studio API - Fixed third party DSP plugins causing potential assert by calling DSP::setParameterDSP on effects managed by Studio. * Unity - Fixed Addressable banks not being built when building with batchmode. * Unreal - Fixed rare AudioVolume Reverb Effect cast crash. * Unreal - Fixed crash when using Hot Reload in UE4.26 & 4.27. * Unreal - FMODStudioModule::GetLocale correctly now returns the currently set locale instead of the default. * Unreal - PS4 - Fixed audio degradation due to mixer thread competing with renderer thread. Notes: * iOS - Now built with iOS SDK 16.4 (Xcode 14.3). * Mac - Now built with macOS SDK 13.3 (Xcode 14.3), min deploy target is now 10.13 as mandated by Xcode. * Unreal - Added support for UE5.2. 3/5/23 2.02.14 - Studio API minor release (build 133546) ------------------------------------------------------------------------------------------ Features: * Core API - Examples now have a Common_Log function for outputting to TTY. * Unity - Reduced time spent generating bank stubs, and reduced time spent copying banks into StreamingAssets folder when building. Fixes: * Studio API - Fixed crash when adding parameter sheet to a playing event while live update connected. * Studio API - Fixed instruments starting playback with stale property values during hotswap. * Studio API - Fixed Global Parameters being unable to automate other Global Parameters. * Core API - PS5 - Fixed out-of-resources errors when decoding a large number of FMOD_CREATESAMPLE (decompress into memory) sounds encoded as AT9. * Core API - Win/GameCore - Fixed potential crash when an audio device reports an invalid name. * Unity - Fixed Find and Replace tool not finding prefabs. * Unity - iOS - Fixed audio not resuming after opening and closing Siri. * Unity - Fixed hang caused by RuntimeManager access when auditioning in timeline. 17/3/23 2.02.13 - Studio API minor release (build 132591) ------------------------------------------------------------------------------------------ Features: * Unity - Added non-Rigidbody Doppler effect option on Emitters. Fixes: * Studio API - Fixed voice stealing failing on events in FMOD_STUDIO_PLAYBACK_STOPPING state. * Studio API - Fixed assert during Live Update when deleting a Global Parameter. * Studio API - AHDSR modulators will now have correct release behavior when the instrument stop condition is triggered by an event condition. * Studio API - Fixed crash when changing parameter scope on a playing event. * Studio API - Fixed a crash when removing automations via Live Update. * Core API - Fixed playback issues with certain ice/shoutcast net-streams. * Core API - GameCore - Fixed rare crash when playing back compressed Opus. * Core API - GameCore - Reduced memory usage for hardware convolution reverb. * Core API - Mac - Fixed crash when using input devices below 16kHz sample rate. * Core API - PS5 - Fixed audio output stutters when a port disconnects. * Core API - Win - Fixed record enumeration fails causing crash. * Unity - Fixed Visual Scripting units not generating in Unity 2021+. * Unity - Fixed plugin bundles not working on Mac. * Unreal - Fixed AssetLookup being modified each time the editor is opened. * Unreal - Fixed Editor Live Update not connecting to Studio. Note: * GameCore - Now built with October 2022 QFE 1 GDKX. * Switch - Now built with SDK 15.3.0. 31/1/23 2.02.12 - Studio API minor release (build 131544) ------------------------------------------------------------------------------------------ Features: * Core API - Warning is now logged when a voice swap occurs on an voice with an audibility above -20dB. * Unity - Added support for Unity 2022.2. * Unity - macOS can now handle .dylib plugins natively * Unity - Android - Added support for patch build. Fixes: * Studio API - Fixed Live Update being ignored if Studio connects before the master Bank is loaded. * Studio API - Fixed a potential crash updating a referenced 3D Event if it has been forcibly stopped due to bank unload. * Studio API - Fixed issue where using a modulated parameter to automate a property of an AHDSR modulator would sometimes cause the AHDSR to start in a bad state. * Studio API - Fixed VCA handles becoming invalid when live update changes them. * Studio API - Fixed incorrect scheduling of playlist entries in multi instruments that have pitch changes. * Core API - Switch - Fixed potential Opus crash when streaming with custom async IO callbacks. * Core API - PS5 + GameCore - Hardware resource configuration (performed using platform specific FMOD APIs) will now apply during System::init rather than System::create. * Unity - The EventReferenceDrawer "Open in Browser" button now functions when there is no event selected. * Unity - Fixed EventRefDrawer showing incorrect "Migration target X is missing" messages on sub-object fields with MigrateTo specified. * Unity - Fixed hang when RuntimeManager called outside of main thread. * Unity - The Update Event References menu command now scans non-MonoBehaviour objects that are referenced by MonoBehaviours. * Unity - Fixed warning "Settings instance has not been initialized...". * Unity - Fixed 'multiple plugins with same name' error on Mac. * Unreal - Fixed occlusion not working from Audio Component reloaded from a streamed level. * Unreal - Fixed commandlet crashing when trying to delete assets. * Win - Fixed examples not rendering correctly on Windows 11. Notes: * Unity - Added an example on how to pipe audio from a VideoPlayer into FMOD. * iOS - Re-enabled compilation of the now deprecated Bitcode to appease toolchains such as Unity that still require it. * PS4 - Now built with SDK 10.008.001. * PS5 - Now built with SDK 6.00.00.38. 01/12/22 2.02.11 - Studio API minor release (build 130436) ------------------------------------------------------------------------------------------ Features: * Studio API - Studio::System::getBus("bus:/", ...) will now return the master bus if the master bank has been loaded, even if the strings bank has not. * Core API - GameCore - Added in FMOD_GameCore_XMAConfigure. This can be used to control whether to allocate XMA codec hardware resources inside FMOD::System_Create. If not called before FMOD::System_Create the resources will be allocated on first codec use. * Core API - Mac - Added support for 7.1.4 output type. * Core API - PS5 - Added in FMOD_PS5_AT9Configure. This can be used to control whether to allocate AT9 codec hardware resources inside FMOD::System_Create. If not called before FMOD::System_Create the resources will be allocated on first codec use. * Unity - Android - Added support for x86_64. * Unreal - Added a Sound Stopped callback to the FMODAudioComponent. Fixes: * Studio API - Fixed crash when connecting live update and a bank was loaded multiple times with FMOD_STUDIO_LOAD_BANK_NONBLOCKING flag. * Studio API - Fixed every asset in an Audio Table being parsed when only one item is required. * Studio API - Logging more meaningful error message when attempting to get/set listener properties with an invalid listener index. * Core API - Fixed recording not starting immediately after changing output devices. * Core API - Fixed AAudio no-sound issue if device disconnection occurs during initialization. * Core API - Fixed a stall in Sound::release on nonblocking sounds. * Unity - Added optimized DistanceSquaredToNearestListener method to avoid unnecessary square root. * Unity - Fixed StudioEventEmitter clearing handle prematurely when Allow Fadeout enabled. * Unity - Fixed FMODStudioEventEmitter inspector not updating displayed min and max attenuation when banks refreshed. * Unity - Error now logged when accessing RuntimeManager from Editor-only callsite. * Unity - Fixed EventReferenceDrawer input losing focus when not found warning appears. * Unreal - Fixed BankLookup.uasset being modified whenever banks get refreshed while using split banks. Notes: * Unreal - Added support for UE5.1. * iOS - Now built with iOS SDK 16.0 (Xcode 14.0.1), min deploy target is now 11.0 and 32bit support has been removed as mandated by Xcode. * Mac - Now built with macOS SDK 12.3 (Xcode 14.0.1). 28/10/22 2.02.10 - Studio API minor release (build 129212) ------------------------------------------------------------------------------------------ Features: * Core API - Added DSP::setCallback. Fixes: * Studio API - Fixed a race condition where the Studio API could delete DSP parameter data before the DSP was released. * Core API - Fixed bug with fallback realloc copying excess memory when memory callbacks being overridden but a realloc wasn't provided. * Core API - Fixed crash with .MOD format with a particular combination of commands. * Core API - Fixed potential FMOD_ERR_INVALID_PARAM from System::setDriver if the device list has changed since a previous call to that function. * Core API - Fixed potential crash when a Send mixes to an partially initialized Return. This crash can occur in the Studio API also. * Core API - Fixed potential access violation due to internal Sound Group list corruption. * Core API - Fixed Channel::setLoopPoints not applying if the stream decode buffer is larger than the Sound. * Unity - Removed benign errors originating from EventInstance::set3DAttributes calls when API Error Logging is enabled. * Unity - Fixed platform warning appearing unnecessarily. * Unreal - Fixed BankLookup.uasset being modified whenever banks get refreshed while using split banks. Notes: * Unreal - Added support for UE5.1 preview 2. 26/09/22 2.02.09 - Studio API minor release (build 128289) ------------------------------------------------------------------------------------------ Features: * Studio API - Error now logged when attempting to set a readonly Parameter, or when attempting to set a Global Parameter from an EventInstance. * Core API - Deprecated Sound.readData(IntPtr, uint, out uint) in C# wrapper. Instead use Sound.readData(byte[], out uint) or Sound.readData(byte[]). * Core API - Added FMOD_SYSTEM_CALLBACK_RECORDPOSITIONCHANGED callback to notify when new data recorded to FMOD::Sound. * Core API - GameCore - Increased the limits of SetXApuStreamCount to match Microsoft documented maximums. * Unity - Added UnloadBank overloads for TextAsset and AssetReference. * Unreal - Added "Enable API Error Logging" option to Advanced settings section. Integration will log additional internal errors when enabled. * Unreal - LoadBank node "Blocking" enabled by default. Fixes: * Core API - Fixed potential crash if calling DSP::setParameter on a Pan DSP when using the Studio API. * Core API - Fixed ChannelGroup::setPaused(false) to behave the same as Channel, ensuring any 3D calculations are performed before becoming audible. * Core API - Fixed Opus producing different FSBank result on AMD and Intel CPUs. * Core API - Fixed errors in the calculatePannerAttributes() function presented in Core API Guide section 3.5 Controlling a Spatializer DSP (formerly Driving the Spatializer). * Core API - Increased net streaming max URL length to 2048. * Core API - GameCore - Fixed potential XApu stream leak when playing a multi-channel Sound as the hardware limit is reached. * Core API - iOS - Fixed potential crash during System::mixerSuspend / System::mixerResume when playing audio with the platform native AudioQueue (AAC) decoder. * Core API - iOS - Fixed simulator detection. * Core API - Mac - Fixed CoreAudio crash when output device reports >32 outputs. * Core API - Win - Fixed WinSonic crash when the device list changes before System::init. * Resonance - Android - Removed dependency on libc++_shared.so. * Unity - Fixed FMODStudioSettings.asset marked dirty every time Editor reopens. * Unity - Prevented unnecessary allocation when setting parameter on an FMOD StudioEventEmitter. * Unity - Fixed errors when upgrading Unity versions. * Unreal - Provided default values to prevent various initialization warnings. Notes: * Unreal - Moved various internal functions and fields to private. 15/08/22 2.02.08 - Studio API minor release (build 126901) ------------------------------------------------------------------------------------------ Features: * Core API - Added FMOD_INIT_CLIP_OUTPUT flag to enable hard clipping of float values. * Core API - GameCore - Added SetXApuStreamCount and XDspConfigure to C# wrapper. * Core API - PS5 - Added AcmConfigure and AjmConfigure to the C# wrapper. * Core API - PS5 - Opus hardware decoding is now supported. * Core API - PS5 - Added vibration support for the PSVR2 controller via FMOD_PORT_INDEX_FLAG_VR_CONTROLLER. * Unity - Timeline events now begin playback from relative playhead position when auditioning in the timeline. Fixes: * Studio API - EventDescription::is3D now returns the correct result if the Event uses SpeedAbsolute or DistanceNormalized parameters. Requires bank rebuild. * Core API - Fixed ASIO driver enumeration crash caused by invalid driver. * Core API - Fixed incorrect thread IDs being used on pthread based platforms. * Core API - Fixed System::setReverbProperties / FMOD_DSP_TYPE_SFXREVERB not working with 7.1.4 input. * Core API - Fixed crash from reading bad m3u file. * Core API - Fixed the memory tracking system sometimes running out of memory. * Core API - GameCore - Fixed potential crash when there are insufficient xAPU resources remaining. * Core API - Win - Fixed crash in device enumeration cleanup. * Core API - C# - Some callback types renamed in fmod_dsp.cs to match C header. DSP_CREATECALLBACK becomes DSP_CREATE_CALLBACK for example. * Unity - Updated deprecated GameCore build target and runtime platform for Unity 2019.4. * Unity - Fixed issue with "Desktop" being added to build path twice when selecting "Multiple Platform Build" Source Type. * Unity - Fixed issue with HaveAllBanksLoaded not working when banks loaded via AssetReferences. * Unity - Fixed UnsatisfiedLinkError crash on Android when no FMODUnity components present. * Unity - Improved readability of folders in CreateEventPopup. * Unreal - Fixed Blueprint LoadBank not correctly honouring Load Sample data flag. * Unreal - Removed spurious log warning about initial value of global parameters. * Unreal - Fixed memory leak when using PlayEventAttached in nosound mode. Notes: * Switch - Now built with SDK 14.3.0. * Unreal - Added support for UE5.0.3. 18/05/22 2.02.07 - Studio API minor release (build 125130) ------------------------------------------------------------------------------------------ Features: * Core API - HTML5 - FMOD now handles user interaction internally to allow sound to work. The developer no longer has to handle boilerplate code to allow user interaction. * FSBank API - Mac - Added FSBankLib. * Unreal - Added support for speaker mode 7.1.4 in the editor settings. * Unreal - Added separate platforms settings for a variety of options. Fixes: * Studio API - Fixed steal quietest not working correctly causing new EventInstances to think they are the quietest and not play. * Core API - Fixed ChannelGroup::setPitch when applied to the master channel group causing exaggerated pitch changes as time goes on. * Core API - HTML5 - Fixed integer overflow crash in fastcomp builds after 70 mins. * Core API - Linux - Fixed potential hang on shutdown due to bad sound drivers. * Core API - Linux - Fixed crash during System::init if using System::setOutput(FMOD_OUTPUTTYPE_PULSEAUDIO) on a machine without PulseAudio. * Unity - Fixed an error occurring when a timeline playhead leaves an event playable. * Unity - Added missing EventReference overload for PlayOneShotAttached. * Unity - Fixed refcount not updating when LoadBank called with TextAsset. * Unity - Fixed scene hanging when auditioning timeline. * Unity - Fixed events in timeline not refreshing when banks updated. * Unity - Fixed platform objects on Settings asset showing no name in the project window. * Unity - Fixed stale event name left behind after clearing an FMODEventPlayable's event reference field. * Unity - Fixed an error caused by changing an event reference while an event is being previewed in the browser. * Unity - HTML5 - Fixed the audio not playing in the Safari web browser. * Unreal - Fixed not being able to audition events in the editor. * Unreal - Fixed Editor crash when importing bank with paths containing a period. Notes: * PS4 - Now built with SDK 9.508.001. * PS5 - Now built with SDK 5.00.00.33. * Unreal - Added support for UE5. 16/03/22 2.02.06 - Studio API minor release (build 124257) ------------------------------------------------------------------------------------------ Features: * Core API - Android - Added support for loading sounds via Uri paths. * Unity - Added ability to set individual channel counts for each codec format supported by a given platform. Fixes: * Studio API - Fixed issue where certain timeline instruments were causing EventDescription::isOneshot to incorrectly return false. This requires banks to be rebuilt to take effect. * Core API - Fixed rare vorbis decoding error. * Core API - Fixed crash in OutputASIO::stop if start has not been called. * Core API - Fixed static noise or clicks when using DSP::setWetDryMix. * Core API - Fixed FMOD_CODEC_METADATA macro parameters. * Core API - Fixed bad ASIO driver causing enumeration to fail. * Core API - Android - Fixed crash from headset detection with incorrect Java lifetimes. * Core API - HTML5 - Fixed an issue where FMOD_OUTPUTTYPE_AUDIOWORKLET would crash if the speaker mode setup was greater than stereo while refreshing the web browser. * Core API - PS5 - Fixed a crash in the convolution reverb to do with deallocating GPU memory. * Core API - UWP - Fixed corrupted audio using certain headsets that implement virtual surround sound such as those from Razer. * Core API - Win - Fixed WASAPI device enumeration failure causing initialization to fail. * Unity - Fixed il2cpp crash caused by CREATESOUNDEXINFO callbacks not being marshaled when loading sounds from audio tables. * Unity - Fixed event browser preview area not initially displaying at correct size. * Unity - Fixed error shown when attempting to delete Default and Editor platforms. * Unity - Fixed audible glitches on PS4 and PS5 due to FMOD feeder thread getting blocked. * Unity - Fixed enumeration of bank folders when creating an event from an event reference field in the inspector. * Unity - Fixed error if Resonance Listener is not on the Master Bus. * Unity - Fixed banks being reimported with every build when set to AssetBundle import type. * Unity - Fixed cached events losing GUIDs after updating from a 2.01 or earlier integration. * Unreal - Fixed crash when importing banks containing ports. * Unreal - Fixed net streams not working with programmer sounds. * Unreal - Fixed problem locking all buses on bank load if banks haven't finished loading. * Unreal - Fixed AudioComponent::OnEventStopped sometimes being called twice. * Unreal - Fixed FMODAudioComponents inside AudioVolumes not having the correct AmbientVolumeParameter value when Started after being Stopped. Notes: * GameCore - Now built with October 2021 QFE 1 GDKX. * Stadia - Now built with SDK 1.71. * Switch - Now built with SDK 13.3.0. * Unity - GameCore - Now built with June 2021 QFE 4 GDKX. * Unreal - Added support for UE5.0 preview 1. 06/02/22 2.02.05 Patch 1 - Studio API patch release (build 123444) ------------------------------------------------------------------------------------------ Fixes: * Studio API - Fixed crash when allocating internal pool resources. Introduced 2.02.05. Notes: * Due to the severity of the above mentioned issue, the previous release of 2.02.05 has been withdrawn and should not be used. 21/12/21 2.02.05 - Studio API minor release (build 122665) ------------------------------------------------------------------------------------------ Features: * Core API - HTML5 - Added a new FMOD_OUTPUTTYPE called FMOD_OUTPUTTYPE_AUDIOWORKLET, which uses the Web Audio AudioWorkletNode functionality. Fixes: * Studio API - Fixed issue where an async instrument would not trigger if its delay interval was greater than its length on the timeline. * Studio API - Fixed issue where the description of an event retrieved from a start event command would have an invalid handle unless first retrieved via Studio::System::getEvent. * Studio API - Start Event Command Instrument now gracefully handles the case when the event it is trying to start has not been loaded. * Studio API - Fixed issue where the scatterer instrument can spawn instruments inconsistently under certain conditions. * Studio API - Fixed issue where audibility based stealing would not use FMOD_DSP_PARAMETER_OVERALLGAIN::linear_gain_additive in its calculation. For events using the object spatializer or the resonance audio source this would cause the attenuation to be ignored for stealing. * Studio API - Improved general Studio API performance. * Studio API - Improved determination of whether a nested event will end, reducing the incorrect cases where it would be stopped immediately. * Studio API - Fixed Studio::EventInstance::getMinMaxDistance returning -1 before event starts playing. * Core API - GameCore - Fixed very rare Opus decoding hang. * Core API - GameCore - Improved convolution reverb XDSP recovery in case of unexpected hardware failure. * Core API - Linux - PulseAudio now attempts to load and connect for detection rather than running 'pulseaudio --check'. This improves PipeWire compatibility. * Unity - Fixed event reference updater not handling multiple game objects with the same path. * Unity - Fixed setup window showing event reference update step as completed when incomplete tasks remained. * Unreal - FMOD plugin no longer overwrites existing Unreal editor style. * Unreal - Fixed BankLookup being regenerated unnecessarily. * Unreal - Fixed FMODAudioComponent not handling streaming levels correctly. * Unreal - XSX - Fixed builds not finding fmod libs. * Unity - Fixed platform-specific settings not being saved. Notes: * Stadia - Now built with SDK 1.62, LLVM 9.0.1. * Unity - First-time installation no longer requires an event reference update scan. * Unity - Event reference update tasks now display their completion status and can no longer be redundantly run multiple times. * Unity - Editor now restores scene setup after finishing execution of event reference update tasks. 19/11/21 2.02.04 - Studio API minor release (build 121702) ------------------------------------------------------------------------------------------ Features: * Core API - Added support for FMOD_SYSTEM_CALLBACK_DEVICELISTCHANGED with multiple Systems * Core API - Switch - Added Opus decoding for streams. * Unity - HTML5 - Added support for Unity 2021.2. Fixes: * Studio API - When loading pre 2.02 banks, Studio::EventDescription::getMinMaxDistance will now provide a minimum and maximum value based on the spatializers of that event instead of 0. * Core API - Fixed potential crash / error / corruption if using Object spatializer and multiple listeners. * Core API - Improve handling of disconnected devices. * Core API - Fixed incorrect audibility calculation causing some sounds to incorrectly go virtual when sends are involved. * Core API - iOS - Fixed crash when suspending multiple FMOD::System objects while using the AudioQueue codec. * Core API - ARM based iOS / Mac / Switch. Three EQ effect optimized to be up to 2x faster. * Core API - Android and macOS - Now use Monotonic clock instead of Wall clock. * Core API - Win - Fixed issue where WASAPI would fail to gracefully handle an invalidated device due to a disconnection during initialization. * Unity - Added a prompt to update the FMOD folder metadata if necessary so that it can be moved to any location in the project. * Unity - Fixed a bug causing the Event Browser to be in an invalid state when reopening the Unity Editor. * Unity - Fixed a bug that caused stale cache assets to not be cleared correctly. * Unity - Fixed attenuation override values not updating until next GUI change when a new event is selected for an emitter. * Unity - Fixed a denied access error when updating FMOD for Unity integration. * Unity - Fixed the bank cache refresh failing when the event browser is open. * Unity - Android - Fixed command line builds not using split application binary. * Unity - Mac - Added a prompt to fix bad line endings in FMOD bundle Info.plist files if necessary (these could cause DllNotFoundException errors). * Unity - Fixed an error preventing command line builds from completing. * Unreal - Linux - Fixed missing libs. Notes: * GameCore - Now built with June 2021 QFE 2 GDKX. * PS4 - Now built with SDK 9.008.001. * PS5 - Now built with SDK 4.00.00.31. * Switch - Now built with SDK 12.3.7. * Unity - Removed obsolete x86 Linux binaries. * Unity - RuntimeManager's AnyBankLoading and WaitForAllLoads methods have been renamed for clarity (to AnySampleDataLoading and WaitForAllSampleLoading respectively), retaining the same functionality. The previous methods remain for compatibility but are considered deprecated. 08/09/21 2.02.03 - Studio API minor release (build 120077) ------------------------------------------------------------------------------------------ Features: * Core API - It is now possible to specify the Opus codec count via FMOD_ADVANCEDSETTINGS, previously it was hardcoded to 128. * Core API - PS5 - Added ACM convolution reverb support. * Core API - GameCore - Added XDSP convolution reverb support on Scarlett hardware. * Core API - Win, GameCore, XBoxOne - Added recording support to WinSonic. * Unity - Added EventReference.Find() to make setting default values on EventReference fields more convenient. * Unreal - UE4.26 on - Integration setup will now offer to add generated assets to package settings. * Unreal - UE4.26 on - Added Commandlet to support generating assets from command line. * Unity - Added IsInitialized property to EventManager to make it easier to know when EventManager is safe to call. Fixes: * Studio API - Fixed buffer overflow issues with command replays, system is now more robust against failure and buffers have grown to handle demand. * Studio API - Fixed issue where automating a labelled parameter under specific circumstances would produce an incorrect result. * Studio API - Fixed 7.1.4 sends losing their height speakers at the return. * Studio API - Fixed issue where event instruments inside a multi instrument were unable to be seemlessly looped with simple events. * Studio API - Streaming instruments no longer can have the end of the audio cut off if they take too long to load. * Studio API - Fixed volume spike at start of multi instruments using both fade curves and seek offsets. * Core API - Fixed issue with System::registerCodec returning FMOD_ERR_PLUGIN_VERSION regardless of FMOD_CODEC_DESCRIPTION apiversion. * Core API - Fixed convolution reverb crash if out of memory. * Core API - Fixed rare audio corruption / noise burst issue. * Core API - Fixed FSBankLib AT9 encoder failing with an internal error on newer versions of libatrac9.dll, 4.3.0.0 onward. * Core API - Fixed potential crash when up-mixing quad to 5.1. * Core API - GameCore - Reduced the chances of running out of Opus streams when playing back Opus compressed banks on Scarlett hardware. * Core API - Linux - Added support for automatic device switching. * Core API - Android - Fixed issue where AAudio would restart occasionally on certain devices. * Core API - Android - Fixed issue where AAudio would would request an amount of data far larger than its burst size on certain devices. * Unity - Fixed a bug where settings could be accessed while an asset database refresh was in progress, causing settings to be wiped. * Unity - Fixed live update breaking when domain reload is disabled. * Unity - Fixed an invalid handle error that would occur when an attached instance ends. * Unity - Fixed StudioParameterTrigger and StudioGlobalParameterTrigger not receiving Object Start and Object Destroy events. * Unity - Fixed the attenuation override values being overwritten when selecting multiple event emitters. * Unity - Fixed global parameter trigger browser showing other FMOD folders. * Unity - Fixed referenced events not being played when an event is previewed in the event browser if the referenced events are in a different bank. * Unity - Fixed RuntimeManager.MuteAllEvents not working in editor. * Unity - Fixed bank names including the .bank file extension when Load Banks is set to Specified. * Unity - Fixed a bug allowing multiple localized banks to be loaded and preventing them from being unloaded. * Unity - Fixed compatibility of native libraries changing after build. * Unity - Fixed stretched logo texture in setup wizard when targeting iOS as build platform. * Unity - Fixed an error caused by auditioning events with global parameters in the event browser. * Unity - Fixed an error state caused by inspecting a game object that contains both a Unity Image and an FMOD StudioEventEmitter. * Unity - Fixed staging instructions appearing for fresh integration installations. * Unity - Fixed an exception caused by disconnected prefab instances when updating event references. * Unreal - Fixed FMODAudioComponents continuing to play after actors have been destroyed. * Unreal - Fixed 'Reload Banks' menu option. * Unreal - Fixed error when building installed engine with FMOD plugin. Notes: * GameCore - Now built with June 2021 QFE 1 GDKX. * Stadia - Now built with SDK 1.62 * Unity - Removed a sleep loop in StudioEventEmitter.Start(). * Unreal - Added support for UE4.27. 26/07/21 2.02.02 - Studio API minor release (build 118084) ------------------------------------------------------------------------------------------ Features: * Core API - Mac - Added Dolby PLII downmix support. * Unity - When Event Linkage is set to Path, the EventReference property drawer and Event Reference Updater tool can now update paths for events which have been moved in FMOD Studio (detected via matching GUIDs). * Unity - Console logging from the plugin now follows the logging level specified for FMOD. * Unity - Improved the Asset Bundle import type to better support Addressables: FMOD now creates a stub asset for each source .bank file, which can be added to version control and to Addressables Groups. Stub assets are replaced with source .bank files at build time, and reverted to stubs after each build. Fixes: * Studio API - Fixed issue where silence instruments placed after a set parameter command instrument would be skipped. * Studio API - Fixed popping that would occur with fade curves and multi instruments in the right conditions. * Studio API - Fixed issue where automation and modulation would not evenly distribute values for discrete parameters. * Studio API - Fixed sustain point behavior where the sustain point is at the same time as the end of a loop region. * Studio API - Async instruments with infinite loop counts will play out their last loop after being untriggered. * Studio API - Scatterer instruments that have been untriggered will no longer fade out child instruments. * Studio API - Fixed issue where scatterer instruments would spawn instruments inconsistently. * Studio API - Fixed a stack overflow when releasing a very large number of events in a single frame. * Core API - Fixed FMOD::CREATESOUNDEXINFO::initialseekposition causing sound to not stop at the correct time. * Core API - Fixed disconnecting channel groups from ports when multiple instances of the same port are connected. * Core API - Fixed a possible crash by increasing the stack size of the file thread from 48k to 64k. * Core API - Fixed Object Spatializer getting out of sync with the mixer when the mixer buffer is starved, this could also cause asserts to appear the log. * Core API - GameCore - Fixed a race condition that could cause a hang when playing Opus compressed audio. * UE4 - Fixed default locale setting not working in cooked builds. * Unity - Fixed references in EventReferenceUpdater.cs to classes unavailable when the Unity Timeline package is missing. * Unity - Fixed event browser being unable to audition events when an encryption key is in use. * Unity - Fixed setup wizard not marking current scene as dirty when replacing Unity audio listeners. * Unity - Fixed banks failing to load on Mac when the project is saved in Unity on Windows. * Unity - Fixed a crash caused by disabling API error logging. * Unity - Fixed benign errors being logged to the console when API logging is enabled. * Unity - Fixed all banks being reimported whenever the banks are refreshed, even if nothing has changed. * Unity - Fixed an exception being thrown when building if version control is enabled. * FSBank - Fixed compatibility issue with Windows 7. * Profiler - Fixed compatibility issue with Windows 7. Notes: * HTML5 - Now built with SDK 2.0.20 (Upstream) and SDK 1.40.1 (Fastcomp). * iOS - Now built with iOS SDK 14.5 (Xcode 12.5.1). * Mac - Now built with macOS SDK 11.3 (Xcode 12.5.1), min deploy target is now 10.9 as mandated by Xcode. * Unity - Moved images into the Assets/Plugins/FMOD folder. * Unreal - Added support for UE5.0 (EA1). 26/05/21 2.02.01 - Studio API minor release (build 116648) ------------------------------------------------------------------------------------------ Features: * Studio API - Added FMOD_STUDIO_EVENT_CALLBACK_NESTED_TIMELINE_BEAT which returns a FMOD_STUDIO_TIMELINE_NESTED_BEAT_PROPERTIES containing the event's id. * Studio API - Added an FMOD_STUDIO_PARAMETER_LABELED flag. * Core API - Added loudness meter to the DSP API. The loudness meter is intended for development purposes and is not recommended to be included in shipped titles. * Unity - Improved the UI for setting values on discrete and labeled parameters. * Unity - Added FMODUnity.Settings.ForceLoggingBinaries to force FMOD to use the logging binaries even when BuildOptions.Development is not set. * Unity - Added the ability to set global parameters when auditioning an event. Fixes: * Studio API - Improved performance of repeated calls to Studio::EventDescription::isStream and Studio::EventDescription::isOneShot. * Studio API - Removed potential for performance hit from retrieving final volume and final pitch values due to thread contention. * Studio API - Fixed issue with audio device switching. * Studio API - Restrict maximum number of non-zero length transitions to 31 per update to prevent overloading the scheduler. * Core API - GameCore - Fixed error log (assert) with logging build when playing multichannel Opus. * Core API - GameCore - Fixed rare Opus failure / hang when playing streams. * Core API - GameCore - Fixed error log (assert) when seeking XMA streams near the file end. * Core API - Win/UWP/GameCore - Fixed WinSonic not falling back to no-sound automatically if no devices are available. * Core API - C# - Unblocked potential stalls when calling Studio::EventInstance::getVolume / Studio::EventInstance::getPitch when finalVolume / finalPitch isn't requested. * Unity - Fixed global parameters disappearing if banks are refreshed when the master bank hasn't changed. * Unity - Fixed the setup wizard's Updating page status being reset whenever scripts are recompiled. * Unity - Fixed errors that occur when Settings.OnEnable() is called on an object that is already initialized (e.g. "Cleaning up duplicate platform" and "An item with the same key has already been added"). * Unity - Reverted binary selection at build time to the old method of checking for BuildOptions.Development in BuildReport.summary.options, as checking for the DEVELOPMENT_BUILD symbol was failing in some situations and causing DllNotFoundExceptions. * Unity - Fixed bank sizes not being displayed in the event browser. * Unity - Fixed compiler errors that appear when Unity's Physics and Physics 2D packages are disabled. * Unity - Fixed "The name 'StaticPluginManager' does not exist" error when calling AddressableAssetSettings.BuildPlayerContent() on IL2CPP platforms. * Unity - Removed cleanup of RegisterStaticPlugins.cs when a build finishes, in order to avoid recompiling scripts unnecessarily. * Unity - Create the Assets/Plugins/FMOD/Cache folder if it does not exist when generating RegisterStaticPlugins.cs during a build. Notes: * Unity - Added type-specific icons for global parameters in the event browser. * Unity - Removed conditional code below Unity 2019.4 minimum specification. * PS4 - Now built with SDK 8.508. * PS5 - Now built with SDK 3.00.00.27. 15/04/21 2.02.00 - Studio API major release (build 115890) ------------------------------------------------------------------------------------------ Features: * Studio API - Event instances now have minimum and maximum distance properties that can be automated by parameters. These can be overridden by FMOD_STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE and FMOD_STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE. * Studio API - Added Studio::EventInstance::getMinMaxDistance. * Studio API - Added FMOD_STUDIO_PARAMETER_AUTOMATIC_DISTANCE_NORMALIZED. Converts the range min distance to max distance into the range 0 to 1, clamping values outside that range. * Studio API - Added a guid field to FMOD_STUDIO_PARAMETER_DESCRIPTION. * Studio API - Added Studio::System::getParameterLabelByID, Studio::System::getParameterLabelByName, Studio::System::setParameterByIDWithLabel, Studio::System::setParameterByNameWithLabel, Studio::EventDescription::getParameterLabelByName, Studio::EventDescription::getParameterLabelByID, Studio::EventDescription::getParameterLabelByIndex, Studio::EventInstance::setParameterByIDWithLabel, Studio::EventInstance::setParameterByNameWithLabel. * Studio API - Added Studio::Bus::getPortIndex and Studio::Bus::setPortIndex. * Core API - Added FMOD_DSP_PARAMETER_ATTENUATION_RANGE for spatializing DSPs to utilize Studio::EventInstance min and max distance. * Core API - Unified platform specific output port types FMOD_[PLATFORM]_PORT_TYPE and moved them to common FMOD_PORT_TYPE. Attempting to attach a channel group to an output port type which is not available on the platform will return an error. * Core API - UWP - Added support for Windows N versions. * Unity - In Events Browser the Global Parameters now show in folders. * FSBank - Added native Linux version of Gui and Command line application. * Profiler - Added native Linux version of the Core API profiler. * Linux - Added ARM 64 bit support. Fixes: * Studio API - Fixed behavior interaction between timelocked multi instruments and sustain points so that multi instruments will play from the same point that they were stopped via the sustain point. Notes: * Studio API - Studio::EventDescription::getMinimumDistance and Studio::EventDescription::getMaximumDistance replaced with Studio::EventDescription::getMinMaxDistance. * Studio API - Studio::EventInstance::setProperty on FMOD_STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE or FMOD_STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE does not affect spatializers with Override Range set. This is most noticeable with effect presets. * Studio API - Studio::System::getCPUUsage changed to take a struct FMOD_CPU_USAGE as 2nd parameter, also FMOD_STUDIO_CPU_USAGE removes core api values. Use FMOD_CPU_USAGE for that. * Studio API - Renamed Studio::EventInstance::triggerCue to Studio::EventInstance::keyOff and Studio::EventDescription::hasCue to Studio::EventDescription::hasSustainPoint. * Core API - FMOD_DSP_TYPE_PAN and FMOD_DSP_TYPE_OBJECTPAN have an override attenuation range property to use the min and max distance properties of the dsp and ignore the attenuation range of the event instance. Defaults to true for backwards compatibility. * Core API - FMOD::System_Create takes a headerversion argument to check the core api headers and libraries match. * Core API - System::getCPUUsage changed to take a struct FMOD_CPU_USAGE. * Core API - Incremented FMOD_OUTPUT_PLUGIN_VERSION for Output plugins. Dynamic library Output Plugins must be rebuilt. FMOD_OUTPUT_INIT_CALLBACK argument dspnumbuffers can now be modified and dspnumadditionalbuffers has been added. Additionally, FMOD_OUTPUT_METHOD_POLLING has been removed. * Core API - Incremented FMOD_CODEC_PLUGIN_VERSION for Codec plugins. Dynamic library Codec Plugins must be rebuilt. Codec API now exposes FMOD_CODEC_FILE_TELL_FUNC, FMOD_CODEC_ALLOC_FUNC, FMOD_CODEC_FREE_FUNC and FMOD_CODEC_LOG_FUNC functions. Additionally, FMOD_CODEC_FILE_SEEK_FUNC accepts a FMOD_CODEC_SEEK_METHOD. * Core API - Changed FMOD_THREAD_AFFINITY from unsigned 64-bit integer to signed 64-bit integer, reducing the maximum supported number of cores by one. * Core API - UWP - FMOD MediaFoundation Codec is now included as a separate dll. * FSBank API - Removed deprecated FSBANK_FORMAT_PCM_BIGENDIAN and FSBANK_FORMAT_AT9_PSVITA, and renamed FSBANK_FORMAT_AT9_PS4 to FSBANK_FORMAT_AT9. * Resonance - Replaced min and max distance with FMOD_DSP_PARAMETER_ATTENUATION_RANGE. If previous behavior is required, FMOD 2.2 is compatible with resonance audio included with 2.1. * Android - Minimum API version raised to 16 for 32 bit. * Linux - Now built with LLVM/Clang 10. * Linux - ARM - the minimum supported architecture has been lifted to armv7 with NEON support. * PS5 - Renamed platform specific APIs and headers from codename to official name. * Unity - The [EventRef] attribute has been replaced with the EventReference type. This change requires migration; use the FMOD/Update Event References menu command to assist you with the migration process. * Unity - The minimum version of Unity supported is now 2019.4 12/02/21 2.01.09 - Studio API minor release ------------------------------------------------------------------------------------------ Features: * Studio API - Added FMOD_STUDIO_SYSTEM_CALLBACK_LIVEUPDATE_CONNECTED and FMOD_STUDIO_SYSTEM_CALLBACK_LIVEUPDATE_DISCONNECTED. * Studio API - Added Studio::EventDescription::isDopplerEnabled. Will return false with banks built prior to 2.01.09. * Unity - Added a Volume property to FMOD Event Tracks. * Unity - Improved plugin lib updates by automating the process in a few simple steps. * Unity - Added 7.1.4 speaker mode to Project Platform in the settings menu. * Unity - Added support for generating unit options for Unity 2021 Visual Scripting package. * Unity - Added option to enable error reporting to Unity console from internal FMOD system. * Unity - Added a Setup Wizard to help with adding FMOD to projects. Fixes: * Studio API - Fixed possible memory corruption due to race condition between user code creating sounds asynchronously using sound info from an audio table and unloading the bank containing the audio table. * Studio API - Improved error detection and documentation regarding the requirement of loading asset banks at the same time as metadata banks. * Studio API - Fixed issue where stopping conditions on nested events without ahdsr modulators would not play out when the parent event is still playing and the nested event becomes untriggered. * Studio API - Fixed issue where hot swapping an event via live update would invalidate the API handle. * Studio API - Fixed incorrect count from Studio::Bank::getEventCount when loading banks built with 1.07, 1.08 or 1.09. * Core API - Fixed substantial performance issue when connected to a profiler. * Core API - Fixed sync points potentially being skipped as Channels transition from virtual to real. * Core API - Fixed warning being logged about truncated files on user created sounds. * Core API - Fixed hang on .S3M format playback when seeking past calculated end of song with FMOD_ACCURATETIME. * Core API - Fixed some netstreams return FMOD_ERR_HTTP. Introduced 2.01.02. * Core API - Fixed potential audio corruption when using the object spatializer. * Core API - Fixed System::getPluginHandle returning internal only DSPs. * Core API - Fixed crash with Convolution Reverb. Introduced 2.01.08. * Core API - Fixed early and late delay support for FMOD_DSP_TYPE_SFXREVERB. Introduced 2.01.04. * UE4 - Add a configurable delay to automatic bank reloading to avoid a race condition between banks being rebuilt in Studio and the integration trying to reload them. * UE4 - Remove unsupported log levels from settings. * UE4 - Fixed blueprint AnimNotify causing Editor to crash. * UE4 - 4.26 - Fixed asset generation regenerating assets when banks have not been modified. * UE4 - 4.26 - Fixed crashes caused by attempting to regenerate assets which are read-only on disk. User is now prompted to check-out or make writable assets which are read-only on disk. * UE4 - 4.26 - Fixed sequencer integration. * UE4 - 4.26 - Fixed AnimNotify not automatically loading referenced event asset. * UE4 - 4.26 - Fixed FindEventByName failing to load required event asset. * UE4 - 4.26 - Fixed crash when running with sound disabled (eg. running as A dedicated server or running with the "-nosound" command line option). * UE4 - iOS/tvOS - Fixed audio occasionally not returning on application resume. * UE4 - XboxOne - Fixed third party plugins not working. * Unity - Made binary selection at build time more robust by checking for DEVELOPMENT_BUILD in the active script compilation defines. * Unity - Fixed context menu entries being disabled on FMOD Event Playable parameter automation. * Unity - Fixed a hang that could occur when scripts were recompiled after a callback was fired from FMOD to managed code. * Unity - Fixed banks not loading on Mac if project was saved from PC to source control. * Unity - Fixed a number of build errors on various platforms caused by the static plugin system's use of the IL2CPP --additional-cpp command (the static plugin system now generates C# instead of C++). * Unity - PS5 - Removed unsupported Audio 3D option from the platform settings. * Unity - UWP - Fixed warnings and errors surrounding Marshal usage depending on Unity version, scripting backend and API compatibility combination. Notes: * GameCore - Updated to February 2021 GDK. * UE4 - Changed default source directory for runtime bank files to Content/FMOD/Desktop. Platform specific INI files should be used to override this as appropriate. 11/02/21 2.01.08 - Studio API minor release (build 114355) ------------------------------------------------------------------------------------------ Features: * Core API - Added FMOD_SYSTEM_CALLBACK_OUTPUTUNDERRUN, which is called when a buffered mixer output device attempts to read more samples than are available in the output buffer. * Core API - Mac - Added Resonance Audio Apple Silicon support. * Unity - Improved bank refresh logic and added a status window that appears when a refresh is about to happen. * Unity - Added support for automating event parameters on the Timeline. Fixes: * Studio API - Fixed fast spawning scatterer instruments with low polyphony spawning too few instruments. * Studio API - Fixed a memory leak that could occur when a sound got stuck in the loading state. * Core API - Fixed crash on .XM format playback. * Core API - Fixed potential hang with net streams if server returns errors. * Core API - Fixed extraneous logging of internal pool allocations. * Core API - Fixed rare crash when releasing convolution reverb DSP instances. * Core API - UWP - Fixed logging spam when using WASAPI output mode. * UE4 - Expose the Enable Timeline Callbacks property of FMOD Audio Component to blueprints. * UE4 - Fixed crash which could occur when an FMOD Audio Component which uses a programmer sound is destroyed by unloading the map or closing the game. * Unity - Fixed Discrete and Labelled global parameters that do not appear in the Event Browser. * Unity - Fix multiple listeners positioning not working correctly. * Unity - Fixed sample data failing to load when Load Bank Sample Data is enabled in a project with separate asset banks. * Unity - Fixed an Android build error when the Export Project option is set. * Unity - Fixed FMOD IL2CPP arguments being left in ProjectSettings after building, which could break builds on other operating systems. * Unity - Android - Fixed an IL2CPP build error on some NDK versions. * Unity - PS5 - Fixed compile error due to stale platform API CS file. * Unity - iOS/tvOS - Fixed audio occasionally not returning on application resume. Notes: * Switch - Now built with SDK 11.4.0. * UE4 - Added support for UE4.26. 18/12/20 2.01.07 - Studio API minor release (build 113487) ------------------------------------------------------------------------------------------ Features: * Core API - Added FMOD_SYSTEM_CALLBACK_DEVICEREINITIALIZE. * Core API - Mac - Added Apple Silicon support. * Unity - Added support for generating unit options for Bolt visual scripting. * Unity - Added option to stop an emitter's event instance when the emitter is further than its maximum attenuation distance from all listeners. Fixes: * Studio API - Command replays now record the initial state of global parameters. * Studio API - Fixed errors from instrument creation failure not being reported to the error callback. * Studio API - Fixed crash due to null pointer dereference when instrument creation fails due to running out of memory. * Studio API - Fixed crash when unloading a bank from the FMOD_STUDIO_EVENT_CALLBACK_STOPPED callback. * Studio API - Fixed crash when hot swapping a nested event and its parent where the child event is registered before the parent event. * Studio API - Fixed spurious warning messages when connecting Live Update. * Studio API - Fixed crash which could occur if a user thread loads a bank asynchronously while another thread releases the system. * Studio API - Switch log messages about missing plugins from warning to log level when the system is initialized with FMOD_STUDIO_INIT_ALLOW_MISSING_PLUGINS. * Core API - Fixed rare crash due to race condition when calling Sound::getOpenState for a sound created with FMOD_NONBLOCKING. * Core API - Fixed rare crash occurring some time after calling System::attachChannelGroupToPort due to internal buffer synchronization. * Core API - Fixed certain internet radio stations that serve up playlists failing to load correctly. * Core API - Fixed sidechain modulator release being cutoff if sidechain source is destroyed. * Core API - Linux - Fixed hang in shutdown when using ALSA as the output mode when ALSA is unable to write to the output buffer. * Core API - Android - Reduced AAudio fail to stop error message to a warning. * Core API - UWP - Fixed issue preventing loading of 32 bit x86 plugins. * UE4 - Fixed spurious warning messages when loading banks which use plugins. * UE4 - Fixed listener being stuck at world origin when using a standalone game from the editor (introduced in 2.00.12). * UE4 - XboxOne - Fixed users having to modify engine code to copy libs. * Unity - Android - Fixed Mobile Low and Mobile High platforms using the wrong bank path when on Android. * Unity - Prebuild debug warning added for invalid FMOD Event paths. * Unity - Fixed banks not being copied into the project when using Asset Bundles. * Unity - Fixed specified bank paths for multi platform builds. Notes: * Core API - Changed THREAD_AFFINITY enum in C# wrapper from unsigned 64-bit integer to signed 64-bit integer, reducing the maximum supported number of cores by one. * GameCore - Updated to August 2020 QFE 5 GDK. * XboxOne - Now built with July 2018 QFE15 XDK. * PS4 - Resonance Audio now built with SDK 8.008. * PS5 - Resonance Audio now built with SDK 2.00.00.09. * iOS - Now built with iOS SDK 14.2 (Xcode 12.2), min deploy target for iOS is now 9.0 as mandated by Xcode. * Mac - Now built with macOS SDK 11.0 (Xcode 12.2). * Stadia - Now built with SDK 1.55. * Unity - Moved Timeline and Resonance Audio classes from global namespace into FMOD namespaces. 13/11/20 2.01.06 - Studio API minor release (build 112764) ------------------------------------------------------------------------------------------ Features: * Core API - Added FMOD_SYSTEM_CALLBACK_BUFFEREDNOMIX. * Core API - PS5 - Added support for microphone recording. * Unity - Added support for Addressables. * Unity - In Events Browser the banks folders now show when mirroring is disabled. * Unity - Setting Live Update port per-platform is now supported. * Unity - FMOD now automatically selects the release or logging version of the native libraries at build time, based on the Development Build setting. Fixes: * Studio API - Fixed issue where tempo based scatterer would play slightly off beat. * Core API - Improved error message when binding to a port fails due to a permission error. * Core API - Android - Fixed issue where audio would disconnect while debugging. * UE4 - Fixed deprecation warning in FMODStudioEditorModule. * Unity - Fixed FMOD_ERR_MEMORY caused by leaking System objects on play-in-editor script reload. * Unity - Fixed volume value in debug window. * Unity - Prebuild debug warning added for invalid FMOD Event paths. * Unity - HTML5 - Fixed error when building for development. * Unity - Switch - Fixed a build error due to fmodplugins.cpp not being enabled. Notes: * Core API - Renamed FMOD_CODEC_METADATA_CALLBACK to FMOD_CODEC_METADATA_FUNC to better reflect its purpose. * Core API - Sound::getFormat now returns FMOD_SOUND_FORMAT_BITSTREAM if FMOD_CREATECOMPRESSEDSAMPLE is used with System::createSound. * GameCore - Updated to August 2020 QFE 4 GDK. * PS4 - Now built with SDK 8.008. * PS5 - Now built with SDK 2.00.00.09. 09/10/20 2.01.05 - Studio API minor release (build 112138) ------------------------------------------------------------------------------------------ Features: * Core API - XboxOne and Switch - Added ResonanceAudio plugin support. * Core API - GameCore - Added FMOD_GameCore_SetXApuStreamCount to control reserved XApu resources. * Unity - Edit Settings now allows FMOD output mode to be set per-platform. * Unity - Added support for specifying static plugins in the FMOD Settings. * Unity - Added support for setting a per-platform callback handler to run custom configuration code prior to initialization. * Unity - Added settings to customize DSP buffer length and count per-platform. * Unity - Added metering channel order setting. * Unity - Assembly Definition files added to the FMOD plugin. * Unity - The FMOD scripts will now compile without the unity.timeline package installed. If you wish to use Timeline you will need to install this package for Unity 2019.1 and above. * Unity - GameCore - Add resonance audio support. * Unity - iOS - Added simulator support. * Unity - PS5 - Add resonance audio support. * GameCore - Added support for decoding Opus compressed FSBs / Banks using platform hardware acceleration on Scarlett devices. This is a preview release of this feature, please report any bugs found directly to FMOD support email. Fixes: * Studio API - Live update socket errors are now handled gracefully, only warnings are logged. * Studio API - Fix marker callbacks for multiply nested events. * Studio API - Fixed Studio::EventDescription::is3D, Studio::EventDescription::isOneShot and Studio::EventDescription::isNested potentially returning an error when the event contains a nested reference to an event which has not been loaded. * Core API - Fixed crash in convolution reverb if out of memory. * Core API - Fixed rare crash when updating net stream metadata tags. * Core API - Android - Reduce popping encountered on certain handsets by dynamically adjusting latency. * Core API - Android - Fix issue where regular gaps in audio were encountered on handsets with using very large burst sizes. * Core API - Android - Fix issue where System::mixerSuspend would fail on certain handsets. * Core API - Mac - Fixed init returning an error when no output devices available. * Core API - Win - Fixed crash on Win7/8 devices with high end CPUs that support AVX-512. * Core API - Fix convolution crash if a small impulse was used followed by a large impulse. Introduced in 2.01.04. * Core API - HTML5 - Fix missing implementation of Sound::getSyncPoint/getSyncPointInfo/ addSyncPoint/deleteSyncPoint. * UE4 - Fixed potential null pointer dereference when updating FMOD listeners for play-in-editor session. * UE4 - PS5 - Disabled UE4 built-in audio to prevent crash at startup. * Unity - Fixed rare TimeZoneNotFoundException encountered on some devices. * Unity - Fixed play-in-editor not using new speaker mode when changed in settings. * Unity - HTML5 - Fix FMOD_ERR_UNSUPPORTED error being returned from bank loading. Introduced in 2.01.04. Notes: * Studio API - Issues with reconnecting Live Update (primarily on mobile) have been resolved in FMOD Studio. Update to FMOD Studio 2.01.05 or higher. * GameCore - To produce Opus banks in FMOD Studio, add the new "Custom" platform to your project and select Opus as the encoding. * GameCore - Updated to June 2020 QFE 6 GDK. 10/09/20 2.01.04 - Studio API minor release (build 111454) ------------------------------------------------------------------------------------------ Features: * Studio API - Added a flag for discrete parameters to FMOD_STUDIO_PARAMETER_FLAGS * Core API - Convolution reverb optimizations. Now multithreaded to avoid spikes in mixer performance. Significant memory optimization with multiple instances. * Core API - Android - Added support for swapping output modes. * Core API - GameCore - Added FMOD_GAMECORE_PORT_TYPE_COPYRIGHT_MUSIC output port type. * Unity - Added OnEnabled and OnDisabled for StudioBankLoader. * Unity - Added attachedRigidbody to OnTriggerEnter and OnTriggerExit for EventHandler. * Unity - Updated the event browser for better performance and more consistent look and feel. Fixes: * Core API - Android - Fixed recording support when using AAudio. * Core API - Android - Fixed issues with headphone detection with AAudio. * Core API - XboxOne - Fixed getOutputHandle not returning the IAudioClient on WASAPI. * UE4 - When running multiplayer PIE sessions a listener is added for each player in each viewport. * UE4 - Improved handling of FMOD Studio objects being renamed or removed when reloading banks. Previously it would appear that references to renamed objects were correctly handled when they were not; references in UE4 must be manually fixed up when FMOD Studio names are changed. * UE4 - Improved handling of unsupported characters in FMOD Studio object names. * Unity - Made the Studio Event Emitter initial parameter value UI handle prefab instances and multi-selections properly. * Unity - Fixed tooltips not working for EventRef. * Unity - Fixed bank loading on Android with split/non-split APKs. * Unity - Fixed plugin paths for Windows and Linux. Notes: * Core API - GameCore - FMOD_GAMECORE_PORT_TYPE_MUSIC is no longer ignored by GameDVR. Use FMOD_GAMECORE_PORT_TYPE_COPYRIGHT_MUSIC for background music which should not be captured by GameDVR. * Stadia - Now built with SDK 1.50. * Android - Examples now include CMake based projects alongside the NdkBuild based projects. * GameCore - Updated to June 2020 QFE 4 GDK. 05/08/20 2.01.03 - Studio API minor release (build 110858) ------------------------------------------------------------------------------------------ Features: * Core API - Added System::getDSPInfoByType. * Core API - GameCore - Added support for microphone recording. Fixes: * Studio API - Fixed named marker callbacks for nested events. * Studio API - Fixed issue with accumulating event instruments spawned by a scatterer. * Studio API - Fixed issue where an event instance handle would incorrectly remain valid. * Studio API - Improved detection of user code incorrectly using a dangling pointer from a previously destroyed Studio System object. * Studio API - Improve panner envelopment when source is above or below the listener. * Studio API - Fixed FMOD_STUDIO_PARAMETER_DESCRIPTION::maximum being 1 higher than the maximum value which could be set. * Studio API - Fixed discrete parameters with non-zero seek speed or velocity changing value too quickly after having their value set by an API call. * Studio API - Fixed stopping conditions for nested events. * Core API - Ignore data and fmt sections of a wave file that are contained in lists. * Core API - iOS - Fixed stale audio from before System::mixerSuspend playing after calling System::mixerResume. * Core API - iOS - FMOD initializes with FMOD_OUTPUTTYPE_NOSOUND if unable to initialize due AVAudioSessionErrorCodeCannotStartPlaying. Switching to FMOD_OUTPUTTYPE_COREAUDIO via System::setOutput is also supported. * Core API - Mac - Fixed automatic default device switching. * Core API - Win - Improved handling of IPv6 net-streams. * Core API - Fixed FMOD_DSP_STATE_DFT_FUNCTIONS::inversefftreal function possibly causing corrupted audio if it and FMOD_DSP_STATE_DFT_FUNCTIONS::fftreal were called from different threads. * UE4 - Android - Fixed issue which could cause Android packaged builds to crash at startup. * Unity - Fix crash in HasBankLoaded if RuntimeManager isn't initialized. Notes: * Unity - Added GameCore platform. * Switch - Now built with SDK 10.4.1. * GameCore - Updated to June 2020 QFE 1 GDK. 01/07/20 2.01.02 - Studio API minor release (build 110199) ------------------------------------------------------------------------------------------ Features: * Core API - GameCore - Added XMA support for Scarlett. * Core API - GameCore - Added background music port support. * Core API - PS5 - Added support for all platform specific ports, including background music, controller speaker and vibration. * Unity - Added field for specifying a sub directory for Banks in the settings. Fixes: * Studio API - Fixed an issue with events referencing missing parameter descriptions when parameters were unused for a platform. For old banks references to missing parameter descriptions are stripped out of the event at load time. Newer banks will always include all parameter descriptions to ensure consistency across platforms. * Studio API - Fixed assert that would occur when setting a parameter that in turn creates an entity that also is listening for that parameter to change. * Studio API - Fixed doppler calculation to use listener attenuation position. * Studio API - Fixed memory leak caused by creating a bus with missing bank data. * Studio API - Improved performance of repeated calls to Studio::EventDescription::is3D. * Studio API - HTML5 - Fixed loadBankMemory not allowing a UInt8 memory object type to be passed to it. * Core API - Fixed silence from ports when switching from no-sound back to a valid output mode with ports. * Core API - Fixed incorrect return of FMOD_ERR_DSP_RESERVED on ChannelGroups caused by internal race condition. * Core API - Fixed FMOD_LOOP_NORMAL flag not working with netstreams that have "Accept-Ranges: bytes header". * Core API - iOS - Fixed conflicting ogg vorbis symbols if linking FMOD against a project containing vorbis already. * Core API - Android - Fixed detection of headphones being plugged and unplugged via the headphone jack on some devices. * Core API - GameCore - Thread names will now show up in PIX. * Core API - PS5 - Fixed crash when looping AT9 playback, no change required, fixed by SDK 1.00. * Core API - PS5 - Fixed AT9 decode failure when seeking near the end of the file. * Core API - Stadia - Fixed crash on playback of Vorbis compressed audio. * Unity - Fixed "ERR_INVALID_HANDLE" errors in UWP builds. * Unity - Changed banks to only be copied into the project when building. Notes: * PS4 - Resonance Audio now built with SDK 7.508. * PS5 - Updated to SDK 1.00.00.39. * UE4 - Added GameCore platform. * UE4 - Added support for UE4.25. * UE4 - Added PS5 platform. 12/05/20 2.01.01 - Studio API minor release (build 109257) ------------------------------------------------------------------------------------------ Features: * Core API - Stadia - Added microphone recording support. * Unity - Added support for separate listener attenuation position. Fixes: * Studio API - Fixed issue where an instrument not on the timeline would fail to be untriggered while the timeline is inside a source transition region. * Studio API - Improve loudness meter performance. * Studio API - Fixed crash that occurs with instrument hotswaps that change the instrument and its position on the timeline while auditioning. * Studio API - Fixed issue where scatterer instrument would spawn streaming instruments that would exceed the polyphony limit. * Studio API - Fixed issue where the Studio update thread could hang trying to release an event instance where the instance being released used a streaming programmer sound which was reused by another instance and the second instance was still active. * Studio API - Fixed scheduling behavior of events inside multi instruments so that the event will play out async instruments, ahdsr modulators and adjust to pitch modulation before playing the next item in the multi instrument. It will still play before DSP tails. * Core API - Fixed potential crash in the mixer or stream thread when playing MIDI / MOD style files due to race condition. * Core API - Android - Fixed potential crash when opening a file using the Android asset syntax file:///android_asset/. * Core API - PS5 - Fixed error being returned from platform specific affinity API. * UE4 - Fixed possible crash during module shutdown if DLLs aren't loaded correctly. * UE4 - Fixed Android builds crashing at startup. * Unity - Linux - Fixed FMOD_ERR_HEADERMISMATCH error due to conflict between FMOD Studio and FMOD Ex (built into Unity) in 2019.3. * Unity - Fixed settings bank path using wrong directory separators. * Resonance - Fixed rare crash in Resonance Audio due to thread safety issue. Notes: * GameCore - Updated to April 2020 GDK. * Stadia - Now built with SDK 1.46. * PS4 Now built with SDK 7.508. * XboxOne - Now built with July 2018 QFE13 XDK. * HTML5 - Now built with SDK 1.39.11, both fastcomp and upstream. * Unity - Added PS5 platform. 23/03/20 2.01.00 - Studio API major release (build 108403) ------------------------------------------------------------------------------------------ Features: * Studio API - Studio::System::setListenerAttributes now supports a separate position argument for attenuation. * Core API - Optimized mixing and vorbis decoding. Performance increase of 2-2.5x on all platforms. * Core API - Optimized Multiband EQ. Performance increase of 2-3x on all platforms for stereo and higher channel count processing. * Core API - Added cross-platform API for setting thread affinity, stack size and priority via FMOD_Thread_SetAttributes. * Core API - Win - FMOD_OUTPUT_DEVICELISTCHANGED_CALLBACK now responds to default device changes. Fixes: * Studio API - Fixed issue where async instruments on a transition timeline with fade out curves would snap to full volume when exiting the transition timeline. * Studio API - The end of destination and magnet regions are included as part of the timeline length. * Studio API - Changed behaviour of stopped async multi-instrument entries with unlimited loop counts to not play. * Studio API - Loop regions of lower priority that coincide with transitions are now followed during the transition's source timeline. * Core API - Fixed potential crash when calling Sound::getSubSound on a playing stream, this is now prohibited and will instead return an error. * Unity - Fixed compatibility issues with C# wrapper. FMOD objects are now passed as IntPtr for callback arguments from native to C#. Use the constructor of the correct type to recreate the object from the IntPtr. Notes: * Core API - Calling Sound::getSubSound from FMOD_CREATESOUNDEXINFO::nonblockcallback is no longer a synchronous operation meaning an additional callback will execute when fetching the subsound has completed. * Core API - Removed stackSizeStream, stackSizeNonBlocking and stackSizeMixer from FMOD_ADVANCEDSETTINGS. These are now set via FMOD_Thread_SetAttributes. * Core API - Removed deprecated FMOD_ADVANCEDSETTINGS::commandQueueSize member. * Core API - Removed all platform specific thread affinity APIs, affinity is now controlled via FMOD_Thread_SetAttributes. * Core API - Renamed FMOD_OUTPUT_DESCRIPTION::polling to FMOD_OUTPUT_DESCRIPTION::method. * Core API - When calling FMOD_Memory_Initialize with valid 'useralloc' and 'userfree' callbacks, the requirement of 'userrealloc' is now optional. * Core API - DSP Echo delay effect minimum reduced to 1 millisecond. * FSBank - Minimum requirement for Mac version of the FSBank tool has been lifted to macOS 10.12 due to framework update. * Profiler - Minimum requirement for Mac version of the Profiler tool has been lifted to macOS 10.12 due to framework update. 02/03/20 2.00.08 - Studio API minor release (build 108014) ------------------------------------------------------------------------------------------ Features: * Studio API - Added FMOD_STUDIO_EVENT_PROPERTY_COOLDOWN to set per instance cooldown. * Studio API - Added Studio::getMemoryUsage, Bus::getMemoryUsage, Studio::EventInstance::getMemoryUsage and FMOD_STUDIO_MEMORY_USAGE for retrieving memory usage statistics in logging builds. Fixes: * Studio API - Fixed issue with determining the end of an event inside a multi instrument. * Studio API - Fixed issue with determining the end of an async instrument with pitch automation. * Studio API - Fixed potential crash when playing a command replay from a 64bit game on a 32bit host. * Studio API - Fixed issue where polyphony limits on an event and bus could both apply causing too many event instances to be stolen when starting a new event instance. * Studio API - Fixed issue where Studio update thread could get stuck in an infinite loop and eventually deadlock with the game thread when a sound object used for a programmer sound was used by more than one event instance. * Studio API - Fixed issue where transitioning from the start of a transition region to a destination marker using a relative transition with a tempo marker would result in the event stopping. * Studio API - HTML5 - Fixed missing plugin errors for banks using loudness meter, convolution reverb or pitch shifter. These effects can be CPU intensive so use them with caution. * Core API - Fixed seeking accuracy of mp3 files that use small mpeg frame sizes. * Core API - Fixed ChannelGroup::isPlaying from returning false on a parent ChannelGroup, when children groups in certain configurations had playing sounds. * Core API - iOS - Fixed issue causing MP3 netstreams to not work. * Core API - iOS - Fixed issue where FMOD_CREATECOMPRESSEDSAMPLE would not work as expected with MP3 files. * UE4 - Fixed crash in 4.24 caused by SetActive call in FMODAudioComponent. * UE4 - Fixed warning log message when using the IsBankLoaded blueprint function when the bank is not loaded. * Unity - TextAsset banks import directory now defaults to 'FMODBanks' instead of the root 'Assets' folder. * Unity - HTML5 - Fixed compilation issue preventing launch. Notes: * XboxOne - Now built with July 2018 QFE12 XDK. * PS4 - Resonance Audio now built with SDK 7.008. * HTML5 - JavaScript bindings are now separate from the main bitcode binary to facilitate recompilation of ASM.JS / WASM or usage in strictly native projects. 17/01/20 2.00.07 - Studio API minor release (build 107206) ------------------------------------------------------------------------------------------ Features: * Unity - Changing bank import type now gives you the option of removing the previously imported banks. * UE4 - Added getParameter functions for getting user and final values. Fixes: * Studio API - Fixed application of fade curves to instruments when transitioning immediately between transition timelines. * Studio API - Fixed Studio::EventDescription::is3D to return true for events with scatterer instruments, for 3D instruments inside multi instruments, and for spatializers on non-master tracks. * Studio API - Fixed relative transition calculation when performing a transition jump that would incorrectly end up at the beginning instead of the end of the destination or vice versa. * Studio API - Fixed issue when encountering a loop region in a destination timeline which would stop the event in specific circumstances. * Studio API - Fixed crash when profiling runtime with an older Studio tool version. * Core API - Fixed asserts from setting readonly DSP data parameters when the setter isn't implemented. * Core API - Fixed FSBankLib Vorbis encoder not supporting quality zero as default. * Core API - Fixed System::setDriver not always applying if called after System::setOutput when the device list has changed. * Core API - Fixed DSP_PARAMETER_DESC being populated with incorrect data in C#. * Core API - Fixed MP3 codec not respecting FMOD_ACCURATETIME flag when played as FMOD_CREATECOMPRESSEDSAMPLE. * UE4 - Fixed EncryptionKey not being saved to packaged game. Bank encryption keys in existing projects will need to be re-entered after upgrading. * UE4 - XBoxOne - Fixed third party plugin path. * UE4 - Fixed FMODEvent::GetParameterDescriptions not working in built game. * Unity - Fix lag in editor due to banks being reimported. * Unity - Fixed FMODStudioCache causing deserialization exceptions by moving the file to a separate cache folder. Notes: * PS4 - Now built with SDK 7.008.031. * Stadia - Now built with SDK 1.38. * Switch - Now built with SDK 9.3.0. * HTML5 - Now built with sdk-1.38.19-64bit * UE4 - Added support for UE4.24. * UE4 - Added support for Stadia. * OSX - Updated Resonance Audio plugin with performance improvements. 20/11/19 2.00.06 - Studio API minor release (build 106220) ------------------------------------------------------------------------------------------ Fixes: * Studio API - Fixed issue where a loop on an instrument followed immediately by a transition timeline could result in a short pause in playback. * Core API - Mac - Fix crash calling recordStart at the same time as unplugging a USB microphone. * Core API - Android - minimum Android version for AAudio support changed to 8.1 (API 27) to circumvent AAudio RefBase crash issue. * Core API - XboxOne - Fixed background music port going silent if XAudio is initialized outside of FMOD. * Core API - Stadia - Fixed crash at static initialization time when using the logging build on system software v1.37 and newer. * FSBank API - Win - Fixed bug introduced in 2.00.05 which prevented banks being built when passing a non-empty encryption key to FSBank_Build. * UE4 - Fixed asset loading errors on dedicated server. * Unity - Fixed integration deleting non FMOD bank/bytes files when refreshing. * Unity - Fixed handling of iOS AudioSession interruption notifications. Notes: * iOS - Now built with iOS SDK 13.1 and tvOS SDK 13.0 (Xcode 11.1). * Mac - Now built with macOS SDK 10.15 (Xcode 11.1). 09/10/19 2.00.05 - Studio API minor release (build 105402) ------------------------------------------------------------------------------------------ Features: * Studio API - Add event and bus instance CPU profiling to the FMOD Studio API. * Core API - Stadia - Added voice output port FMOD_STADIA_PORT_TYPE_VOICE. Fixes: * Studio API - Fixed crash caused by creating an instance of an event containing a nested event which has not been loaded. * Studio API - Fixed pitch changes on a bus propagating across sidechain connections. * Studio API - Fixed application of transition fade curves to parameter triggered instruments on multi track events. * Core API - Fixed mixer falling silent due to very small but not denormal positions being passed into the API. * Core API - Fixed crash when processing loops of FMOD_DSPCONNECTION_TYPE_SEND or FMOD_DSPCONNECTION_TYPE_SEND_SIDECHAIN. * Unity - Removed high frequency of UnityEditor.SetDirty calls. * Unity - Fixed issues with using relative paths in linked project/bank directory. Notes: * Switch - Now built with SDK 8.3.0. * XboxOne - Now built with July 2018 QFE9 XDK. 06/09/19 2.00.04 - Studio API minor release (build 104705) ------------------------------------------------------------------------------------------ Features: * Official support for Stadia as a separate platform is now complete, anyone using the Linux version should migrate across. Fixes: * Studio API - Fixed issue where programmer sound without an associated sound would have unexpected behavior when modulated. * Studio API - Fixed issue where instruments with low polyphony would incorrectly fail to play. * Studio API - Fixed looping multi-instrument with streaming instruments cutting off near the end of the loop when the length of the multi-instrument is slightly longer than a multiple of the instrument length. * Studio API - Fixed issue where automation points are reused in transition timelines when both the timelines and the transition have no automation points. * Core API - Fixed crash caused by unlinking a convolution reverb dsp during a mix. * Core API - Fixed potential alignment crash on ARM devices if using FMOD_DSP_PAN. * Core API - Fixed leak of socket handles when binding to a listening port fails. * Core API - Win / UWP / XboxOne - Fixed incorrect DSP CPU reporting when using FMOD_OUTPUTTYPE_WINSONIC. * UE4 - Fixed crash in PlayEventAtLocation when world context is invalid. * UE4 - Fixed failed to load errors when playing in Standalone. * UE4 - Switch to using "Additional non-asset directories to copy" packaging setting for FMOD banks to avoid possible deadlocks at runtime. * Unity - Fixed banks being copied to project repeatedly when using AssetBundles. * Unity - Fixed Events not auditioning from split banks. * Unity - Fixed RuntimeManager being able to update the 3DAttributes for an Event Instance multiple times using different values. 02/08/19 2.00.03 - Studio API minor release (build 103912) ------------------------------------------------------------------------------------------ Features: * Core API - Improved ASIO channel mapping via FMOD_ADVANCEDSETTINGS::ASIOSpeakerList. Skips irrelevant speakers with FMOD_SPEAKER_NONE and supports devices up to 32 channels without using FMOD_SPEAKERMODE_RAW. * Core API - Android - Added support for AAudio via FMOD_OUTPUTTYPE_AAUDIO. * Core API - PS4 - Added ResonanceAudio plugin for PS4. * Core API - Android - Added support for setting thread affinity via FMOD_Android_SetThreadAffinity. * UE4 - Added blueprint node for Studio::EventInstance::release. * Unity - Added setParameter by name wrapper function to StudioEventEmitter.Features: * Unity - Fixed crash when setting logging level to LOG and entering playback. Fixes: * Core API - Fixed rare crash on Studio::System::release. * UE4 - Fixed FMODAudioComponent not being occluded are being stopped and restarted. * Unity - Fixed project determinism issue causing paths to update when opening the project on Windows and Mac. * HTML5 - FMOD Studio examples updated with 2.0 API changes. Notes: * Switch - Now built with SDK 8.2.0. * XboxOne - Now built with July 2018 QFE7 XDK. 18/06/19 2.00.02 - Studio API minor release (build 102879) ------------------------------------------------------------------------------------------ Features: * Core API - C# - Added getters to DSP_PARAMETER_FFT that will fill a user provided buffer, to avoid garbage collection. * Studio API - FMOD_STUDIO_EVENT_CALLBACK_SOUND_PLAYED, FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_MARKER, and FMOD_STUDIO_EVENT_CALLBACK_SOUND_STOPPED callbacks are now called from nested events. * UE4 - Added support for tvOS. * Unity - StudioEventEmitter and EventRef now support the use of GUIDs or paths. * Unity - StudioListener components will be assigned an index from the RuntimeManager at runtime, rather than user specified. Fixes: * Core API - Win 64bit - Skip JACK ASIO driver when enumerating ASIO devices. An unrecoverable crash occurs in the driver when attempting to query its capabilities. * UE4 - Fixed "Accessed too early?" crash by changing the plugin loading phase. * UE4 - Fixed OnEventStopped not being broadcast when the FMODAudioComponent is destroyed. * Unity - Fixed third party plugin paths for Win32 and Mac. * Unity - Changed the Debug Overlay Window ID to avoid conflicts. * Unity - iOS - Fixed sound stopping in editor when focus is lost. * PS4 - Now built with SDK 6.508.021. 09/05/19 2.00.01 - Studio API minor release (build 102182) ------------------------------------------------------------------------------------------ Features: * Core API - ChannelMix DSP now supports re-routing input channels. * UE4 - Added support for UE4.22. * UE4 - Added Encryption Key to the settings for loading sounds from encrypted banks. * UE4 - Added Play-In-Editor logging options to Plugin Settings. * UE4 - Android - Added support for x86_64. * Unity - Added SetParameter by ID to StudioEventEmitter. * Unity - Added Encryption Key to the settings for loading sounds from encrypted banks. * Unity - Added mouse events to StudioEventEmitter trigger options. Fixes: * Studio API - Fixed assert caused by a backwards transition with a lead out on a transition timeline with callbacks for timeline markers. * Studio API - Fixed bug in cone angle built-in parameter calculation when using FMOD_INIT_3D_RIGHTHANDED. * Core API - Fixed virtualized objects from object spatializer being silenced (introduced in 2.00.00). * Core API - Fix crash when using convolution reverb with a DSP buffer size of 4096 or above. * Core API - Fix crash trying to load corrupt WAV files with 0 length chunk size. * Core API - Fix crash trying to load corrupt MP3 files. * Core API - Fixed send dsp data being retained after being bypassed. * Core API - iOS - Fixed crash when suspending or resuming the mixer while audio is loading. * UE4 - Fixed Ambient LPF values not being set properly. * UE4 - Fixed builds failing due to the integration being loaded after blueprints. * UE4 - Fixed listener using the correct nested AudioVolume. * Unity - Fixed handling banks in sub-directories. * Unity - Fixed IOException when trying to copy banks into StreamingAssets. * Unity - Fixed Events previewed in Timeline not stopping. * Unity - Fixed StudioListeners with an index larger than zero causing errors. * Unity - Fixed FMODStudioSettings.asset modifying bank list order when using different scripting backends. * Unity - Remove garbage collection overhead in DebugOverlay. * Unity - Fixed creating duplicate objects when loading banks for the Editor. * Unity - Fixed Emitters cleaning up properly when using one shot Events. * Unity - Fixed paths for plugins in editor. * Unity - Fixed build errors on iOS / tvOS due to "lowLevelSystem" references. * Unity - Removed excessive error logging when no project or folder linked to the integration. * Unity - Fixed occasional issues with copying banks into StreamingAssets. * Unity - Fixed Master Bank not being found if in a sub directory. * Unity - Fixed StudioParameterTrigger IndexOutOfRange exception. Notes: * XboxOne - Now built with July 2018 QFE4 XDK. 14/03/19 2.00.00 - Studio API major release (build 101145) ------------------------------------------------------------------------------------------ Features: * Studio API - Bank sample data encryption is now supported via the Studio API. Use FMOD_STUDIO_ADVANCEDSETTINGS.encryptionkey to specify the encryption key to use when opening banks and use the FMOD_STUDIO_LOAD_BANK_UNENCRYPTED flag to load unencrypted banks if an encryption key has been set. * Studio API - Added built-in parameter for speed. * Studio API - Added support for global parameters. * Studio API - Added support for global mixer automation. * Studio API - Added the ability to set a custom final value on an AHDSR modulator. * Studio API - Added ignoreseekspeed argument to public api setParameter functions. * Studio API - Added the ability to automate time based ahdsr properties. * Studio API - Added a command instrument with the ability to stop all non-nested instances of an event description. * Core API - Added output device enumeration to Windows Sonic output plugin. * Unity - Switch platform settings have been moved into a separate dropdown. Fixes: * Studio API - Event parameters with "Hold value during playback" enabled now snap to their target values when their event is started. * Studio API - Changed quantization calculation to use future tempo markers if no past tempo markers are present, and default to 4/4 timing at 120 bmp if no tempo markers are present. * Studio API - Transition regions not using quantization perform any probability determinations each time all other required conditions are newly met. * Studio API - Sidechain modulators now correctly handle multiple sidechain inputs. * Core API - Fixed volume spike due to tremolo DSP with high duty setting. * Core API - Fixed excessive instances of clipping that occur when adjusting the FMOD_DSP_THREE_EQ_LOWCROSSOVER value of a DSPThreeEQ DSP in the low frequency range. Notes: * Updated Resonance Audio plugin removing additional transformation of occlusion values. If previous occlusion calculation is required, replace the resonance audio libraries with their 1.10 versions. * The GoogleVR plugin deprecated in 1.10 has now been removed, Resonance Audio is available as a functional drop in replacement. * Studio API - The parameter API has been updated. See the "What's New in 2.00" section in the API documentation for details. * Studio API - The deprecated ParameterInstance class has been removed. * Studio API - Seek speed is now applied when parameter values are modified by AHDSR or sidechain modulation. * Studio API - Parameters with seek speed now snap to their target value when the event stops. * Studio API - Automatic parameters no longer update their user value. The automatically calculated value can be retrieved using the finalvalue parameter of Studio::EventInstance::getParameter. * Studio API - Studio::System::getBank no longer supports getting a loaded bank from the system by filename. * Core API - System::getFileUsage will no longer count bytes read from user callbacks. * Core API - Automatic SRS downmix from 5.1 to 2.0 has been removed. * Core API - System::getSoundRAM API has been removed. * Core API - FMOD_ADVANCEDSETTINGS::HRTFMinAngle, HRTFMaxAngle, HRTFFreq removed * Core API - FMOD_CREATESOUNDEXINFO::channelmask removed * Core API - Win - Support for paths using Windows ANSI Code Page (ACP) encoding has been removed. Paths must be UTF-8 encoded. * Core API - Win - The minimum supported version of Windows has been lifted from Windows XP to Windows 7. Coupled with this change we have removed the legacy DirectSound and WinMM output modes. * Win / UWP - All binaries no longer have a suffix indicating the target architecture, instead the files are separated by directories in the installer. 14/03/19 1.10.12 - Studio API minor release (build 101101) ------------------------------------------------------------------------------------------ Features: * Unity - Added option to specify Live Update port number in editor settings. * Unity - Changed StudioEventEmitter private members to protected. Fixes: * Studio API - Avoid stalling when unloading a bank which is waiting to load sample data behind other banks. * Core API - FMOD_OUTPUTTYPE_ASIO is now compatible with more devices without requiring calls to System::setDSPBufferSize. * Core API - Android - Fixed instances of audio stuttering that occurred on some devices by dynamically adding latency to compensate. * Core API - Fixed MP3 files with MPEG 2.5 encoding having distortion on some files. * Unity - Fixed plugins not being found on Android. * Unity - Fix for banks being read only when trying to copy new banks to StreamingAssets. * Unity - Fixed BatchMode builds not being able to find the MasterBank. * Unity - Fixed BatchMode builds not building with banks. * Unity - Changed console default thread affinity to not use the game thread. * Unity - Fixed Strings bank not being found or copied (introduced in 1.10.10). 01/02/19 1.10.11 - Studio API minor release (build 99976) ------------------------------------------------------------------------------------------ Features: * Studio API - Add streamingscheduledelay member to FMOD_STUDIO_ADVANCEDSETTINGS. May be used to reduce latency when scheduling events containing streaming sounds. * UE4 - Expose the FMODAudioComponent::bAutoDestroy property to the PlayEventAttached Blueprint function. Fixes: * Studio API - Fixed fire and forget event instances not releasing when another instance of the same event is active. * Studio API - Fixed a bug with multi-instruments when using looping and initial seek which caused a gap of silence the same length as the initial seek when scheduling the second instrument. * Core API - Fixed MP3 files using Xing headers from having incorrect seek positions when using Channel::setPosition. * Core API - Fixed potential crash caused by third party applications sending data to the FMOD profiler port. * Core API - Fixed issue where bypassed faders and convolution reverb dsps could silence their output. * UE4 - Fixed 'An invalid object handle' errors from FMODAudioComponent in sequencer after reloading banks. * UE4 - Fixed playback not working correctly in Sequencer. * UE4 - Fixed error from FindEventInstances if zero events found. * UE4 - Fixed Programmer Sounds not auditioning in Editor. * UE4 - Fixed events not playing in Sequencer. * Unity - Fixed RuntimeManager being saved to scene after auditioning timeline. * Unity - Fix AttachInstanceToGameObject positioning not being applied correctly. Notes: * PS4 - Now built with SDK 6.008.051. * iOS - Now built with iOS SDK 12.1 and tvOS SDK 12.1 (Xcode 10.1) which necessitates lifting the min spec to 8.0 for iOS, no change for tvOS. * Mac - Now built with macOS SDK 10.14 (Xcode 10.1) which necessitates lifting the min spec to 10.7 and the removal of x86 support. * Android - Added support for x86_64. 03/12/18 1.10.10 - Studio API minor release (build 98815) ------------------------------------------------------------------------------------------ Features: * Studio API - Added FMOD_STUDIO_EVENT_CALLBACK_REAL_TO_VIRTUAL and FMOD_STUDIO_EVENT_CALLBACK_VIRTUAL_TO_REAL. * Core API - Added DSP::GetCPUUsage to public API. * Core API - Linux - Added support for FMOD_ALSA_DEVICE environment variable to allow a user to specify an ALSA device. * HTML5 - Add Web Assembly support (WASM) to HTML5 version of FMOD Core API and Studio API. Memory usage halved, CPU speed improvements of about 30% * Unity - Android - Added ARM64 support. * Unity - Add support for working with multiple master banks and strings banks. Fixes: * Studio API - Fixed multi-instrument playlist entries set to loop infinitely not looping correctly. * Studio API - Fixed pop that occurs at the start of a transition destination section with a fade curves. * Studio API - Fixed nested event instances stopping when their parent is paused. * Studio API - HTML5 - Fix Studio::System::getSoundInfo not working * Core API - System::setDSPBufferSize validates arguments for integer overflow. * Core API - Fixed potential CPU usage spike due to dsp flush on releasing a programmer sound during the destroy callback. * Core API - Opening a playlist from a URL now validates that the playlist file is a text file and falls back to codec probing if binary data is found. * Core API - Linux - Fixed occasional distortion that can occur when using PulseAudio. * FSBank API - Fixed issue where a file change would not be detected when it has the same modified time. * UE4 - Fixed occlusion using the trace channel selected in editor. * UE4 - Fixed plugin include directory paths. * UE4 - Fixed crash caused by trying to access objects pending kill. * UE4 - Fixed occlusion not working. * UE4 - Fixed programmer sounds trying to access the FMODStudioModule outside of the main thread, while also improving the performance of the FMODAudioComponent. * Unity - Fixed Asset Folder name updating after each keystroke. * Unity - Fixed Timeline playables playing the previously selected event. * Unity - Fixed "Bus not found" error caused when no banks loaded in editor. * Unity - iOS - Fixed Events not resuming after returning focus. * Unity - PS4 - Fixed logging libs being used for development builds. Notes: * Studio API - Reduced the maximum number of parameter values which can be set in a batch using Studio::EventInstance::setParameterValuesByIndices to 64. * HTML5 - Now built with Emscripten v1.38.15 * Switch - Now built with SDK 6.4.0. 11/10/18 1.10.09 - Studio API minor release (build 97915) ------------------------------------------------------------------------------------------ Features: * Studio API - Added globally sequential play mode to multi and scatterer instruments. * Unity - All logging will now be displayed in the editor console. The logging level can be changed using the dropdown in settings. Fixes: * Studio API - Fixed missing bank warnings when playing a CommandReplay using FMOD_STUDIO_COMMANDREPLAY_SKIP_BANK_LOAD mode. * Studio API - UWP - Fixed Studio thread affinity not applying correctly. * Studio API - Android / UWP - Fixed CommandReplay not working with AppX and APK based paths. * Core API - Fixed loading of encrypted FSBs. * Core API - Fixed several panning issues when using FMOD_SPEAKERMODE_QUAD or FMOD_SPEAKERMODE_SURROUND, does not affect Studio API usage. * Core API - Fixed potential hang from internal fade point usage. * Core API - Fixed ChannelControl::setMixLevelsInput not remembering the set values when FMOD_3D is applied. * Core API - Fixed potential cpu usage spike due to thread lock on releasing a non-gpu convolution reverb dsp. * Core API - Fixed support of FMOD_3D_INVERSETAPEREDROLLOFF. * Core API - Fixed potential cpu usage spike due to thread lock on releasing a transciever dsp. * Core API - Win / UWP - Fixed Windows Sonic initialization failure when audio device is configured for a sample rate other than 48KHz. * Core API - Linux - Fixed ALSA default audio device selection. * Core API - Android - Fixed crash if System::mixerSuspend is called before System::init. * Unity - iOS - Fixed playback not resuming after alarm / call interruptions. Notes: * Updated Resonance Audio plugin to add support for near field effects, and added FMOD_DSP_PARAMETER_OVERALLGAIN parameter to support virtualization. * PS4 - Now built with SDK 6.008.001. * XboxOne - Now built with July 2018 QFE2 XDK. 10/08/18 1.10.08 - Studio API minor release (build 96768) ------------------------------------------------------------------------------------------ Features: * UE4 - FMODAudioComponent is now blueprintable. Fixes: * Studio API - Fixed potential crash when calling Studio::EventInstance::release from the FMOD_STUDIO_EVENT_CALLBACK_STOPPED triggered by Bus::stopAllEvents. * Studio API - Fixed a bug where changes to a parameter value made while an event was in the FMOD_STUDIO_PLAYBACK_STARTING state would not update automation controllers (introduced in 1.10.02). * Studio API - Fixed Studio::CommandReplay::release not cleaning up resources unless Studio::CommandReplay::stop was called earlier. * Studio API - HTML5/WebGL - Fixed the following functions that didn't work. - Studio::Bank::getID - Studio::EventDescription::getID - Studio::Bus::Bank::getID - Studio::VCA::Bank::getID - Studio::System::lookupID - Studio::Bank::getStringInfo - Studio::System::getBankList - Studio::EventDescription::getInstanceList - Studio::Bank::getEventList - Studio::Bank::getBusList - Studio::Bank::getVCAList * Core API - Fixed audible artifacts when adjusting pitch near 1.0. Issue can be seen from doppler calculations with small velocities. * Core API - Improved stuttering issue when using Windows Sonic with high DSP CPU usage. * Core API - Fixed init errors on output devices that operate at 384KHz such as the Aune X1s. * Core API - Windows - Improved compatibility with some audio drivers by falling back to stereo. * Core API - HTML5/WebGL - Added support for unimplemented System::createDSP with FMOD_DSP_DESCRIPTION. DSP callbacks are provided to allow custom DSP support in Javascript. Added dsp_custom example to example folder. * Core API - HTML5/WebGL - Added support for unimplemented ChannelControl::setCallback. * Core API - HTML5/WebGL - Enabled support for 5.1 / Surround sound in a browser. Only Firefox supports 5.1 so far, out of all browsers tested. * UE4 - Fixed Activate and SetActive not working for FMODAudioComponents. * UE4 - Fixed Simulating in editor producing no sound. * UE4 - Fixed BlueprintStatics::LoadBank not working for banks containing spaces. * UE4 - Fixed asset banks not displaying in editor or being loaded. * Unity - Fixed warnings due to loading sample data on a metadata-only bank before its asset bank is loaded. * Unity - Fixed source project not updating if the old path is still valid. Notes: * XboxOne - Now built with April 2018 QFE1 XDK. 03/07/18 1.10.07 - Studio API minor release (build 95892) ------------------------------------------------------------------------------------------ Features: * Unity - Added support for Timeline (from Unity 2017.1 onwards). Fixes: * Studio API - The FMOD Gain effect is now taken into account when applying event stealing behavior and virtualizing FMOD::Channels. * Core API - Win/XboxOne - Fixed crash during System::recordStart if the device was unplugged. * Core API - Win - System::loadPlugin now correctly handles UTF-8 encoded paths. Support for paths using ACP is deprecated and will be removed in FMOD 1.11. * UE4 - Fixed auditioning events not taking parameter values into account. * UE4 - Fixed game crash when built using Event-Driven-Loader. 06/06/18 1.10.06 - Studio API minor release (build 95384) ------------------------------------------------------------------------------------------ Features: * Unity - Added SampleRate for Play-In-Editor settings. * Unity - Added scripts for setting thread affinity on specific consoles. * HTML5 - Updated core API and studio API examples to handle chrome mute until mouse click or touch event happens, via System::mixerSuspend / System::mixerResume. Fixes: * Core API - Fixed potential crash if a stream naturally ends at the same time as being released. * Core API - Fixed incorrect parsing of large ID3 tags. * Core API - Fixed FMOD_ERR_FILE_BAD error when trying to call setPosition to a point past 2GB bytes in a file. * Core API - Fixed crash if Windows Sonic output mode is used with the object spatializer and the device is unplugged. * Core API - Fixed stall in Sound::release for FSB files if another thread is performing a createSound operation. * Core API - Fixed potential crash when playing a netstream with tags. * Core API - Fixed OGG netstreams not automatically stopping if the stream goes offline. * Core API - Fixed potential invalid memory access when a channel group is released (introduced in 1.10.02). * Core API - Channel group audibility now factors in attenuation due to 3D effects when using ChannelControl::setMode(FMOD_3D). * Core API - HTML5/WebGL - Fix System::setDriver(0) causing garbled audio when trying to respond to a touch event and the audio is already active. * Core API - HTML5/WebGL - Fix floating point accuracy issues making MIDI file sound out of tune. * Core API - UWP - Fixed default affinity mask incorrectly putting all threads on core 0, now threads default to distributing among all cores. * UE4 - Removed FMODAudioComponent ticking when deactivated. Notes: * Core API - Windows Sonic output mode no longer requires a block size of 480. * XboxOne - Now built with February 2018 XDK. * Switch - Now built with SDK 5.3.0. 26/04/18 1.10.05 - Studio API minor release (build 94661) ------------------------------------------------------------------------------------------ Features: * Core API - Add "Channel mask" tag to MIDI file support, to allow a user to map used / unused channels in a midi file to the channel IDs in the Sound::setMusicChannelVolume / Sound::getMusicChannelVolume functions * Core API - Fixed System::recordStart memory leak if an error was returned. * UE4 - File buffer size is now customizable in the settings menu. Fixes: * Studio API - Fixed a rare bug where Studio::System::Update could hang if a streaming sound encountered an error. * Studio API - Fixed events getting stuck in a paused state if they were restarted while waiting for sample data to load (introduced in 1.10.02). * Studio API - Fixed an issue preventing network streams being used as programmer sounds. * Core API - Fixed rare hang during Sound::release when releasing a streaming sound in the FMOD_OPENSTATE_ERROR state. * Core API - Switch - Fixed Vorbis encoded banks producing silence when using multimedia.nso (UE4 uses this). * UE4 - Fixed FMODAudioComponent programmer sound creation flags. * UE4 - Switch - Fixed performance by changing default thread affinity. * Unity - Fixed FMODStudioSettings asset dirty flag being set unnecessarily. * Unity - Fixed callbacks crashing when using IL2CPP or Mono on some platforms. * Unity - Fixed editor system not being cleaned up on Play-In-Editor start. * Unity - Android - Fixed load bank returning ERR_INVALID_HANDLE. Notes: * Core API - It is now possible to initialize WinSonic output even if the user has not enabled spatial audio on their default device. The platform will provide a non-binaural downmix to the user desired speaker mode. * PS4 - Now built with SDK 5.508.021. 05/03/18 1.10.04 - Studio API minor release (build 93853) ------------------------------------------------------------------------------------------ Features: * Studio API - Improved bank loading performance when there are already a large number of loaded events. * UE4 - Added the ability to enable Live Update while in editor for auditioning. The Editor will need to be restarted for this setting to take effect. Fixes: * Studio API - Fixed a bug where Studio::System::Update could fail with FMOD_ERR_INVALID_HANDLE or FMOD_ERR_CHANNEL_STOLEN, which could lead to memory or performance problems. Introduced in 1.10.03. * Core API - XboxOne - Fixed XMA hang that can occur after actively using many XMA voices for several days. * Unity - Fixed MobileHigh/Low classifications for Apple Devices. Pre iPhone 5 is classed as MobileLow. 01/02/18 1.10.03 - Studio API minor release (build 93157) ------------------------------------------------------------------------------------------ Features: * Core API - Added ASIO support for drivers that use PCM32 as a container for smaller sized data. * Profiler - Draw different DSP connection types with different line styles. * UE4 - Added option to specify memory pool size, per platform, in the project FMOD Studio settings. * UE4 - Now complying with IWYU mode, this should increase compilation speed. Fixes: * Studio API - Fixed the DSP network sometimes getting into a bad state when a sidechain is connected to the next effect in the chain. * Studio API - Fixed event playback sometimes using stale parameter values. * Studio API - Fixed events failing to stop if they contain empty Single Instruments. * Core API - Fixed potential crash in device list changed callback when there are no available devices remaining. * Core API - Fix 3D 5.1 sound not panning correctly if ChannelControl::set3DLevel(0) is used. * Core API - Fixed ID3v2.4 compatibility issue causing missing or corrupted tags. * Core API - Android - Fixed incorrect floating point check on ARM64 devices causing FMOD_ERR_NEEDSHARDWARE with some devices. * Core API - XboxOne - Fixed race condition causing internal errors with XMA sounds loaded as FMOD_CREATECOMPRESSEDSAMPLE. * Core API - PS4 - Fixed internal assertion caused by setPosition on an AT9 sound loaded as FMOD_CREATECOMPRESSEDSAMPLE. * FSBank API - Fixed creation of C header so it goes next to the FSB instead of the working directory of the application. * Unity - Fixed pause working properly in Play In Editor mode. * Unity - Removed excess memory allocation from APIs that return strings in C#. * UE4 - Fixed velocity of FMODAudioComponents. Notes: * Unity - Added support for Unity 2017.3. * Android - Now built with NDK r16b. * Android - Minimum Android version is now API level 14 due to NDK r16b deprecating older versions. * Switch - Now built with SDK 3.5.1. 07/12/17 1.10.02 - Studio API minor release (build 92217) ------------------------------------------------------------------------------------------ Features: * Core API - UWP - Added Windows Sonic support. * Core API - UWP - Added support for setting thread affinity via FMOD_UWP_SetThreadAffinity. Fixes: * Studio API - Fixed Quietest stealing behavior so new events don't start if they are quieter than all currently playing events. * Studio API - Fixed buses that have reached their Max Instances limit incorrectly preventing their input buses from applying their stealing behavior. * Studio API - Fixed a crash caused by wav files with invalid loop points. * Core API - Fixed recording devices still being marked as connected when switching to FMOD_OUTPUTTYPE_NOSOUND. * Core API - UWP - Made device reset / unplug behavior more robust against failure. * Core API - XboxOne - Fixed WASAPI init error if WinSonic was attempted first. * FSBank API - Fixed crash in 64bit version when encoding low sample rate mono sounds as Vorbis with low quality. * Unity - PlayOneshot and PlayOneshotAttached now log a warning when the event is not found, rather than throwing an exception. Notes: * Added Resonance Audio plugin version 1.0, this plugin represents the continuation of the Google VR plugin under new branding. The Google VR plugin is now considered deprecated in favour of Resonance Audio, consider migrating to the new plugin as the GVR plugin will be removed in FMOD 1.11. * XboxOne - Now built with June 2017 QFE 8 XDK. 01/11/17 1.10.01 - Studio API minor release (build 91339) ------------------------------------------------------------------------------------------ Features: * UE4 - Expose Studio::Bus::stopAllEvents to be useable through blueprints. * Unity - Event length displayed in event browser for one shot events. Fixes: * Studio API - Fixed modulation on plugin instruments using the parent event's lifetime rather than the instrument's lifetime. * Studio API - Fixed a live update issue where asset files would not reload after being moved on disk. * Studio API - Fixed a bug which caused sounds to pan incorrectly when using FMOD_INIT_3D_RIGHTHANDED. * Studio API - PS4 - Fixed excessive binary size caused by inclusion of debug symbols. * Core API - Fixed potential crash when re-initializing System after failure. * Core API - Fixed compatibility issues with Windows XP. * Core API - Android - Fixed exported symbols to avoid issues with unwinder. * Core API - Android - Automatic output mode selection will now choose AudioTrack rather than OpenSL if Bluetooth is enabled to avoid stuttering. * Core API - XboxOne - Ensure WinSonic internal threads are assigned to the same core as the FMOD mixer. * FSBank API - Fixed crash when encoding very long audio files. * UE4 - Integration now handles application interruption by pausing and resuming the mixer. * UE4 - Fixed SetEvent not setting or using new event. * UE4 - Fixed XboxOne thread affinity struct setup. * UE4 - Removed engine version ifdef's. * UE4 - Fixed integration attempting to set the initial value of built-in parameters. * Unity - Fixed compatibility for Unity 5.0 & 5.1. * Unity - Added check to see if any banks have been loaded before trying to pause. * Unity - Allow StringHelper to fast return if string is null. Notes: * Updated Google VR plugin to version 0.6.1. * Studio API - Studio::EventInstance::set3DAttributes and Studio::System::setListenerAttributes will now return FMOD_ERR_INVALID_PARAM if the forward or up vectors are zero. In logging builds warnings will be logged if the forward and up vectors are not orthonormal. * Core API - The convolution reverb effect will not accept impulse response data if the system is not using a power-of-two DSP buffer size. Windows Sonic currently requires a DSP buffer size of 480 making it incompatible with convolution reverb until this requirement is lifted. * PS4 - Now built with SDK 5.008.001. * Unity - Exposed editor script classes for in-game FMOD objects as public. * Unity - Exposed StudioEventEmitter's EventInstance as public to allow easier integration with custom plugins. 19/09/17 1.10.00 - Studio API major release (build 90329) ------------------------------------------------------------------------------------------ Features: * Core API - Added FMOD_MAX_SYSTEMS constant, currently 8. * Core API - Exposed FMOD_DSP_FADER_GAIN on FMOD_DSP_TYPE_FADER. * Core API - Added FMOD_SPEAKERMODE_7POINT1POINT4 speaker mode which includes four height speakers to be used with Windows Sonic output. * Core API - Added FMOD_DSP_PAN_2D_HEIGHT_BLEND parameter to FMOD_DSP_TYPE_PAN that allows mixing ground speaker signal into the height speakers and vice versa. * Core API - Windows & XboxOne - Added Windows Sonic output plugin to support rendering multichannel (with height) speaker mode 7.1.4 as well as dynamic objects via FMOD_DSP_TYPE_OBJECTPAN. * Core API - PS Vita - Switched FMOD_PSVita_SetThreadAffinity to accept a mask instead of a core number to allow floating threads. * Core API - Added FMOD_OUTPUT_REQUESTRESET to FMOD_OUTPUT_STATE to allow output plugins to request they be reset by the System. Fixes: * Studio API - Sequential multi and scatterer instruments now track their current playlist entry on a per-event-instance basis, rather than globally. * UE4 - Removed all reference to Oculus, now that Oculus functions as all other FMOD Studio plugins. * UE4 - Removed all legacy UE4 version code, if you are not using UE4.16 the plugin will not work without making changes to source code. * UE4 - Overhauled details interaction in editor and improved usability. Grouped all FMOD functionality together, added Parameters, and removed unnecessary information from attenuation/occlusion. * Unity - Removed garbage allocations from C# wrapper. Notes: * Updated Google VR plugin to version 0.6.0. * Studio API - Changed the behaviour of nested events to stop when idle even when there are instruments on parameters. This makes nested events match the behaviour of top level events. Events which depend on the old behaviour need to be manually fixed up by (for example) adding a sustain point to the nested events timeline. * Core API - FMOD_DSP_TYPE_ENVELOPEFOLLOWER is now deprecated and will be removed in a future release. * Core API - Increment Plugin API version for Output plugins. Dynamic library Output Plugins must be rebuilt. * Android - Logging version will now produce proper crash stacks but due to binary size increase the release version will continue to not. * XboxOne - Removed "acp" and "feeder" from FMOD_XBOXONE_THREADAFFINITY. Both threads were removed in previous versions and setting them did nothing. * UE4 - AudioComponents using occlusion from previous versions are NOT compatible with this version. Occlusion and Attenuation now do not rely on UE4 structs. 11/09/17 1.09.08 - Studio API minor release (build 90162) ------------------------------------------------------------------------------------------ Fixes: * Core API - Fixed extraneous logging. 07/09/17 1.09.07 - Studio API minor release (build 90008) ------------------------------------------------------------------------------------------ Features: * UE4 - Cache dsp used for occlusion lowpass effect & add support for use of Multiband EQ (lowpass on band A only). * UE4 - FMODAudioComponent now reuses event instances until the object is no longer needed or Release() is called. * UE4 - Added support for UWP. * Unity - Added support for Unity v2017.1. * Unity - Added a button in the FMOD menu for Refreshing Bank files. Fixes: * Studio API - Fixed scatterer sounds being processed by FMOD::Geometry. * Studio API - Fixed multi-stream events playing out of sync (introduced in 1.09.01). * Core API - Fixed ChannelControl::setDelay being ignored if addDSP was called immediately after it. * Core API - Fixed potential crash if calling Channel::setPosition soon after System::playSound with paused as true. * Core API - Fixed click on ChannelControl::setPaused(false) caused by a non-zero Channel::setPosition after System::playSound with paused as true. * Core API - Fixed potential crash if calling System::getRecordPosition while disconnecting an audio device. * Core API - Fix FMOD_ACCURATETIME not looping mod/s3m/xm/it files properly, and midi files not looping properly without the flag. * Core API - Fixed crash when attempting to load invalid VST files. * UE4 - Fix compile error by adding categories to AnimNotify vars. * Unity - Switch - Fixed "unknown pointer encoding" error when an exception occurs. * Unity - Fix plugin path for UWP builds. * Unity - Fixed possible crash when using GoogleVR plugin. * Unity - Fix EventEmitter SetParameter not working unless parameter had an inital value set in editor. Notes: * Studio API - Reduced memory usage for events with a small number of instances. * Core API - FMOD_CREATESOUNDEXINFO::initialseekposition will now wrap if the value given is longer than the Sound length. * Core API - Added documentation to the top of fmod_codec_raw to be more instructional for plugin writers. * UE4 - Added support for UE4.17. * Unity - Device specific errors will now cause only a single exception to be thrown and the integration will assume no-sound mode. * Switch - Now built with SDK 1.7.0. * XboxOne - Now built with March 2017 QFE 3 XDK. 06/07/17 1.09.06 - Studio API minor release (build 88495) ------------------------------------------------------------------------------------------ Features: * Studio API - Improved performance when a large number of EventInstances have been created but not started. * Core API - HTML5 - Performance increased by 10%. Fixes: * Studio API - Fixed a bug where an asynchronous looping multi instrument would stop selecting new playlist entries after playing a nested event which itself contains an asynchronous looping multi instrument. * Studio API - Fixed a bug where a parameter could trigger parameter instruments before having its value updated by modulators when restarting an event instance. * Studio API - Fixed incorrect automation interpolation on transition timelines with lead-out regions. * Core API - Fixed DSPs with sidechain inputs incorrectly going idle when the main input is idle but the sidechain input is not. * Core API - Fixed the compressor DSP not playing out its release correctly when its inputs are idle. * Core API - Remove main thread stall from System::playDSP (or playing a generator DSP via Studio API). * UE4 - Sequencer integration now supports previewing event playback in an editor viewport by using the Sequencer transport controls. A Sequencer section has been added to the documentation. * UE4 - Added AreBanksLoaded funtion to FMODStudioModule. * Unity - Events in EventBrowser window now in alpabetical order. * Unity - Setting parameters on StudioEventEmitter no longer generates garbage. Notes: * Core API - Added checking to System::mixerResume to ensure called from the same thread as System::mixerSuspend. * XboxOne - Now built with October 2016 QFE 3 XDK. 08/06/17 1.09.05 - Studio API minor release (build 87666) ------------------------------------------------------------------------------------------ Features: * Core API - Switch - Added support for HTC sockets to allow communications between FMOD tools and runtime via target manager. Enable using FMOD_Switch_SetHTCSEnabled(TRUE). * Core API - XboxOne - Added support for System::attachChannelGroupToPort with FMOD_XBOXONE_PORT_TYPE_MUSIC. Fixes: * Studio API - Fixed FMOD_ERR_INTERNAL returned when loading old bank files containing transition timeline automation of instrument volumes. * Studio API - Fixed bug where very short instruments would not play when cross fading. * Studio API - Made changes to the logic in Studio::EventDescription::isOneShot so that it consistently returns true for events which are guaranteed to finish without intervention, and false for events which may play indefinitely. * Core API - Fixed ChannelControl::setMixLevelsInput not working and updated docs. * Core API - Fixed Channel::setLoopCount not working with very small streams. * Core API - Stricter error checking when loading IMA ADPCM wav files to prevent a potential crash from malformed data. * Core API - Fixed potential crash in ChannelGroup operations when a Channel failed to play on it with FMOD_ERR_SUBSOUNDS. * Core API - Fixed Convolution reverb panning a mono IR with a stereo input incorrectly. * Core API - Fixed race conditions when setting FMOD_DSP_SEND_RETURNID. * Core API - Fixed a crash with some MOD/S3M/XM/IT files. Introduced in 1.09.00. * Core API - System::setDSPBufferSize will round the requested buffer size up to the closest multiple of 4 to prevent a crash when sending metering data to studio. * Core API - PS4 - Fixed GPU compute compatibility issue with SDK 4.508.001. GPU compute is now re-enabled. * Core API - Switch - Reduced thread priority to avoid conflict with Profiler. * Core API - Windows - Fixed ASIO output mode failing to initialize if the devices requires a buffer size of 2048 samples. * Unity - Fixed bank directory path separators when developing across OSX & Win. * Unity - Fixed simulated Android devices producing no sound. * Unity - BankLoadException now display error message correctly. * Unity - Fixed bank loading and unloading refcount accuracy. * Unity - Fixed Mac editor attempting to load Linux plugins when building for Linux platform. * Unity - Improved detection of 3D Event Instances that haven't had their position set yet. * UE4 - Fixed integration working with UE4's IWYU non-monolithic header system, for now the integration is still using the old PCH system. * UE4 - Added new native AnimNotify class, old one didn't work on code projects. * UE4 - Sequencer integration. FMOD events can be started and stopped and event parameters can be controlled by adding custom tracks to sequencer. * UE4 - Fixed max vorbis codecs not being set correctly. * UE4 - Fixed file readers being accessed from multiple threads. Notes: * UE4 - Added support for UE4.16. Notes: * Updated Google VR plugin to version 0.4.0, please note there is a known crash when loading the plugin on Windows XP, Google are aware and investigating. 10/04/17 1.09.04 - Studio API minor release (build 86084) ------------------------------------------------------------------------------------------ Fixes: * Studio API - Fixed delayed playback on streaming sounds in events (introduced in 1.09.03). * Studio API - Fixed AHDSR release not working on single sounds shorter than 100 milliseconds. * Studio API - Fixed Studio::EventDescription::is3D returning true for events that only have 2D panners. * Studio API - Set programmer sounds to FMOD_LOOP_NORMAL internally if they were not created that way. * Studio API - Fixed regression introduced in 1.09.00 which allowed events to play at the origin before 3d attributes were updated. * Studio API - Fixed issue where reverb tail would cut off when all events on a bus finished playing. * Core API - Fixed FMOD_DSP_TRANSCEIVER making channels audible that weren't supposed to be (introduced with glitch fix in 1.09.03). * Core API - Fixed loop clicks on PCM sounds if using FMOD_DSP_RESAMPLER_CUBIC or FMOD_DSP_RESAMPLER_SPLINE. * Core API - Fixed FMOD_ADVANCEDSETTINGS::resamplerMethod being ignored. * Core API - Fixed plugin unloading for multi-description libraries potentially failing depending on how it's unloaded. * Core API - Fixed stream glitch when going virtual then resuming. * Core API - Fixed virtual voices losing their loop/2d/3d status, and not staying virtual if ChannelControl::setMode was used. Introduced in 1.09.00. * Core API - Fixed FMOD_UNIQUE not being accepted if ChannelControl::setMode or Sound::setMode was used. (it could be successfully used via createSound/createStream). * Core API - Fixed rare crash in mixer, introduced 1.09.00. * Core API - Switch - Fixed FMOD_SWITCH_THREADAFFINITY so cores can be ORd together to form a mask. * Core API - PS4 - GPU compute disabled due to an incompatibility with SDK 4.508.001. * Core API - Windows/Mac - Re-enable SRS downmixer 80Hz high pass filter by default. Add FMOD_INIT_DISABLE_SRS_HIGHPASSFILTER init flag to disable it. * FSBank API - Fixed PS Vita AT9 encoder not working with currently available Sony library. * FSBank API - Fixed full scale 32bit float wav files encoding incorrectly. Notes: * Studio API - FMOD expects programmer sounds to be created with FMOD_LOOP_NORMAL. This is now specified in the FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES documentation. * FSBank API - Building an FSB with PS Vita AT9 encoding now requires 64bit. * PS4 - Now built with SDK 4.508.001. * Switch - Now built with SDK 0.12.17. * XboxOne - Now built with October 2016 QFE 2 XDK. 20/03/17 1.09.03 - Studio API minor release (build 85359) ------------------------------------------------------------------------------------------ Features: * Core API - Updated the /examples/dsp_custom example to include a lot more functionality including parameters, and capture of wave data. * Core API - Add fmod_reduced.js for reduced functionality, but also reduced size. * Core API - Switch - Added support for setting thread affinity. * Studio API - Reduced size of fmodstudio.js and .mem files. Fixes: * Studio API - Fixed event doppler settings not being applied to sounds spawned by scatterer. * Studio API - Fixed bus and VCA handles not being set up properly in Studio::Bank::getBusList and Studio::Bank::getVCAList. * Studio API - Fixed crashes caused by stopping events that are routed into a bus with instance limiting enabled when they are in the FMOD_STUDIO_PLAYBACK_STARTING state. * Studio API - Fixed tempo and marker event callbacks not being fired when the timeline cursor is in the lead-in or lead-out region of a transition timeline. * Core API - Fixed glitches with Transceiver DSP after inputs go idle. * Core API - Fix Channel::setPosition(pos, FMOD_TIMEUNIT_MODORDER) not working when playing paused. * Core API - Fixed short streams created as non-looping then switched to looping via the Channel API not looping seamlessly. * Core API - Fixed DSP plugin version >= 109 data parameters other than 3D attributes not applying if FMOD_INIT_3D_RIGHTHANDED is used. * Core API - Fixed rare crash in FMOD Panner DSP. Introduced in 1.09.00. * Core API - Re-Fix MOD/S3M/XM/IT file crash with samples that have 0 length, for 1.09 only. * Core API - Fixed potential memory leak if System::init returned an error. * Core API - Fix FMOD_ACCURATETIME not looping a mod file properly, and not seeking correctly with FMOD_TIMEUNIT_MODORDER. * Core API - HTML5 - Loading FSB sounds did not work properly. * Core API - Windows - Fixed 5.1->stereo SRS downmix causing lack of bass. * Core API - Windows - Fix FMOD_INIT_PREFER_DOLBY_DOWNMIX not working. * FSBank API - Fix crash if FSBANK_INIT_GENERATEPROGRESSITEMS is not used. * Unity - Removed error when plugin field is added but empty. * UE4 - Removed error when plugin field is added but empty. Notes: * UE4 - Added support for UE4.15. 15/02/17 1.09.02 - Studio API minor release (build 84334) ---------------------------------------------------- Fixes: * Unity - Remove ifdef from EnforceLibraryOrder as it isn't harmful for static lib platforms to call GetStats. * UE4 - Occlusion can now use Multiband EQ instead of Lowpass filter. * Core API - Fix crash when connecting to FMOD Profiler.exe and there is a circular connection * Core API - Fix glitches with Transceiver DSP after inputs go idle. * Core API - Fix Channel::setPosition(pos, FMOD_TIMEUNIT_MODORDER) not working when playing paused. 09/02/17 1.09.01 - Studio API minor release (build 84153) ---------------------------------------------------- Features: * Core API - Added FMOD_DSP_STATE_FUNCTIONS::getlistenerattributes to the DSP plugin API to query the current listener attributes. * Unity - Added support for Rigidbody2D in 3D attribute settings and integration scripts. * Unity - Added support for Object Enable/Disable on EventEmitter and ParameterTrigger scripts. * UE4 - Added GetLength function for blueprints that returns the event length in milliseconds. * UE4 - Improved in editor profiling stats. Fixes: * Unity - Fixed compatibility with Unity 4.6 & 4.7 for OSX and IOS. * Unity - Fixed "file not found" error when settings asset is corrupt * Unity - Fixed set3DAttributes ambiguity. * Unity - Fixed not being able to copy ReadOnly banks into StreamingAssets. * Unity - Fixed event instance leak in Unity PlayOneshotAttached not releasing. * Unity - Specified version to check for WiiU BuildTarget for early Unity5. * UE4 - Fixed XboxOne delayload error now that UE4 handles it. * UE4 - Android - Added ARM64 support. * Studio API - AHDSR modulator curve shapes now work correctly. In previous versions the envelope was interpolated linearly regardless of the shape displayed in the UI. * Studio API - Fixed looping single sounds in an async multi sound being cut-off when the multi sound is un-triggered. * Core API - Fixed ChannelControl::setReverbProperties not resetting reverb connection to a new tail DSP when turning wet mix off and on. * Core API - If the system is initialized in right-handed mode, FMOD will now swap to left-handed when passing attributes into plugins. This only applies to plugins rebuilt against this version, old plugins remain unswapped. * Core API - Fix MOD/S3M/XM/IT file crash with samples that have 0 length. * Core API - Fixed some potential crashes when running out of memory, these will correctly return FMOD_ERR_MEMORY now. * Core API - Win - Fixed WASAPI recording device enumeration taking a couple of seconds after System::init before being correct. * Core API - Win - Fixed potential error returned from System::update if device is unplugged. * Core API - MIDI - Fixed Sound::set/getMusicChannelVolume referring to wrong track indices rather than just a normal 0-15 track index. * Core API - MIDI - Fixed Channel::setPosition causing loud drum bang noise after seek Notes: * Studio API - When loading legacy banks with looping sounds nested in multi sounds, the multi sound is set to cut-off all sounds when untriggered, including non-looping sounds. This is a change in behaviour compared to earlier versions where only looping sounds were cut-off. * Core API - DSP plugin API version has been increased, for maximum compatibility plugin writers should only rebuild against this version if they need the getlistenerattributes feature. Old plugins are still supported. * Switch - Now built with SDK 0.12.10 01/12/16 1.09.00 - Studio API major release (build 82164) ---------------------------------------------------- Important: * Added support for the Nintendo Switch platform. Features: * Studio API - Added support for multiple listener weights, with Studio::System::setListenerWeight and Studio::System::getListenerWeight. This allows listeners to be faded in or out smoothly. * Studio API - Profiling uses less CPU and memory. * Studio API - Added FMOD_STUDIO_INIT_LOAD_FROM_UPDATE to drive all loading from Studio::System::update rather than the bank and resource loading threads. Mainly used in non-realtime situations. * Studio API - Added ability to run replays at faster than real time speed using FMOD_STUDIO_COMMANDREPLAY_FAST_FORWARD. * Studio API - Added Studio::EventInstance::setReverbLevel and Studio::EventInstance::getReverbLevel. * Studio API - Support for automation of modulator properties. * Core API - Improved memory use when loading sounds with names. * Core API - Added new efficient multiband equalizer (FMOD_DSP_TYPE_MULTIBAND_EQ) featuring 5 toggleable bands with variable rolloff low/high pass, shelf, peaking, band-pass, all-pass and notch modes. * Core API - Added logging function to the DSP plugin API. Use FMOD_DSP_LOG helper macro from a DSP callback. * Core API - Added FMOD_DSP_STATE_FUNCTIONS::getuserdata to the DSP plugin API. Use FMOD_DSP_GETUSERDATA helper macro from a DSP callback. * FSBank API - Added ability to pass NULL as the FSB file name for FSBank_Build causing the FSB to be built in memory. Use FSBank_FetchFSBMemory to get access to the data once the build has completed. Fixes: * Studio API - Fixed incorrect playback volume for instruments and playlist items whose volume property is set to a non-zero dB value. Notes: * Core API - Incremented Plugin SDK version for DSP plugins. Dynamic library plugins built with earlier versions will continue to load. * Core API - Incremented FMOD_CODEC_WAVEFORMAT version. Codecs that provide names must keep the name memory persistent for the lifetime of the codec. * Core API - Increment Plugin API version for Output plugins. Dynamic library Output Plugins must be rebuilt. * Core API - FMOD_DSP_TYPE_LOWPASS, FMOD_DSP_TYPE_LOWPASS_SIMPLE, FMOD_DSP_TYPE_HIGHPASS, FMOD_DSP_TYPE_HIGHPASS_SIMPLE and FMOD_DSP_TYPE_PARAMEQ are considered deprecated and will be removed in the future. Use the new FMOD_DSP_TYPE_MULTIBAND_EQ instead which has the performance of "simple" effects with full featured quality. * Core API - Changed reverb wet mix to send from the fader DSP of a ChannelGroup. Previously it sent from the head DSP. Now effects placed pre-fader will apply to the signal sent to the reverb, while effects placed post-fader will not. * Core API - ChannelGroup reverb wet level is now scaled by the group's effective audibility. * Core API - ChannelGroup reverb no longer automatically disables reverb on its child channels when the wet level is set to non-zero. * Core API - Channel::setReverbProperties now allows setting the wet level before the specified reverb instance has been created. * Core API - ChannelControl::addDSP and ChannelControl::removeDSP manage standard DSP connections (FMOD_DSPCONNECTION_TYPE_STANDARD) to maintain the mixer hierarchy. Other connection types (FMOD_DSPCONNECTION_TYPE_SIDECHAIN, FMOD_DSPCONNECTION_TYPE_SEND_SIDECHAIN, and now FMOD_DSPCONNECTION_TYPE_SEND) are left undisturbed. * Core API - FMOD_INIT_MIX_FROM_UPDATE will now directly execute the mixer from System::update instead of triggering the mix to happen in another thread. * Studio API - Incremented bank version, requires runtime 1.09.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Studio API - Studio::Bus::setFaderLevel, Studio::Bus::getFaderLevel, Studio::VCA::setFaderLevel and Studio::VCA::getFaderLevel is now called Studio::Bus::setVolume, Studio::Bus::getVolume, Studio::VCA::setVolume and Studio::VCA::getVolume. * Studio API - Studio::EventInstance::getVolume, Studio::EventInstance::getPitch, Studio::EventInstance::getParameterValue, Studio::EventInstance::getParameterValueByIndex, Studio::Bus::getVolume, Studio::VCA::getVolume now have an additional argument to get the final value which includes automation and modulation. * Studio API - The required alignment for Studio::System::loadBankMemory has been added as the constant FMOD_STUDIO_LOAD_MEMORY_ALIGNMENT. * Studio API - Event instances now disable reverb on their internal channels, for all global reverb instances. Previously only did so for reverb instance 0. Use Studio::EventInstance::setReverbLevel to control the reverb mix for the whole event instance. * Studio API - Disconnected sidechain modulators are now inactive. Previous behavior was to fall back to monitoring the event's master track output. * Core API - FMOD_DSP_RELEASE_CALLBACK is now called from the main thread * Core API - Unimplemented ChannelControl::overridePanDSP function has been removed, along with FMOD_CHANNELCONTROL_DSP_PANNER enum value. * Core API - PS3 - Removed old opt-in FIOS support via FMOD_PS3_EXTRADRIVERDATA. New recommended approach is to use FMOD_FILE_ASYNCREAD_CALLBACK and set appropriate deadlines based on FMOD_ASYNCREADINFO::priority. * Core API - XboxOne - Optimized XMA decoding performance and removed the ACP thread. * Core API - PS4 - Improved AT9 decoding performance. * FSBank API - Added support for source data as a memory pointer instead of file name. * Documentation - Some FMOD_DSP_PAN_SURROUND enums changed to FMOD_DSP_PAN_2D for clarity. 01/12/16 1.08.15 - Studio API minor release (build 82163) ---------------------------------------------------- Features: * PS4 - Add support for System::getOutputHandle, to return sce port handle. Fixes: * UE4 - Fix missing plugin error when building on Mac. * UE4 - Fixed compatibility with 4.14. * Unity - Fixed OSX working with unified library. * Unity - Fixed WiiU copying banks error. * Unity - Fixed XboxOne dll meta files missing platform target. * Unity - Fixed duplicate dll copying build error on some platforms. * Unity - Added null check to stop error being thrown when no event assigned. * Unity - Fix in editor out of bounds exception in RuntimeManager. * Core API - Allow DSP::setParameterData with null data and 0 length to free convolution reverb impulse response data. * Core API - Fixed short looping streams playing some of the start when switched to non-looping via the Channel API. * Core API - Fixed FMOD_CREATESOUNDEXINFO::pcmsetposcallback getting wrong sound pointer passed to it with a stream. * Studio API - Fixed incorrect parameter values being passed to nested events when value "hold" is being used. * Studio API - PS3 - Fix potential crash with the new Channel Mix effect. * FSBank API - Fixed encoder bug with FADPCM causing occasional clipping at playback. Notes: * FSBank API - FSBs / Banks may not be binary identical to previous release due to FADPCM encoder bug fix, however full compatibility is maintained. 20/10/16 1.08.14 - Studio API minor release (build 80900) ---------------------------------------------------- Fixes: * UE4 - Fix for crash when using "Validate FMOD" menu item Notes: * PS4 - Now built with SDK 4.00 * XboxOne - Added better logging and documentation to describe an incorrectly configured appxmanifest regarding microphone recording. 04/10/16 1.08.13 - Studio API minor release (build 80479) ---------------------------------------------------- Fixes: * Studio API - Fixed potential crash after the following sequence of actions: load master bank, try to load master bank again and fail with FMOD_ERR_EVENT_ALREADY_LOADED, unload master bank, reload master bank. * Core API - Fix circular DSP connection causing hang in certain situations. * Unity 2 - Fix issues with multi-object editing of emitters. 22/09/16 1.08.12 - Studio API minor release (build 80229) ---------------------------------------------------- Features: * Unity 2 - Added ability to override minimum and maximum distance for Event emitters. * Unity 2 - Added support for multiple listeners. * Studio API - Added support for auto pitch at minimum. * Studio API - Added support for the global master bus being duplicated across banks. Fixes: * Studio API - Fix auto pitch cutting off at zero for parameter with minimum value that is less than zero. * Studio API - Fix events with a transciever effect not allowing the event to stop * Android - Fixed crash when loading FSBs or Banks that contain a sound that isn't mono, stereo, 5.1 or 7.1. * Android - Fixed compatibility issue with some devices introduced in previous release due to r12b update. Presents as a runtime linker error when loading the FMOD library, failing to locate __aeabi_atexit. * iOS - Fixed stuttering during fade out when device screen goes to sleep. * Core API - Fix FMOD_DSP_TRANSCEIVER memory stomp. * Core API - Fix channels playing at incorrect pitch. Introduced in 1.08.10. Notes: * Studio API - Incremented bank version, requires runtime 1.08.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Core API - Improved validation for ChannelGroup, DSP and Sound handles, detects invalid pointers and usage after release. 08/09/16 1.08.11 - Studio API minor release (build 79819) ---------------------------------------------------- Features: * Core API - PS3 - Added support for FMOD_DSP_CHANNELMIX. * Unity 2 - Respect Game View mute button. Fixes: * FSBank - Fix crash on 64-bit when encoding 16kHz or 24kHz sources using Vorbis at low quality settings. * Core API - Fix FMOD_SOUND_PCMSETPOS_CALLBACK getting invalid position value when a sound opened with FMOD_OPENUSER loops. * Core API - Android - Fixed crash on load with old devices when using armeabi. * Unity 2 - Fix CREATESOUNDEXINFO not getting marshalled properly. Notes: * Android - Now built with NDK r12b. * Android - Minimum Android version is now API level 9 due to NDK r12b deprecating older versions. 22/08/16 1.08.10 - Studio API minor release (build 79252) ---------------------------------------------------- Features: * Studio API - Improved performance of sidechain modulator. * Core API - Improved ChannelControl::setPitch accuracy between DSP clock and the underlying codec decoding speed. * Unity 2 - Added option for play-in-editor to reflect the active build target for loading banks. Fixes: * Core API - Fixed error trying to create a Return DSP when the system format is set to FMOD_SPEAKERMODE_RAW. * Core API - Fixed FFT DSP crash if window size is smaller than DSP block size. * Core API - Removed spurious warning messages when loading plugins on some platforms. * Core API - Android - Tweaked OpenSL auto detection, now requires device to specify low latency and a block size <= 1024. * Unity 2 - Fix bank import issues when the strings bank contains bank names that differ in case from the files on disk. * Unity 2 - Bank import now has a longer timeout after last detected file activity before starting import. * Unity 2 - Fixed settings screen allowing real channels to be set higher then 256. * Unity 2 - Fix up errors when StudioEventEmitter is created dynamically. * Unity 2 - Small fixes for the settings screen when overriding the parent platform settings. * UE4 - Fix for crash when previewing animations using the FMOD event notifier. Notes: * Core API - System::getSpeakerModeChannels returns the system channel count when passed FMOD_SPEAKERMODE_DEFAULT. Now works even if the system format is set to FMOD_SPEAKERMODE_RAW. * UE4 - Can be recompiled with 4.13 pre-release. * Documentation - Added documentation for FMOD_DSP_PAN enums. 01/08/16 1.08.09 - Studio API minor release (build 78489) ---------------------------------------------------- Features: * Core API - PS4 - Add support for social screen audio to the ports API. * Studio API - Added Studio::EventInstance:setListenerMask and Studio::EventInstance::getListenerMask, that adds the ability to specify which listeners apply to each event instance. * Unity 2 - Warning is now produced when playing in editor if the position of a 3D event is not set. * UE4 - Added blueprint functions to set event properties. Fixes: * Studio API - Fixed case of indeterminism when building banks that contain events with automation curves. * Core API - Fixed FMOD_OUTPUT_OBJECT3DINFO::gain so it only includes distance attenuation not bus gain (which is now pre-applied to FMOD_OUTPUT_OBJECT3DINFO::buffer. * Core API - Fixed channelmix DSP volume not always being initialized. * Core API - WiiU - Fixed potential crash during System::init if System::setDriver or System::setOutput has been called. * Core API - Fix hang on netstreams when the connection times out. * Core API - Linux - Fix FPU control word of the calling thread being modified when the FMOD dynamic library is loaded. * Core API - Android - Fixed potential crash if FMOD isn't loaded with System.loadLibrary, now a proper error will be issued. * FSBank API - Fixed FADPCM not looping seamlessly for non-zero crossing loops. * UE4 - Fixed plugin loading assuming a "lib" prefix for plugins on Android, Mac, Linux and PS4. Now plugin loading will attempt to load the name with and without adding a lib prefix. * UE4 - Respect FApp::IsUnattended for message-box errors. * UE4 - Fixed deprecation warnings about AttachTo usage. * Unity 2 - Fix errors when bank source files are updated while Event Browser preview is playing or paused. * Unity 2 - Fix unnecessary copying of Bank files in OSX editor. Notes: * Core API - Linux - Removed limit of 32 devices with ALSA output mode. * Core API - Incremented API version of Output plugins. Dynamic library plugins built with earlier versions of 1.08 will continue to load. 14/07/16 1.08.08 - Studio API minor release (build 77846) ---------------------------------------------------- Features: * UE4 - bMatchHardwareSampleRate will use the system default format to avoid excessively matching the output rate on mobile devices. * UE4 - Added bLockAllBuses which will force all buses to be created at startup, rather than on demand. Fixes: * Studio API - Fixed looping sounds in a multi sound playlist failing to stop if the multi sound itself is non-looping. * Studio API - Fixed rare crash calling the following functions while the bank containing the event is unloading: Studio::EventInstance::getDescription, Studio::EventInstance::getParameter, Studio::EventInstance::getParameterValue, Studio::EventInstance::setParameterValue, Studio::EventInstance::setParameterValueByIndex, Studio::EventInstance::triggerCue, Studio::ParameterInstance::getDescription and Studio::ParameterInstance::setValue. * Studio API - Fixed shared events becoming invalidated when one of the banks containing them is unloaded. Could also manifest as Studio::EventInstance::getDescription failing with FMOD_ERR_INTERNAL. * Studio API - Fixed crash that could occur when using FMOD_STUDIO_INIT_SYNCHRONOUS_UPDATE and calling Studio::System::update from multiple threads at the same time. * Studio API - Increased scheduling lookahead time to ensure sample accurate timeline scheduling even if there is an output stall. * Studio API - Fixed crash that could occur when improperly calling Studio::Bus::getChannelGroup without first calling Studio::Bus::lockChannelGroup, if the bus was being destroyed as the call was made. * Studio API - Fixed rare crash calling the following functions while the master bank containing the bus or VCA is unloading: Studio::System::getBus, Studio::System::getBusByID, Studio::System::getVCA and Studio::System::getVCAByID. * Studio API - Fixed rare timing issue where Studio::System::getEvent would succeed but Studio::EventDescription::createInstance would fail with FMOD_ERR_INTERNAL, if called just as the bank containing the event finished loading. * Studio API - Fixed rare hang in Studio::System::getBankCount when called while banks are currently unloading. * Core API - Fixed rare glitch at the start of XMA playback causing non-seamless looping. * Core API - Fixed rare hang on shutdown when using multiple systems. * Core API - Fix streams with an unknown file length remaining in the playing state after an end of file is encountered. * Core API - Windows - Enumeration of record devices will now reflect a change of default device with WASAPI output. * Core API - Linux - Enumeration will now correctly display GUIDs and speaker modes for ALSA output. * Core API - Linux - Fixed potential crash if both PulseAudio and ALSA are missing / unavailable. * Unity 2 - Fix plugin loading on Linux standalone builds. * Unity 2 - Fix script compilation errors in standalone builds. * Unity 2 - Fix Event Browser preview of events with built-in parameters. * Unity 2 - Fix missing tvOS files. Notes: * Core API - Significantly reduced memory consumption when using FMOD_DSP_FFT. * PS4 - Now built with SDK 3.508.101 * UE4 - Updated Oculus plugin to 1.0.4. 27/06/16 1.08.07 - Studio API minor release (build 77241) ---------------------------------------------------- Features: * FSBank API - Added support for Linux. * Unity 2 - Live Update and Debug Overlay can be set to only be enabled in standalone builds when the development build option is set. * Unity 2 - Add MuteAllEvents and PauseAllEvents functions to the RuntimeManager. * Unity 2 - Audio will now pause when the application pauses. * UE4 - Added MixerSuspend and MixerResume blueprint functions. * UE4 - Added IsBankLoaded blueprint function. Fixes: * Studio API - Fixed Studio command buffer assert and crash that could occur when using FMOD_STUDIO_INIT_SYNCHRONOUS_UPDATE in conjunction with multiple threads. * Core API - Fix crash when closing a system with a multi-plugin DLL still loaded. * Core API - iOS / Android - Improved audio stability when mixer thread is overloaded. * FSBank API - Fixed calling convention linker error on Windows in FSBankLib header. * FSBank API - Fixed issue when passing duplicate source files with different encoding settings would cause cache file conflicts. Notes: * Unity 2 - Renamed "Level Start" and "Level End" triggers to "Object Start" and "Object Destroy" to more accurately reflect when the triggers occur. 17/06/16 1.08.06 - Studio API minor release (build 76937) ---------------------------------------------------- Features: * Unity 2 - Added framework for registering native plugins on iOS and tvOS. * Unity 2 - Added support for importing Studio Banks as TextAssets so they can be added to Unity AssetBundles. Fixes: * Core API - Fixed crash on shutdown, after creating multiple systems and setting a system callback. * Core API - PS4 - Fix issues with calling FMOD_PS4_GetPadVolume() immediately after opening the controller audio port. 15/06/16 1.08.05 - Studio API minor release (build 76824) ---------------------------------------------------- Features: * Studio API - Added Studio::EventDescription::isSnapshot. * Unity 2 - Added "Preload Sample Data" checkbox to Event Emitter to reduce latency when emitters are triggered for the first time. * Unity 2 - Added script example to show how to build an asynchronous loading screen that includes loading FMOD Banks. Fixes: * Studio API - Fixed Studio::EventDescription::isOneshot() incorrectly returning true for snapshots. * Core API - Fix FMOD_ADVANCEDSETTINGS::maxADPCMCodecs not being applied. * Core API - Fix crash when using CreateSound from multiple threads (including FMOD Async loading threads). * Unity 2 - Fix issues when bank file in the Unity project Streaming Assets folder have a different case to the banks in the Studio project. * Unity 2 - Fix issues when editor log file cannot be opened because it's read only. * Unity 2 - If the "Load All" options are selected in the FMOD Settings then the main thread will now block until it's complete. * UE4 - Fix for OnEventStopped callback firing repeatedly if triggers the instance to play again. Notes: * Core API - All System, ChannelControl, ChannelGroup, Channel, and DSP API functions check for NaN and INF floats and return FMOD_ERR_INVALID_FLOAT if detected. * Studio API - All API functions check for NaN and INF floats and return FMOD_ERR_INVALID_FLOAT if detected. * Studio API - All API functions with output parameters now clear those values in the case of an error. Previously some values may have been left uninitialized. In the case of an error, int and float outputs are set to 0, bool outputs are set to false, and pointers are set to NULL. Structures are cleared to zeros, and string buffers are set to the empty string. 25/05/16 1.08.04 - Studio API minor release (build 76196) ---------------------------------------------------- Features: * Studio API - Added runtime support for steal quietest polyphony. * Core API - Improved performance when connecting sends and returns. * UE4 - FFMODEventInstance can now be stored as a blueprint variable. * UE4 - Added support for Occlusion. See the Occlusion section of the documentation for more information. * UE4 - Added support for Android deployment without having to modify the engine. * UE4 - Added InitialDriverOutputName to select output device by name at startup, as well as new Blueprint functions GetOutputDrivers, SetOutputDriverByName and SetOutputDriverByIndex. * UE4 - Added VCASetFaderLevel Blueprint function. * UE4 - "FMOD Validate" now checks for FMOD in the packaging setting, and can add it if needed. Fixes: * Core API - Fixed unnecessary DSP queue flush when using ports. * Core API - Fixed ADPCM and FADPCM compressed FSBs not returning FMOD_ERR_MEMORY_CANTPOINT when loaded as FMOD_OPENMEMORY_POINT FMOD_CREATESAMPLE. * Core API - Fix pops when channels with a mix matrix that are started virtual become real. * Core API - Fixed DSP panner reset not clearing ramps, causing ramping when setting initial parameters. * Core API - Fixed Sound::getSyncPointInfo returning first sync point info when loading sounds from FSBs with multiple sync points. * Studio API - Fixed memory stomp that can occur when sharing events between multiple banks, if a streaming sound is in the middle of loading when one of the shared banks is unloaded. * Unity 2 - Fix error messages when previewing an event contained in the Master Bank. * Unity 2 - Fix WinPhone 8.1 DLL's conflicting with UWP builds. Notes: * Studio API - Incremented bank version, requires runtime 1.08.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * UE4 - Updated ovrfmod to version 1.0.3. * UE4 - Tested with 4.12 pre-release, compiles successfully. * PS Vita - Now built with SDK 3.570.011. 05/05/16 1.08.03 - Studio API minor release (build 75571) ---------------------------------------------------- Features: * Studio API - Added FMOD_STUDIO_EVENT_CALLBACK_SOUND_PLAYED and FMOD_STUDIO_EVENT_CALLBACK_SOUND_STOPPED for when an event plays sounds. Sound names will only be available if banks have been re-exported in FMOD Studio 1.08.03 or later. See the music_callbacks example for demonstration. * Studio API - Added runtime support for the event cooldown property set from FMOD Studio. Events that fail to start due to cooldown time will invoke the FMOD_STUDIO_EVENT_CALLBACK_START_FAILED callback. * Core API - Improved performance of logging. * Core API - PS4 - Improved performance when profiling is enabled. Fixes: * Studio API - Events that fail to start due to bus polyphony now invoke the FMOD_STUDIO_EVENT_CALLBACK_START_FAILED callback. * Studio API - Fixed crash when calling Studio::System::unloadAll with crossfading nested events. * Studio API - Fixed unnecessary up/down mix applied to 2D events that have sidechain modulators. * Studio API - Fixed mixing issues and degraded performance if the system speaker mode does not match the Studio project format. * Studio API - Fixed case of stereo sounds panning hard right when downmixed to a mono track and later upmixed again, introduced in 1.07.04. * Core API - Fixed potential incorrect position when voice comes back from being virtual, which can cause a hang on XboxOne. * Core API - Improved handling for out of memory errors when mixing DSP buffers. * Core API - Fixed incorrect propagation of FMOD_DSP_STATE::channelmask when mixing signals with differing masks. * Core API - Fixed http streams (file from http, not shoutcast/icecast) returning FMOD_ERR_FORMAT. Introduced 1.08.01 * Core API - Fixed m3u playlist file format support. Was returning FMOD_ERR_FORMAT. * Core API - Android - Improved detection of low-latency devices allowing better automatic output mode selection and less stuttering. * Core API - Sound::getName will now return "" for sounds without names, instead of "(null)". * Core API - Object 3D Panning fix for silent objects in certain speaker modes * Studio API - More robust live update handshaking when attempting to connect with multiple copies of FMOD Studio at once. * Unity 2 - Added missing Studio::EventDescription::getSoundSize function. Notes: * Studio API - Incremented bank version, requires runtime 1.08.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Studio API - Sound names are now loaded into memory if they have been exported in the bank file. The option is on by default, which means by the runtime memory use might be slightly higher when loading banks exported from 1.08.03 and later. If this is a problem, make sure to disable the option to export sound names in FMOD Studio when re-exporting banks. * XboxOne - Now built with March 2016 QFE 1 XDK. * PS4 - Now built with SDK 3.508.031. 13/04/16 1.08.02 - Studio API minor release (build 74770) ---------------------------------------------------- Fixes: * UE4 - Fixed audio component transform not being updated in 4.11. * Studio API - Fixed unnecessary up/down mix applied to 2D events that have sidechain modulators. * Studio API - Studio::EventDescription::is3D now returns true if there is a plug-in panner on the master track. Notes: * UE4 - PS4 - Deployment uses standard unreal plugin system. * UE4 - Now built against Unreal 4.11 07/04/16 1.08.01 - Studio API minor release (build 74554) ---------------------------------------------------- Features: * Unity 2 - Added Universal Windows Application platform support. * Unity 2 - Added Find and Replace tool. * Core API - Improved performance when creating DSPs. * UE4 - Added FMOD stats for CPU usage. Fixes: * Studio API - Fixed errors being generated when the initial seek is past the loop end point of a sound. * Studio API - Fixed error loading sample data for banks loaded by Studio::System::loadBankMemory with FMOD_STUDIO_LOAD_BANK_DECOMPRESS_SAMPLES flag. * Studio API - Fixed rare Studio update error FMOD_ERR_NOTREADY when stopping modules with streaming sounds. * Studio API - Fixed unnecessary up/down mix on sidechain effects in game. * Studio API - Eliminated API stalls due to holding a lock when creating event instances on the Studio Update thread. * Studio API - Fixed error when loading an API capture that contains Studio::System::flushSampleLoading commands. * Studio API - PS4 - Fixed incorrect linking options on fmodstudio.prx that caused package creation to fail. * Core API - Fixed rare hang when rapidly creating and releasing Return DSPs. * Core API - Fixed hang or crash when loading a .it/s3m/mod/mid file as a decompressed sound. * Core API - Fixed some shoutcast streams playing back garbled. * Core API - Fixed Sound::readData returning 0 for bytes read, instead of a valid number if FMOD_ERR_FILE_EOF was returned. Introduced in 1.07.08. * Core API - PS4 - Fix AT9 playback when a sound created as looping is played with the channel loop-count explicitly set to zero before starting. * Core API - Win - Fixed ASIO device enumeration not supplying a GUID. * Core API - Win - Fixed ASIO device enumeration having a blank name if the device is not connected. * UE4 - Added lock around file accesses to avoid Unreal pak file thread safety issue. * UE4 - Fixed logging callback not being initialized. * UE4 - Avoid asset table system from mixing while normal mixer is in operation, to work around an AT9 mixer issue. * UE4 - Fixed always linking against ovrfmod even if it isn't present. * Unity 2 - Rewrote Timeline Callback and Programmer Sound Callback examples to work on iOS. * Unity 2 - Fix marshalling of FMOD.CREATESOUNDEXINFO structure on iOS. * Unity 2 - Fix DLL not found errors in standalone Windows builds. Notes: * Studio API - Incremented bank version, requires runtime 1.08.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Studio API - Studio::EventInstance::setPitch() now returns an error if a NaN is passed in. * Studio API - Errors that occur during the Studio update thread will no longer stop the thread. * Studio API - Studio will set the master channel group format to the project's format to avoid an extra upmix. 04/03/16 1.08.00 - Studio API major release (build 73609) ---------------------------------------------------- Features: * Studio API - Sample data loading has been optimised. Load time, file access, and memory use have all been substantially improved. A new entry has been added to the per platform thread affinity settings. * Studio API - FMOD_STUDIO_PARAMETER_DESCRIPTION now has the parameter index and default value. * Studio API - Added Studio::System::flushSampleLoading. * Studio API - Support for left edge trimming of timelocked sounds. * Studio API - Support for Start Offset as a percentage of sound length. * Studio API - Added idle resource pool to keep recently used sounds in memory in case they might be re-used. It can be controlled by the idleResourcePoolSize field in FMOD_STUDIO_ADVANCEDSETTINGS. See the Studio Banks Programmer Topic for more information. * Core API - Increased performance of System::createSound and System::createStream, since they no longer block against System::update. * Core API - Added filebuffersize to FMOD_CREATESOUNDEXINFO for customizable file buffering. * Core API - Added System::getFileUsage to query file loading information. * Core API - Custom DSP effects now always receive a buffer length that is equal to the mix block size. The input and output buffers will always be 16-byte aligned. Custom DSP sounds still have be able to generate signal less than a mix block. * Core API - Added getclock callback to FMOD_DSP_STATE_SYSTEMCALLBACKS to get the clock, offset and length for a custom DSP. * Core API - Added support for multiple plugins within one plugin file. See FMOD_PLUGINLIST, System::getNumNestedPlugins, System::getNestedPlugin, and the DSP Plugin API Programmer Topic for more information. * Core API - Added support for object based panning with two backend providers, Dolby Atmos (FMOD_OUTPUTTYPE_ATMOS) and Playstation VR (FMOD_OUTPUTTYPE_AUDIO3D). * Core API - Added 3D object panner DSP (FMOD_DSP_TYPE_OBJECTPAN) to be used with new object pan enabled outputs. * Core API - Extended output mode plugin API (FMOD_OUTPUT_DESCRIPTION) to allow custom object panner backends. * Core API - Win - Reduced WASAPI latency by 40ms and improved mixer thread regularity. * FSBank - AT9 Band Extension is now enabled by default for supported bit-rates. * FSBank - Added Mac versions of the FSBank tool and FSBankLib API. Included in the Mac and iOS API packages. * Profiler - Added Mac version of the Profiler tool. Included in the Mac and iOS API packages. * Unity 2 - Added ability to create new studio events from within the Unity editor. * Unity 2 - Improved event selection UI on emitter component and when using EventRef attribute. * Unity 2 - Added support for default parameter values in emitter component. Notes: * Studio API - Incremented bank version, requires runtime 1.08.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Studio API - New example 'object_pan' that demonstrates object based panning. * Studio API - Studio::EventDescription::getSampleLoadingState and Bank::getSampleLoadingState now return FMOD_STUDIO_LOADING_STATE_ERROR if sample data failed to load (e.g. due to a corrupt file). * Studio API - Removed Studio::CueInstance, Studio::EventInstance::getCue, Studio::EventInstance::getCueCount and Studio::EventInstance::getCueByIndex. Instead use new functions Studio::EventDescription::hasCue and Studio::EventInstance::triggerCue. * Studio API - Deprecated Studio::EventInstance::getParameter and Studio::EventInstance::getParameterByIndex. Instead use Studio::EventInstance::getParameterValue, Studio::EventInstance::setParameterValue, Studio::EventInstance::getParameterValueByIndex, and Studio::EventInstance::setParameterValueByIndex. * Studio API - Increased stack size for Studio threads to 64K. * Studio API - Played events will stay in the FMOD_STUDIO_PLAYBACK_STARTING state until their sample data has loaded. This avoids selected sounds in the event playing late if the sample data has not been preloaded. * Core API - System::getChannelsPlaying now returns the number of real and total channels playing. System::getChannelsReal has been removed. * FSBank - AT9 compression now requires AT9 library 1.7.1 (DLL version 2.8.0.5) or later. Compression in 32bit versions of FSBank is no longer supported in line with Sony's removal of 32bit compression libraries. 03/03/16 1.07.08 - Studio API patch release (build 73591) ---------------------------------------------------- Features: * Unity 2 - Importing banks has been speed up dramatically. Fixes: * Studio API - Fixed Studio::EventInstance::setProperty not restoring the default setting for FMOD_STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE and FMOD_STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE when a value of -1 is specified. * Studio API - Fixed case of mono sounds panning hard left when both mono and stereo 2D sounds are placed on the same event track, introduced in 1.07.04. * Core API - Fixed some net streams returning 'invalid parameter' introduced in 1.07.06. * Core API - Fixed potential crash if calling Sound::release soon after System::createSound with FMOD_NONBLOCKING and async IO callbacks. * Core API - Winstore/UWP - Fixed small memory leak on system shutdown. * Core API - Winstore/UWP - Fixed occasional crash when closing a socket with a pending asynchronous read. * Core API - Xbox One - Fixed potential hang waiting on XMA Sound::release if using async IO callbacks and a cancel was issued. * Core API - Android - Relaxed overly strict validation of M4A files introduced in 1.07.07. * Core API - Android - Fixed potential JNI_OnLoad failure introduced in 1.07.07. * Core API - Fix crash in convolution reverb if wet level is set to -80db and it has no inputs. * Core API - Fix seeking on stereo FADPCM compressed streams and samples. * Unity 2 - Errors opening log output file are no longer fatal. Notes: * Core API - Ensure FMOD_FILE_ASYNCDONE is called with FMOD_ERR_FILE_DISKEJECTED if implementing FMOD_FILE_ASYNCCANCEL_CALLBACK to notify FMOD that you will not be servicing the FMOD_ASYNCREADINFO::buffer. 16/02/16 1.07.07 - Studio API patch release (build 72710) ---------------------------------------------------- Features: * Core API - Win - Improved ASIO output to accept requested sample rate and buffer size instead of using defaults. * UE4 - FMOD Memory allocation now occurs via standard UE4 allocators. * Unity 2 - Added AppleTV support. Fixes: * Core API - Fixed System::loadPlugin not unloading the library file in the case of an error. * Core API - Fixed automatic format detection failing for some types when the file size is less than 1KB. * Core API - Fixed FMOD_CREATESOUNDEXINFO::suggestedsoundtype being ignored for FMOD_OPENMEMORY and FMOD_OPENMEMORY_POINT. * Core API - WinStore/UWP - Fixed occasional deadlock when removing the current output device. * Core API - Win - Fixed potential crash if switching output mode to ASIO after System::init. * Core API - Android - Fixed crash if MediaCodec processes a file that isn't an M4A file. * Core API - Android - Fixed Marshmallow devices being unable to load M4A files. * Unity 2 - Remove broken inspector code for ParamRef. * Unity 2 - Fix PS Vita. * Unity 2 - Small event reference UI rendering fixes. * Unity 2 - Fix unnecessary copying of files that haven't been modified. * Unity 2 - Fix issues with copying of files that have only been partially written by the Studio tool. * Unity 2 - Work around IL2CPP issues introduced in Unity 5.3.2p2. * Legacy Unity - Work around IL2CPP issues introduced in Unity 5.3.2p2. * Unity 2 - Xbox One - Fix runtime errors when using Mono AOT compilation. Notes: * Unity 2 - Unity 5.3.2p1 is not supported for iOS. * Legacy Unity - Unity 5.3.2p1 is not supported for iOS. 27/01/16 1.07.06 - Studio API patch release (build 71893) ---------------------------------------------------- Features: * Studio API - Improved CPU and IO performance when capturing API commands via Studio profiler. * Core API - Android - Lollipop devices may now select 7.1 with AudioTrack output mode. Older devices will gracefully fall back to stereo. * Unity 2 - Emitter gizmos are now pickable in the scene view. * Unity 2 - Event Browser layout changed to work in narrow windows. Note the Event Browser windows will need to be closed and re-opened for new minimum bounds to take effect. * Unity 2 - Added bitcode support for iOS. * UE4 - Added support for programmer sounds. See the new UE4 Programmer Sound page for more information. Fixes: * Core API - Fixed bug if streams start virtual, they may not come back as audible. Introduced in 1.07.00 * Core API - Update URL in Netstream example. * Core API - Fixed net streams not working when server delivers shoutcast with chunked HTTP data. * Core API - Fixed memory leak when a network connection fails. * Core API - Android - Devices that don't support 5.1 output will now gracefully fallback to stereo. * Core API - WinStore / UWP - Fixed WASAPI output so it return the correct 'no drivers' error when none are detected. * Core API - WinStore / UWP - Fixed WASAPI output swapped sides and rears in 7.1. * Core API - Fix C# wrapper of ChannelGroup.addGroup missing arguments. * Core API - Fix crash when using chorus effect on a channel group with channel count greater than the system channel count. * Core API - PS4 - Fix validation of thread affinity settings. * Core API - iOS - Fixed compatibility issue introduced in 1.07.02 for old devices running iOS 6.X. * Unity 2 - Fixed UI when EventRef attribute is used on an array of strings. * Unity 2 - Work around DLL loading issues on some standalone Windows builds. * Unity 2 - Fix DLL loading issues for play-in-editor when platform is iOS. * Unity 2 - Fix RuntimeManager being recreated during shutdown and leaking FMOD native instances. * Unity 2 - Fix issue when using RuntimeManager.LowLevelSystem and RuntimeManager.StudioSystem before RuntimeManager has initialized. * Unity 2 - Increase channels for Play-In-Editor. * Unity 2 - Fix play-in-editor not setting the speaker mode correctly. * Unity 2 - PS4 - Fix script compile errors. Notes: * Xbox One - Now built with November 2015 XDK. * iOS - Now built with iOS SDK 9.2 and tvOS SDK 9.1 (Xcode 7.2). * UE4 - Updated Oculus plugin for 1.0.1. 07/01/15 1.07.05 - Studio API patch release (build 71238) ---------------------------------------------------- Features: * Unity 2 - When using the file browser in the settings editor to set the Studio source paths the result will be set relative to the Unity project if it is a sub-directory. * Unity 2 - Added Parameter Trigger component. Fixes: * Core API - UWP - Fixed FMOD_SYSTEM_CALLBACK_DEVICELISTCHANGED not firing when the default output device changes. * Core API - PS3 - Fix rare crash with reverb. * Core API - PS3 - Fix static and audio dropouts if speaker mode is forced to stereo (normally it is 7.1). Notes: * iOS - Reduced binary size. * Android - Added calling convention to public API to allow usage with hard float ABI. 11/12/15 1.07.04 - Studio API patch release (build 70728) ---------------------------------------------------- Features: * Core API - Better support for sounds with channel/speaker masks, ie a 1 channel sound specified as LFE, or a quad sound specified as LRCS instead of 2 front 2 back for example. * Unity 2 - Added optional debug overlay. * Unity 2 - Added migration steps for data in custom components. * Unity 2 - Added support for Unity 4.6. * Unity 2 - Added support for Android split binary. * Unity Legacy - Added support for Android split binary. Fixes: * Studio API - Fixed blocking bank loads stalling for longer than necessary when other threads are constantly issuing new Studio commands. * Core API - Fixed corrupted playback for big endian PCM FSBs. * Core API - Fixed crash when switching channel count of generator DSPs during playback. * Core API - PS3 - Fix crash reallocating buffers on flange effect. * Core API - Xbox One - Fixed rare stall when playing XMA streams and compressed samples at the same time. * Core API - Fix crash if the Master Channel Group head DSP was set inactive right after initialization. * Core API - Fix Sound::getOpenState() moving from FMOD_OPENSTATE_PLAYING too early on some streaming sounds. * Core API - Fix Sound::Release() freeing memory still in use by the mixer. * Core API - Fix convolution reverb not correctly producing tails on long impulse responses when it has no input. * Unity 2 - Fixed issue with plugins not being loaded correctly. * Unity 2 - Work around DLL loading issues on some standalone Windows builds. * Unity 2 - Fix leaking system objects leading to ERR_MEMORY. * Unity 2 - Updated signature of DSP::setWetDryMix, DSP::getWetDryMix. Notes: * Core API - FMOD_DSP_STATE::channelmask is now passed down through the dsp chain so plugin developers can see the original signal channel format even if a sound was upmixed. 17/11/15 1.07.03 - Studio API patch release (build 69975) ---------------------------------------------------- Features: * Core API - When using System::recordStart the provided FMOD::Sound can now be any channel count, up/down mixing will be performed as necessary. * Core API - Improved performance of convolution reverb effect when wet is 0 or input goes idle. * Core API - PS4 - Added FMOD_THREAD_CORE6 to allow access to the newly unlocked 7th core. * Core API - PS4 - Added FMOD_PS4_GetPadVolume() to retrieve the output volume of the pad speaker as set by the user in the system software. * Core API - Added FMOD_DSP_TYPE_TRANSCEIVER. Send signals from multiple sources to a single 'channel' (out of 32 global 'channels') and receieve from that or any channel from multiple receivers. Great for receiving and broadcasting a submix from multiple 3d locations (amongst other uses). * Unity - FMOD_StudioSystem.GetEvent() can now be used with snapshot paths. * Unity - Ignore OSX resource fork files when importing from FAT32 file systems. * UE4 - Deployment will also copy any plugins listed in a file plugins.txt in the FMODStudio/Binaries/Platform directory. See the Using Plugins page for more information. * UE4 - Console platforms set up thread affinity in FMODPlatformSystemSetup. Fixes: * Studio API - Fixed snapshot applied to VCA level not working in game. * Studio API - Fixed profiler session timing when recording a game with a non-standard sample rate. * Studio API - PS4 - Fix linker error in examples. * Core API - Fixed buffer overrun when convolution reverb is set up with mismatched input and output channels. * Core API - Fix crash with invalid .mp3 files. * Core API - Fix Sound::getName() not returning a valid UTF8 string when loading a sound with ID3 tags specifying the title as a latin1 string. * Core API - Fix pops in flange and chorus effects. * Core API - Fix crash when using flange effect on a channel group with channel count greater than the system channel count. * Core API - FLAC - Fix crash when seeking in certain flac files. * Core API - Android - Automatic selection of OpenSL output mode will now be stricter to reduce stuttering on devices that incorrectly report they are low latency. * Core API - PS4 - Fix signal not being routed back to the main output when detaching a channel group from a port. * Core API - Fix FMOD_ADVANCEDSETTINGS::reverb3Dinstance not working. Notes: * Android - Now built with NDK r10e. * PS Vita - Now built with SDK 3.550. * Core API - FMOD_DSP_CHANNELGAIN_OUTPUT_DEFAULT ... FMOD_DSP_CHANNELGAIN_OUTPUT_ALLLFE (from the FMOD_DSP_CHANNELMIX_OUTPUT enum) have been renamed to FMOD_DSP_CHANNELMIX_OUTPUT_DEFAULT ... FMOD_DSP_CHANNELMIX_OUTPUT_ALLLFE (ie CHANNELGAIN renamed to CHANNELMIX) to fit with the correct naming convention. Rename required if using this effect. 02/11/15 1.07.02 - Studio API patch release (build 69450) ---------------------------------------------------- Important: * AppleTV platform support is now part of the iOS package. Features: * Core API - Improved performance of System::getChannelsPlaying. * Core API - Added System::getChannelsReal to get the number of non-virtual playing channels. Fixes: * Studio API - Fixed internal error during playback caused by inaccuracies in quantization calculation when timeline position is greater than 5 minutes. * Core API - Fix mixer not running if mixer sample rate is lower than output sample rate. * Core API - Fix Sound::getOpenState returning FMOD_OPENSTATE_READY when a sounded ended, when it should have returned FMOD_OPENSTATE_PLAYING for a bit longer, which meant Sound::release could stall. * Core API - iOS - Fixed output being mono on some devices, minimum detected hardware channel count is now 2 to ensure stereo. Notes: * iOS - Now built with iOS SDK 9.1 and tvOS SDK 9.0 (Xcode 7.1). * Mac - Now built with SDK 10.11 (Xcode 7.1). 27/10/15 1.07.01 - Studio API patch release (build 69235) ---------------------------------------------------- Features: * Studio API - Added support for multiple parameter conditions. * Studio API - Added Studio::EventDescription::getSoundSize. * UE4 - Added validation help menu option to diagnose common issues. Fixes: * Studio API - Fixed auto-pitch, cutoff and looping not live updating properly. * Core API - Fixed potential crash on ARM platforms when seeking Vorbis compressed FSBs. * Core API - Fix ChannelGroup::setReverbProperties from returning FMOD_ERR_REVERB_CHANNELGROUP if a child channel had a reverb connection previously. * Core API - Fixed FMOD_CREATESOUNDEXINFO::suggestedsoundtype being ignored if a custom codec of higher priority has been registered. * Core API - Fixed System::getRecordNumDrivers incorrectly reporting 0 if called within 1 second of application start on some platforms. * Core API - Fixed stereo AIFF files producing static. * Core API - Xbox One - Fixed rare crash for stereo XMA streams. * Core API - iOS - Fixed MP3 decoding being performed by FMOD cross-platform decoder instead of native AudioQueue. * Core API - Fix mp3 crash seeking, introduced in 1.07.00 if using certain types of MP3 file in FMOD_CREATECOMPRESSEDSAMPLE mode. * Unity - Change Android to read banks straight from APK * Unity - Will automatically append a "64" suffix to plugins if required. * Unity - Fix OSX bundles having incorrect settings * Unity - Fix compatibility with Unity 5.2.2 * Unity - Fix crashes when creating a standalone OSX build. * UE4 - Fix for audio component direction not being set into FMOD. * UE4 - Fixed IOS deployment error "libfmod does not exist" Notes: * Studio API - The FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_CREATED and FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_DESTROYED callbacks now fire from nested events, for both plugin effects and plugin sounds. * Studio API - For the FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES callback argument, the 'name' field will contain just the user defined name of the plugin sound if one has been set. Otherwise it will be empty. You can use the 'dsp' field to determine the plugin type. * Studio API - Programmer sounds with no name will have an empty string for FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES.name, previously it was an arbitrary hex sequence. * Core API - Plugin developers - FMOD_DSP_SYSTEM_GETSPEAKERMODE added to FMOD_DSP_STATE_SYSTEMCALLBACKS. Plugin SDK version updated to 1.07 meaning plugins created from this point onwards wont work with older versions of FMOD. * Android - Replaced all Eclipse examples with Visual Studio using NVIDIA Nsight Tegra integration. * PS4 - Now built with SDK 3.008.041 * PS3 - Now built with SDK 475.001. 05/10/15 1.07.00 - Studio API minor release (build 68517) ---------------------------------------------------- Important: * Studio is now a 64-bit application. All plugin libraries must be built for 64-bit architecture to be compatible with the 64-bit version of the tool. * Added Universal Windows Platform (UWP) support. * Added AppleTV platform support. Contact support@fmod.org for beta access. Features: * Studio API - Support for bus polyphony. * Studio API - Added FMOD_STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE and FMOD_STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE to override the minimum and maximum panner distance for an instance. * Studio API - Added FMOD_STUDIO_INIT_DEFERRED_CALLBACKS to defer event callbacks to the main thread. See Studio::EventInstance::setCallback for more information. * Core API - Added FMOD_DSP_TYPE_CHANNELMIX effect. Allows user to control gain levels for up to 32 input channel signals, and pipe the output to a range of speaker formats i.e. repeating mono, stereo, quad, 5.1, 7.1 or only LFE out. * Core API - Improved CPU performance when using metering or profiling. * Core API - Added support for loading multi-channel FSBs with the FMOD_CREATECOMPRESSEDSAMPLE flag. * Core API - Improved record driver enumeration, list is now persistent, removed devices will remain to ensure record IDs stay valid. See record_enumeration example for new functionality. * Core API - Added full record device add/removal detection for Windows, Mac, Xbox 360, Xbox One, PS3 and PS4. * Core API - Reduced recording latency on Windows, XboxOne and PS4. * Core API - Mac - Added support for recording from multiple microphones at the same time. * Core API - Win - Improved CPU performance for FSB Vorbis decoding. See Performance Reference section of the documentation for updated benchmark results. * Core API - iOS - Added support for bitcode. Fixes: * Studio API - Fixed the scatterer module's random distance calculation to ensure it is within the limit set in Studio. In previous versions the random distance may have exceeded the max limit. This change may affect the loudness of sounds with scatterer modules compared to 1.06.xx releases. * Core API - Fix rare crash when releasing a streamed sound. * Core API - Fix output plugins with GUIDs of zero stopping setDriver working. * Core API - PS3 - Fixed send/returns not respecting volume changes or rarely failing with an error when setting return IDs. * Core API - PS4 - Rewrote output to use sceAudioOutOutputs instead of multiple sceAudioOutOutput calls on a single thread. * Core API - Win - Fixed the audible output driver from resetting when an unrelated device is removed or disabled. * Core API - Xbox One - Fixed the first couple of samples of decoded XMA being lost due to SHAPE SRC. Notes: * Studio API - Incremented bank version, requires runtime 1.07.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Studio API - Improved compatibility for plugin effects. Adding extra DSP parameters to an effect no longer breaks bank version compatibility. * Studio API - Studio::Bank::getEventCount and Studio::Bank::getEventList only return events directly added to the bank, not implicit events that are included in the bank due to event instrument references. * Studio API - The asynchronous command buffer for the Studio API will now grow as necessary, avoiding stalls that could occur if it was too small. The commandQueueSize field in FMOD_STUDIO_ADVANCEDSETTINGS now specifies the initial size of the buffer. * Studio API - Studio now enables FMOD_INIT_VOL0_BECOMES_VIRTUAL by default. * Studio API - WinStore - Fixed inconsistent naming of X64 libraries. * Core API - Increased FMOD_MAX_LISTENERS from 5 to 8. * Core API - System::getCPUUsage update time now includes the metering and profiling part of the update. * Core API - Removed support for FSB Vorbis files built using FMOD Ex 4.42 or earlier. * Core API - PS4 - Changed default mix buffer size to 512 samples to reduce CPU cost. Previous setting of 256 can be set using System::setDSPBufferSize. * Core API - PS4 - The size of each pre-allocated AT9 instance has increased by 8kB. * Core API - PS4 - Prebuilt static libraries are no longer provided, only dynamic libraries. * Core API - WinStore - Fixed inconsistent naming of X64 libraries. 05/10/15 1.06.11 - Studio API patch release (build 68487) ---------------------------------------------------- Features: * Win - Reduced dll and exe sizes. Fixes: * Studio API - Fixed input buses not being released when there are no longer any event instances routed into the bus. * Studio API - Fixed API capture recording the initial VCA level as 0. * Core API - Fix rare crash when changing the master channel group head DSP when the software format and system output don't match. * Core API - Fix Channel::AddDSP() and ChannelGroup::AddDSP() not correctly moving a DSP if it's already a member. * Core API - Fix for noise being produced when panning a surround input when the system format doesn't match the panner input format. * Unity - FMOD RNG seed set at initialization time. * Unity - Can now properly cancel the copy step of the import process. * Unity - Updated documentation links in menu. Notes: * iOS - Now built with SDK 9.0 (Xcode 7.0). * Mac - Now built with SDK 10.11 (Xcode 7.0). 15/09/15 1.06.10 - Studio API patch release (build 67958) ---------------------------------------------------- Features: * Core API - Add Sound::seekData support to HTTP streams. * UE4 - Added blueprint functions for loading and unloading sample data. Fixes: * Core API - Fix small reverb pop on sounds that had Channel::setPosition called on then and were muted via a parent channelgroup. * Core API - Fix https netstream redirects not working. * Core API - Fix user DSP read callback firing with no data if Channel::setPaused(false) is used after a System::playSound. * Studio API - Fixed Trigger Delay not being applied to sounds on parameters that trigger immediately when an event starts. Notes: * Xbox One - Now built with August 2015 XDK. 01/09/15 1.06.09 - Studio API patch release (build 67431) ---------------------------------------------------- Features: * Studio API - Additional logging when banks have been exported with out of date plugin effects. Fixes: * Core API - Fix automatic device changing support if a user called System::update from their own thread. * Core API - Fix crash when a channel group cannot be attached to port. * Core API - Fixed incorrect loop length being set for ADPCM files. * Core API - Win64 - Enable automatic device changing support. * Core API - iOS - Fixed error creating the file thread on iOS 9.0. * Core API - Fix distance filtering not resetting its parameters properly for channels. * Core API - MIDI support - Fix note keyoff when evelope is in decay phase causing note to finish early. * Studio API - Fix crash that could occur when auditioning an event in Studio while changing the path to waveforms. Notes: * UE4 - Updated oculus rift plugin to version 0.11 12/08/15 1.06.08 - Studio API patch release (build 66772) ---------------------------------------------------- Features: * UE4 - Added FMOD init settings. * UE4 - Added preliminary support for 4.9 engine preview build. * Core API - Add Channel::setPosition support to HTTP streams. Fixes: * Core API - Fixed System::getDefaultMixMatrix crashing if passed FMOD_SPEAKERMODE_RAW. Now returns FMOD_ERR_INVALID_PARAM. * Core API - Xbox One - Fixed crash if all SHAPE contexts are consumed. * Core API - Xbox One - Fixed XMA loops not being seamless. * Studio API - Fixed potential crash when disconnecting from live update while recording a profiling session. * Studio API - WiiU - Fixed hang on shutdown when exiting game from home menu. * Core API - Fix for inaccurate metering levels when the calculation spanned multiple mix blocks. * Core API - Fixed System::getRecordPosition race condition that could cause the returned value to be out of bounds. * Unity - Fixed missing functionality from C# wrapper for beat callbacks and metering. * Unity - Fix leaking native system objects in editor. * UE4 - Fixed multiple listeners. * FSBank - Fixed crash encoding FADPCM format in 64bit version of tool. Notes: * Studio API - Reduced memory usage for instruments that do not require up/down mix. * Core API - Improved performance of DSP::getParameterFloat, DSP::getParameterInt, DSP::getParameterBool and DSP::getParameterData when 'valuestr' argument is NULL. 22/07/15 1.06.07 - Studio API patch release (build 66161) ---------------------------------------------------- Fixes: * Core API - Win - Fix audio glitches at initialization time when using the WASAPI output mode on Windows 10. * Core API - Fix UTF8 strings in MP3 ID3V2 tags not being null terminated properly leading to possible string overflow crash. * Core API - PS4 - Fixed issue with non-1024 sample aligned loop-points and AT9 compressed samples. * Core API - Fixed memory leak when releasing connections that have a user allocated mix matrix. * Core API - Added pre-wet and post-wet arguments to WetDryMix in C# wrapper. * Core API - Fixed crash with FADPCM streams. * Core API - Fixed another potential crash in PitchShifter DSP if changing channel count while running. * Core API - Win - Fix issues caused by WASAPI allocating the output buffer at the mixer's sample rate instead of the device's sample rate. * Studio API - XboxOne - Fix setting the thread affinity of the studio loading thread. * Studio API - Fixed case of nested events on parameters being stopped while still active. Introduced in 1.06.04. Notes: * Studio API - Incremented bank version, requires runtime 1.06.06 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Core API - XboxOne - Thread affinity can now be set as a mask of allowed cores. 08/07/15 1.06.06 - Studio API patch release (build 65638) ---------------------------------------------------- Features: * Core API - Added FMOD_DSP_COMPRESSOR_LINKED parameter to DSP compressor. Fixes: * Studio API - Fixed potential invalid memory access when a bank is unloaded while create instance commands are queued. * Studio API - Removed one frame delay between setting a parameter and having conditional timeline transitions occur. * Studio API - Studio gracefully handles the case of a programmer sound being returned in a streaming not-ready state when the instrument is being used with timelocked seeks. * Core API - Fixed rare crash when streams go virtual. * Core API - Fixed 3EQ DSP not waiting an extra mix block before going idle, possibly cutting off a tail. * Core API - Fixed potential crash in PitchShifter DSP if changing channel count or FFT size while running. * Core API - Fixed rare volume pop when ramping with fade points as a channel goes emulated. * Core API - Linux - Fixed record position not advancing with ALSA output mode. * Core API - Fix race condition when setting the impulse response on an active convolution reverb DSP. * Unity - Fix compatibility with Unity 5.1 24/06/15 1.06.05 - Studio API patch release (build 65161) ---------------------------------------------------- Features: * Studio API - Added FMOD_STUDIO_LOAD_BANK_DECOMPRESS_SAMPLES flag to force bank sample data to decompress into memory, saving CPU on low end platforms. * Studio API - Improved responsiveness when reducing steal oldest polyphony over live update. * Studio API - Studio profiling now includes nested instance information. * UE4 - Exposed beat and marker callbacks as Blueprint events. Fixes: * Studio API - Fixed Scatterer sounds having incorrect volume when min and max scatter distances are equal. Introduced in 1.06.00. * Studio API - Fixed FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES position to return the beat position, rather than the tempo marker position. * Studio API - Fix deadlock in studio when removing an output device that runs at a different sample rate to the system. * Studio API - Fix deadlock in studio when removing certain USB headsets. * Core API - Fixed rare case of DSP mixer not responding momentarily if output mode was switched during playback. * Core API - Fix declaration of DSP.getMeteringInfo in C# wrapper. Notes: * UE4 - Now built against Unreal 4.8 09/06/15 1.06.04 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added tempo and marker event callbacks. See FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_MARKER and FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_BEAT. * Core API - Add FMOD_DSP_DESCRIPTION::sys_register, sys_deregister and sys_mix for DSP plugin developers, to allow a per type (not instance) level init/shutdown/mix callback for a plugin. Fixes: * Core API - Fixed MIDI playback not correctly handling CC1 (mod wheel). * Studio API - Fixed livelock when scheduling nested events in a playlist that have 0 duration. * Studio API - Fixed events staying active when they have active but idle nested events on parameters. Events now finish once their nested parameter events go idle. * Studio API - Fixed Scatterer sounds not being spatialized properly. Introduced in 1.06.00. * FSBank - Fix bug that prevented selection of FMOD ADPCM in the tool. * Core API - Fix set3DPanLevel not respecting reverb mix when pan level was approaching 0. * Core API - Fix 2d channels not having the wet mix scaled for reverb when parent ChannelGroup volume/mute functions were called. * Unity - Remove warnings about banks already loaded * Unity - Fix Unity Editor crashing when using FMOD_LIVEUPDATE and FMOD_DEBUG pre-processor commands simultaneously. Notes: * Studio API - Incremented bank version, requires runtime 1.06.00 or later. * Studio API - Latest runtime supports loading old bank versions from 1.03.00. * Studio API - Added a warning for events that haven't finished because they are waiting for a DSP effect to go idle. * Core API - WiiU - To comply with LotCheck requirements only the logging version of FMOD will link with networking APIs * Xbox One - Now built with May 2015 QFE 1 XDK. * WiiU - Now built with SDK 2.12.13. 22/05/15 1.06.03 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Reduced memory overhead of bank metadata. Fixes: * Studio API - Fixed steal oldest polyphony behaviour using instance creation instead of instance start time. * Studio API - Fixed playlist instrument cutoff not applying a volume ramp down which could cause pops when using polyphony. * Core API - Fixed invalid memory access when loading an incorrectly formatted or truncated IMA ADPCM wav file using FMOD_OPENMEMORY_POINT and FMOD_CREATECOMPRESSEDSAMPLE. * Core API - Fix rare crash due to race condition when calling Sound::Release() just after the sound has been loaded using NON_BLOCKING. * Core API - PS3 - Fix deadlock in streaming when using SPU Threads. * Core API - Attempting to attach the Master ChannelGroup to a port will now return FMOD_ERR_INVALID_PARAM. * Core API - PS4 - Fix issues with recording at rates other than the driver default. * Core API - Fix crash in DSPFader when voice goes virtual with DSP effect added at a position lower than the fader (ie post fader), and the effect is freed. * UE4 Integration - Fixed incorrect listener orientation. Notes: * Studio API - Changed envelope follower DSP sidechain parameter to ignore invalid values. * Xbox One - Now built with April 2015 XDK. * 7.1 to 5.1 downmix now lowers the volumes of the back speakers' contribution to the surround speakers by 1.5db to lessen volume bulge in the middle. 06/05/15 1.06.02 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Sounds on parameters that are cross-fading in will now apply a ramp volume up to the initial cross-fade value. This avoids pops even if the sound has been improperly authored. * UE4 Integration - Added support for Reverb zones. * UE4 Integration - Exposed Studio::EventInstance::getTimelinePosition and Studio::EventInstance::setTimelinePosition as blueprint functions. Fixes: * Studio API - Fixed transition timeline modules not crossfading their volume properly when overlapping the lead out region. * Studio API - Fixed C# wrapper not linking against 64bit dll when WIN64 is defined. * Studio API - Fixed events with sidechains never naturally stopping. * Studio API - Fixed runtime crash caused by a compiler bug for customers compiling from source using VS2015 CTP. * Core API - WiiU - Fixed incorrect pitch for DRC if System is running a rate other than 48KHz or 32KHz. * Core API - PS4 - Fix small memory leak when closing output ports. * Core API - Fixed documentation regarding FMOD_DSP_COMPRESSOR_USESIDECHAIN and FMOD_DSP_ENVELOPEFOLLOWER_USESIDECHAIN. * Core API - WinStore - Fix System::Init() freezing when called from the UI thread. * UE4 Integration - Fixed bad editor performance when selecting audio components. * UE4 Integration - Fixed several Android deployment issues. * Unity Integration - Fix compilation issues on iOS when using IL2CPP. * Unity Integration - Logging libs for OSX are now included. Defining FMOD_DEBUG will now route FMOD internal logging to the Unity console in the OSX editor and standalone OSX builds. * Unity Integration - Make members of the REVERB_PROPERTIES structure public. * Unity Integration - Fix compile error on XBox One when defining FMOD_DEBUG. Notes: * UE4 Integration - Merged documentation with main API documentation. 17/04/15 1.06.01 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added FMOD_STUDIO_EVENT_CALLBACK_CREATED, FMOD_STUDIO_EVENT_CALLBACK_DESTROYED and FMOD_STUDIO_EVENT_CALLBACK_START_FAILED callback types. * Studio API - Exposed FMOD_STUDIO_EVENT_PROPERTY_SCHEDULE_DELAY and FMOD_STUDIO_EVENT_PROPERTY_SCHEDULE_LOOKAHEAD as advanced properties that can be set per instance. Fixes: * Core API - Fixed Channel userdata not being reset to 0 each playSound. * Core API - Fixed the C# wrapper for DSP.AddInput and DSP.disconnectFrom. * Core API - PS4 - Fixed playback issue with AT9 compressed samples that have a non-zero loop start point. * Core API - Fix rare issues with generator DSPs or compressed channels getting stuck looping the same fragment of audio. * Core API - PS3 - Fix rare crash if sound stops on a channelgroup with a matrix set in it. * Unity Integration - Fix banks not being loaded on standalone OSX builds. * Unity Integration - Logging libs for windows are now included. Defining FMOD_DEBUG will now route FMOD internal logging to the Unity console in the Windows editor and standalone Windows builds. Notes: * PS4 - Now built with SDK 2.508.051. 10/04/15 1.06.00 - Studio API minor release ---------------------------------------------------- Important: * Studio API - Scatterer sounds now steal the oldest spawned sound if the polyphony limit has been reached when spawning a new sound. Features: * Added new compression format FADPCM as a higher quality, lower CPU cost drop in replacement for standard IMA ADPCM. This custom developed format is our new recommendation for mobile, PS Vita and Wii U delivered exclusively via FSB. * Core API - Improved CPU performance of convolution reverb by 30% * Core API - Android - Improved latency by automatically resampling to the native rate to enable the fast mixer. * Core API - PS Vita - Removed requirement to use 48KHz mixing, default is now 24KHz for better performance. * Core API - Xbox One - Optimized performance for looping compressed XMA. * Core API - Xbox One - Added support for greater than stereo XMA streams. * Core API - Xbox One - Reduced output latency by 20ms. * Studio API - Significantly reduced memory usage. * Studio API - Added Studio bank loading thread. * Studio API - Added Studio::Bank::getUserData and Studio::Bank::setUserData. * Studio API - Added FMOD_STUDIO_SYSTEM_CALLBACK_BANK_UNLOAD callback. * Studio API - Support for transition timeline lead-in and lead-out. * Studio API - Added support for setting Studio async update period via FMOD_STUDIO_ADVANCEDSETTINGS. * Core API - PS4 - Added support for High Quality Recording API by default. Fixes: * Studio API - Fixed parameter modulation being unable to go below the value set from the public API. * Studio API - Fixed effect bypass setting not being saved to banks. Notes: * Studio API - The C# wrapper now uses System.Guid instead of FMOD.GUID. * Studio API - Default command buffer size has been increased to 32K. * Studio API - Studio::System::setListenerAttributes and Studio::System::getListenerAttributes now take a listener index in preparation for multiple listener support. * Studio API - Deprecated Studio::ID typedef. Please use FMOD_GUID type. * Studio API - Changed FMOD_STUDIO_EVENT_CALLBACK_TYPE from an enum to a bitfield. Added 'callbackmask' parameter to Studio::EventDescription::setCallback and Studio::EventInstance::setCallback. * Studio API - Studio::System::startRecordCommands and Studio::System::stopRecordCommands has been renamed to Studio::System::startCommandCapture and Studio::System::stopCommandCapture. * Studio API - Studio::System::playbackCommands has been renamed to Studio::System::loadCommandReplay and now returns a CommandReplay object. * Studio API - Schedule delay and look-ahead has been reduced for Studio async mode. This reduces latency and improves responsiveness of events to parameter changes. * Core API - System::set3DListenerAttributes checks for invalid arguments in release. * Core API - Thread safety no longer uses a command queue for deferring selected API functions until the next update. The queue of deferred functions was most often flushed by a subsequent getter function or other setter function anyway. * Core API - Added 'numconnected' to System::getRecordNumDrivers and 'state' to System::getRecordDriverInfo in preperation for changes to how recording device removal is handled. Currently 'numconnected' will equal 'numdrivers' and 'state' will be FMOD_DRIVER_STATE_CONNECTED. * Core API - Some of the FMOD_PAN_ types have been renamed FMOD_DSP_PAN_ for consistency. * Core API - Calling ChannelControl::getAudibility on a ChannelGroup now returns the combined audibility of itself and the parent audibility. 02/04/15 1.05.15 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Win - Fixed occasional deadlock when removing audio devices. * Core API - Fixed stream crackling if initialseekposition was used immediately followed by Channel::setPosition with a close position value. * Core API - PS3 - Fixed six or eight channels vorbis streams crashing the SPU. * Core API - Xbox One - Fixed rare hang when decoding small XMA compressed audio. * Core API - Fixed DSP::getInfo not returning configwidth and confighheight information for VST plugins. * Core API - Fixed rare crash calling DSP::reset on the fader DSP, after ChannelGroup::setPan/setMixLevelsOutput/setMixMatrix. This could occur when a Studio event is started or stopped. * Core API - PS4 - Fixed issue with non-1024 sample aligned loop-points and AT9 compressed samples. * Core API - Fixed DSP effect being un-removable with FMOD_ERR_DSP_INUSE after being added to a channel and the channel stops (becoming invalid). Notes: * PS3 - Now built with SDK 470.001. 16/03/15 1.05.14 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Fixed some cases where channel group audibility was not refreshed when fade points are active. This could happen when a Studio event instance is paused and unpaused. * Core API - PS3 - Fixed FMOD_PS3_INITFLAGS overlapping FMOD_INITFLAGS causing certain FMOD_INITFLAGS to affect PS3 specific bit-stream encoding options. * Core API - PS3 - Fixed a rare hang when releasing a DSP that exposes a FMOD_DSP_PARAMETER_OVERALLGAIN parameter. * Core API - PS3 - Fixed opening URL failing with network streams. * Core API - Xbox One - Fixed recording API, you can now specify any sample rate to record at. Native rate of 48KHz is still recommended for lowest latency. * Studio API - Fixed virtualized event failing to become real if the number of playing instances drops back below max polyphony. Notes: * Core API - PS3 - Deprecated FMOD_PS3_EXTRADRIVERDATA::initflags. Due to a bug it was being ignored. Pass the flags to System::init instead. 25/02/15 1.05.13 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Studio::System::getBank now accepts bank filenames as input. * Core API - Added 64bit versions of fsbank and fsbankcl tools. Fixes: * Studio API - Fixed case of nested event not being destroyed even after it had finished producing sound. * Studio API - Fixed crash when changing output bus on an event when live update is connected. * Studio API - Fixed deadlock when calling Studio commands when mixer is suspended. * Studio API - System::release now ensures release even if flushing pending commands causes an error. * Studio API - The name of the string bank is now added to the string bank. * Studio API - Event instance restart now flushes parameter values before timeline rescheduling occurs. This avoids a potential issue for transitions with parameter conditions, where they may not have used the most recent parameter value. * Core API - Fix unnecessary querying of recording driver capabilities during recording. * Core API - PS4 - Remove AT9 workaround added in 1.05.12. Fix AT9 compressed codecs with finite loop counts. * Core API - PS4 - Removed stalls when an AT9 compressed sample channel is started. * Core API - PS4 - Fix crash in recording. * Core API - Fix multiple listener support not working properly. * Core API - Fix user file crash if using asyncfileread callback, and file open and close happens without any read occuring. * Core API - Fix rare crash with Sound::release if a nonblocking setPosition is in process and it is an FSB sound. * Core API - Fix thread safety issue loading multiple mod/s3m/xm/it files simultaneously. * Core API - Fix rare crash if FMOD_ACCURATETIME was used with .mp3 file followed by mp3 encoded FSB file after a time, both using FMOD_CREATECOMPRESSEDSAMPLE. * Core API - PS3 - Fixed custom DSP that use the plugindata member. Notes: * Studio API - Updated programmer_sound example. * Core API - Added plug-in inspector example. * Xbox One - Now built with February 2015 XDK. 06/02/15 1.05.12 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Improved memory use for events with repeated nested events. Fixes: * Studio API - Fixed crash when stopping multiple one-shot events on a bus. * Studio API - Fixed nested event polyphony from cutting off immediately, causing pops. * Core API - Fixed rare crash in mixer if DSP::reset is called on a FMOD_DSP_TYPE_FADER dsp (ie ChannelControl head DSP) after DSP::setPan/setMixLevelsOutput/setMixMatrix. * Core API - Fixed race condition setting resampling speed while resampling is occurring. * Core API - Fixed crash loading mod/s3m/xm/it file using FMOD_NONBLOCKING and FMOD_CREATECOMPRESSEDSAMPLE and then immediately calling SoundI::release * Core API - PS4 - Work around AT9 codec issues that have appeared when using SDK 2.000 22/01/15 1.05.11 - Studio API patch release ---------------------------------------------------- Features: * Core API - Xbox One - Added access to 7th CPU core. Fixes: * Studio API - Fixed crash setting Studio event callback to null as it is being invoked. * Studio API - Fixed crash in hashmap reallocation when running out of memory. * Studio API - Fixed Studio::loadBankCustom from freeing its custom userdata before the close callback for failed banks. * Studio API - If FMOD_OUTTPUTTYPE_WAVWRITER_NRT or NOSOUND_NRT is used as an output mode, Studio runtime will now internally force FMOD_STUDIO_INIT_SYNCHRONOUS_UPDATE to avoid a hang. * Core API - Fix pop noise when 3d sound goes virtual then becomes real again, only if ChannelControl::addDSP was used. Notes: * Studio API - Studio::EventInstance::getPlaybackState will now return the state as FMOD_STUDIO_PLAYBACK_STOPPED if the instance is invalid. * Studio API - Studio::Bank::getLoadingState, Studio::Bank::getSampleLoadingState, and Studio::EventDescription::getSampleLoadingState will now return the state as FMOD_STUDIO_LOADING_STATE_UNLOADED if the object is invalid. 12/01/15 1.05.10 - Studio API patch release ---------------------------------------------------- Features: * Core API - Xbox One - Added support for recording from microphones. Fixes: * Core API - PS3 - Fix deadlock in streaming sounds when linking against the SPU thread libraries. * Core API - Windows - Fixed crash when initializing a second ASIO system. * Core API - Fix ChannelControl::getDSPIndex not returning an error if the dsp did not belong in the Channel or ChannelGroup * Core API - PS3 - Fix linker error when using libfmod_sputhreads.a * Core API - Fixed AT9 and ACP XMA incorrectly allowing FMOD_OPENMEMORY_POINT and FMOD_CREATESAMPLE. * Core API - Fixed reverb wetlevel from ChannelControl::setReverbProperties being reset after a voice goes virtual then returns as real. * Core API - Fixed removing/adding DSPs in a ChannelControl chain copying setDelay commands incorrectly and making channels pause when they shouldnt * Studio API - Reinstated support for embedded loop points in source sounds, and fixed issue with playback of timelocked sounds. 12/12/14 1.05.09 - Studio API patch release ---------------------------------------------------- Features: * Core API - Added System::registerOutput to allow the creation of statically linked custom output modes. Fixes: * Studio API - Fixed looping event cursor position from getting slightly out of sync with scheduled position when running at 44.1kHz. * Studio API - Fixed playlist steal-oldest polyphony returning errors when used with extremely small durations. * Studio API - Fixed silence after unpausing an event instance. Introduced in 1.05.08. * Core API - Fixed crash after setting the input format of a Return DSP to stereo, when the mixer output format is mono. * Core API - Windows - Fix crash calling FMOD_ASYNCREADINFO::done function pointer when default calling convention is not cdecl. * Core API - Fixed FMOD_SPEAKERMODE_RAW panning incorrectly during an up or down mix. * Core API - Fix crash when a Channel::setPosition is called on a non-blocking stream that is going virtual. * Core API - Fixed potential audio corruption when playing sounds with more than 8 channels. * Core API - Fixed emulated channels not updating their parent when when Channel::setChannelGroup is called. * Core API - Fixed channels having their volume reset when changing channel group parents. * Core API - Fixed channels not going virtual when being paused if no other volume changes were occurring. * Core API - Fixed FMOD_INIT_PROFILE_ENABLE enabling all DSP metering regardless of whether FMOD_INIT_PROFILE_METER_ALL was used. * Core API - Added volume ramp up for 3d channels coming back from virtual to real. * Core API - Fixed rare crash if the master channelgroup's DSP Head unit was changed then released. * Core API - PS3 - Fix loudness meter not functioning. * Core API - PS3 - Re-enabled playDSP. Notes: * Core API - Xbox One - Added check to ensure DSP buffer size is specified as the default 512 samples to avoid performance degradation of XMA decoding. * Core API - Windows - Changed default ASIO speaker mapping to 1:1 for outputs with more than 8 channels. 28/11/14 1.05.08 - Studio API patch release ---------------------------------------------------- Features: * Core API - Added ChannelControl::setFadePointRamp helper function that automatically adds a volume ramp using fade points. Fixes: * Studio API - Fixed pops that could occur when stopping events that have instruments scheduled to stop already. * Studio API - Fixed pop that could occur when playing an sound that has an AHDSR fade in. * Studio API - Fixed indeterminism when exporting string banks that have multiple string entries with inconsistent case. * Core API - Android - Improved compatibility with Java 1.6. * Core API - iOS - Added armv7s back to the universal binary. * Core API - Windows - Fix System::getRecordDriverInfo returning incorrect device names. Introduced in 1.05.00. * Core API - Fix FMOD_SPEAKERMODE_RAW creating silence if playing more than 1 sound, introduced in 1.04.15. * Core API - Fix CELT and Vorbis FSB being allowed with FMOD_OPENMEMORY_POINT and FMOD_CREATESAMPLE when it should in fact return FMOD_ERR_MEMORY_CANTPOINT 21/11/14 1.05.07 - Studio API patch release ---------------------------------------------------- Important: * Studio API - Fixed scheduling for looping nested events which are cut off from the parent event. Previously the looping nested event would attempt to play to end but would cut off halfway through with a noticeable click. The nested event now cuts off immediately with a fade out ramp. Features: * Core API - Android - Added ARM64 support. Fixes: * Core API - Fix ChannelGroup::setMixLevelsOutput causing corrupted audio when the channel group has an input with a channel count greater than the system channel count. * Core API - Fixed ChannelControl::setMute not refreshing channel audibility. * Core API - Windows - Fix calls to DSP::getInfo() from within a custom DSP deadlocking the system during audio device change. * Core API - Fixed some DSP configurations with an idle first input causing signal to be downmixed to mono. * Core API - Fix invalid characters being printed in log messages when open certain types of media files. * Studio API - Fixed Studio::Bank::getEventCount and Studio::Bank::getEventList incorrectly enumerating nested events. * Studio API - Fixed Studio::Bus::stopAllEvents not working when snapshots or nested events are playing. * Studio API - Fixed "state->mInstanceCount > 0" assert that could occur when instruments were stopped repeated times. Notes: * PS Vita - Now built with SDK 3.300. * WiiU - Now built with SDK 2.11.13. 13/11/14 1.05.06 - Studio API patch release ---------------------------------------------------- Features: * Core API - Windows - Add 64bit VST support Fixes: * Studio API - Fixed thread safety issue when accessing sound tables as new banks with sound tables are being added. * Studio API - Fixed duplicate streaming sounds keeping playing when unloading the memory bank that it is streaming from. Now the stream will stop if the memory bank is unloaded. * Core API - Fixed sound going mono in certain DSP configurations. Introduced 1.05.00. * Core API - Fixed rare timing issue with fade points that caused the fader DSP to generate invalid floats. * Core API - Android - Fixed crashes due to insufficient stack size when running ART instead of Dalvik. * Core API - Windows - Fixed potential crash if using multiple FMOD::System with ASIO output mode. This is not supported by ASIO and is now disabled. * Core API - Linux - Fixed PulseAudio device enumeration not placing the default device at position 0. Notes: * Xbox One - Now built with November 2014 XDK. * Android - Now built with NDK r10c. * iOS - Now built with SDK 8.1 (Xcode 6.1). * Mac - Now built with SDK 10.10 (Xcode 6.1). * PS4 - Now built with SDK 2.000.071 30/10/14 1.05.05 - Studio API patch release ---------------------------------------------------- Features: * Core API - Added convolution reverb example. Fixes: * Studio API - Fixed various errors after deleting objects via Live Update * Studio API - Fixed possible crash using shared waveforms across multiple banks after some of the duplicate banks have been unloaded. * Studio API - Fixed duplicate events becoming invalidated when the first bank that contains them is unloaded. * Studio API - Fixed bug in load_banks example. * Studio API - Fixed crash when calling Studio::Bus::stopAllEvents while playing event instances that have had release called. * Core API - Fixed memory leaks. 22/10/14 1.05.04 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed transition markers failing at the start of the timeline. * Core API - PS3/X360/Wii-U - Fix vorbis seek getting stuck in an infinite loop. * Core API - Fixed incorrect behaviour when changing the channel mode from 3D to 2D. * FSBank - Fixed setting the cache directory and printing log messages. Notes: * Studio API - Timeline transitions can be chained together with no delay. 13/10/14 1.05.03 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added Studio::Bus::lockChannelGroup and Studio::Bus::unlockChannelGroup. Fixes: * Studio API - Fixed event fadeout cutting off DSP effects with long tails. * Studio API - Fixed crash when accessing events with a lifetime across duplicate banks. Note that when unloading the initial bank for an event, that event will be invalidated. * Core API - Fixed for enum mismatches in C# wrapper. * Core API - Fixed FMOD_DSP_LOWPASS click when being reused, ie stopping then starting a new sound. * Core API - Fixed rare hang during Sound::release for sounds created as FMOD_NONBLOCKING. * Core API - Fixed corrupted playback of MOD/S3M/XM/IT/MID sequenced formats. Introduced 1.04.05 * Core API - Fixed ChannelGroup::setReverbProperties on the master channel group causing a stack overflow. This is now disallowed as it creates a circular dependency. * Core API - Mac - Replaced error condition if initializing FMOD before activating the AudioSession with a TTY warning. * Core API - Android - Fixed Sound::readData going forever when reading AAC audio. * Core API - Fix the pancallbacks member of the FMOD_DSP_STATE_SYSTEMCALLBACKS structure passed into custom DSP callbacks being NULL. * Core API - Fix crash in mixer if user used System::playDSP and made the dsp inactive with DSP::setByPass or DSP::setActive 01/10/14 1.05.02 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed a bug where event sounds could have incorrectly synchronized playback. * Core API - Fixed compiler warning in public header. * Studio API - Disabled embedded loop points on all sounds played by the Studio API to fix incorrect playback of timelocked sounds. * Studio API - Snapshot volumes are now interpolated in terms of linear gain. * Core API - Fixed 3EQ DSP not clearing out internal state when DSP::reset is called, potentially causing audible artifacts when reused. * Core API - Fixed resampler inaccuracies when reading partial looping data. * Core API - Mac - CoreAudio output mode will now allow any DSP block size and will correctly use the desired buffer count. * Core API - Mac - CoreAudio now correctly exposes its output AudioUnit via the System::getOutputHandle function. * Core API - PS3 - Fixed resampler strict aliasing bug on PPU release builds. * Core API - PS3 - Fixed playDSP crash. * Core API - Fixed convolution reverb input downmix * Core API - Greatly increase speed of mixing multichannel source data. Notes: * Studio API - Loudness meters saved in banks will now be bypassed to improve performance when profiler isn't attached. * Xbox One - Now built with September 2014 QFE 1 XDK. 22/09/14 1.05.01 - Studio API patch release ---------------------------------------------------- Important: * Fixed possible large memory blowout if certain DSP pools were exceeded. Features: * Core API - Added FMOD_SYSTEM_CALLBACK_PREUPDATE and FMOD_SYSTEM_CALLBACK_POSTUPDATE callbacks. * Core API - iOS - Added support for multichannel output via accessory. Fixes: * Studio API - Implemented Studio::Bus::stopAllEvents. * Studio API - Fixed bus going silent when output format is stereo and system speaker mode is 5.1. * Studio API - Fixed Studio::System::getAdvancedSettings clearing FMOD_STUDIO_ADVANCEDSETTINGS.cbSize and not returning default values. * Studio API - Fixed a bug where looping or sustaining events could incorrectly be treated as oneshot. * Studio API - Fixed a bug where event sounds could have incorrectly synchronized playback. * Core API - Fix bug with custom 3D rolloff curve points getting corrupted. * Core API - Fixed incorrect documentation for FMOD_CHANNELCONTROL_CALLBACK. * Core API - Fix sub-mix channel count being incorrect when playing multiple sounds with different channel counts together. Introduced in 1.04 * Core API - Fix a channel DSP head's ChannelFormat not being reset if a sound with a channel mask was played on it previously Notes: * iOS - Now built with SDK 8.0 (Xcode 6.0). * Mac - Now built with SDK 10.9 (Xcode 6.0). 09/09/14 1.05.00 - Studio API minor release ---------------------------------------------------- Important: * Studio API - Studio::MixerStrip has been replaced by Studio::Bus and Studio::VCA. The new classes do not have a release method, as their handles remain valid until the bank containing them is unloaded. * Studio API - Studio::System::getEvent, Studio::System::getBus, Studio::System::getVCA, and Studio::System::getBank now take a string path. Functions that take an ID are now named Studio::System::getEventByID, Studio::System::getBusByID, Studio::System::getVCAByID, and Studio::System::getBankByID. * Studio API - Studio::EventInstance::release no longer invalidates the handle immediately. The handle remains valid until the event stops and is actually destroyed. In addition, this function now succeeds even if the event will not stop naturally. * Studio API - Events with sounds triggered by parameters will now stop rather than going idle when all sounds have finished and the timeline cursor has reached the end. * Core API - The wide string argument of System::getDriverInfo() and System::getRecordDriverInfo() has been removed. These functions now return UTF-8 encoded strings. * Core API - FMOD_UNICODE flag for System::createSound() and System::createStream() has been removed. These functions now accept UTF-8 encoded file names to load sounds with non-ASCII characters on Windows, PS3, PS4, PS Vita, XBox One, iOS, Android, Mac, Linux, Windows Phone, and Windows Store. * FSBank API - FSBANK_INIT_UNICODE flag has been removed. All file name structure members and function arguments now accept UTF-8 encoded strings. Features: * Studio API - Added FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_CREATED and FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_DESTROYED callback types. * Studio API - Added Studio::Bank::getStringCount and Studio::Bank::getStringInfo. * Core API - Added FMOD::Debug_Initialize to configure the destination and level of debug logging when using the logging version of FMOD. This is a more flexible replacement for the previous FMOD::Debug_SetLevel API. * Core API - Android - Added support for playing AAC files (requires Android 4.2). * Core API - Android - Reduced latency for devices that support FastMixer, see "Basic Information" section of the docs CHM for details. * Core API - Added DSP::setWetDryMix so any effect can have generic wet/dry signal level control. * Core API - Added 3D ChannelGroup support. A ChannelGroup is a 'group bus' and it can now be positioned in 3d space, affecting the mix for buses and channels below it. 3D Cones, geometry etc all work. Use ChannelGroup::setMode(FMOD_3D) to enable a 3D ChannelGroup. Fixes: * Studio API - Fixed transitions to the end of a loop region failing to escape the loop. * Studio API - Fixed sends inside events occasionally having a brief period of full volume when the event is started. * Core API - Fix for crash when creating multiple Systems with profiling enabled. Notes: * Studio API - Transition regions no longer include the end of their range. * Studio API - FMOD_ERR_EVENT_WONT_STOP has been removed. * Studio API - Studio::EventInstance::start now resets all DSPs inside the event to prevent incorrect ramping. This relies on FMOD_DSP_RESET_CALLBACK leaving public parameters unchanged. * Studio API - Studio::System::getEvent's unimplemented mode parameter has been removed, along with FMOD_STUDIO_LOADING_MODE. * Studio API - FMOD_STUDIO_PLAYBACK_IDLE and FMOD_STUDIO_EVENT_CALLBACK_IDLE have been removed. * Studio API - Removed deprecated function Studio::EventInstance::createSubEvent. * Core API - Changed FMOD_FILE_ASYNCCANCEL_CALLBACK to take FMOD_ASYNCREADINFO structure rather than void *handle. * Core API - The FMOD_DSP_RESET_CALLBACK documentation has been updated to make it clear that it should leave public parameters unchanged. * Core API - PS4 - Thread affinity can now be set as a mask of allowed cores. * Core API - iOS / Mac - Reduced default block size to 512 for lower latency. * Core API - Android - Renamed Java interface from FMODAudioDevice to simply FMOD, i.e. org.fmod.FMOD.init(). * Core API - Channel::setMode moved to ChannelControl::setMode so that ChannelGroups can now also have 2D/3D mode bits set. 09/09/14 1.04.08 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed crash when a second system is created but never initialized. * Studio API - Fixed a few ordering issues that can cause binary changes in identical banks. * Core API - Fix for pop due to unwanted volume ramping after calling DSP::reset on fader DSP. This can happen when a Studio event instance is stopped and then restarted. Caused by timing issue with ChannelControl::setVolumeRamp. * Core API - Fix crash if FMOD_DSP_TYPE_MIXER or DSP with no read/process function is passed to System::playDSP. * Core API - iOS - Fixed MP2 files being intercepted by AudioQueue causing an internal error. * Core API - XboxOne - Fixed network connect not resolving host names and not honoring the requested time out. * Core API - Fix rare crash if calling Channel::stop() which a non blocking Channel::setPosition is happening with a stream. * Core API - Winphone and Windows Store Apps - fixed detection of socket errors. * Core API - If a user DSP is added after the master ChannelGroup's fader that changes the output channel count to something other than the software mixer's channel count, stuttering could occur. Fixed. * Studio API - Windows - Fixed Studio API functions deadlocking when in asynchronous mode and a sound device is removed. * Core API - PS3 - Fixed some DSP parameter sets being ignored (overwritten by SPU DMA) * Core API - Fix System::playDSP not working with custom DSP effects that use the read callback * Core API - Added Memory.Initialize function to the C# wrapper. * Core API - Fixed incorrect truncation of FMOD_CREATECOMPRESSEDSAMPLE sounds created from MP3 or MP2 files (does not affect FSB). * Core API - Fixed FMOD_ACCURATETIME for FMOD_CREATECOMPRESSEDSAMPLE sounds created from MP3 or MP2 files (does not affect FSB). Notes: * Core API - The master ChannelGroup's fader/head now is not responsible for up or downmixing the signal. It is now done beyond the dsp tree, internally within FMOD. The Master ChannelGroup's Fader can still be forced to upmix if required with DSP::setChannelFormat. 20/08/14 1.04.07 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed an internal error when instantiating a snapshot that exposes intensity as a parameter. * Core API - PS3 - Fix audio dropout/corruption when using FMOD_SPEAKERMODE_STEREO. Usually when sidechain is involved. * Core API - iOS - Fixed System::recordStart returning FMOD_ERR_RECORD. * Core API - Fixed possible click noise on end of sound if using FMOD_CREATECOMPRESSEDSAPMLE or PCM on PS3. Notes: * Xbox One - Now built with July 2014 QFE1 XDK. * PS4 - Now built with SDK 1.750.061 06/08/14 1.04.06 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES.subsoundIndex to support non-blocking loading of FSB subsounds. * Core API - Windows - FMOD now handles sound card removal and insertion without any programmer intervention. If System::setCallback is called with FMOD_SYSTEM_CALLBACK_DEVICELISTCHANGED bit set, this feature is disabled. * Core API - Windows - System::setOutput can be called post-init now, allowing dynamic switching between any output mode at runtime. * Core API - iOS - Improved IMA ADPCM decoding performance especially for arm64 variant. Fixes: * Core API - Fixed bug where channels with post-fader DSP units would not play after transitioning from virtual to real. * Core API - Fix pops with resampler on loops. * Core API - Fix playDSP returning FMOD_ERR_DSP_SILENCE or FMOD_ERR_DSP_DONTPROCESS if the dsp played returned that during query mode. * Core API - PS3 - Fix ITEcho, SFXReverb, FFT DSP effects rarely getting parameters reset to old values. * Core API - Xbox One - Fixed audio corruption when playing mono streams from an XMA FSB that has both mono and stereo subsounds. * Core API - PS3 - Moved vorbis decode work during stream setPosition to the SPU. * Core API - Windows - Fix System::setSoftwareFormat with differing samplerate and speaker mode causing static. * FSBank API - Fixed cache being incorrectly reused when replacing source files of identical name with a different file that has an old time stamp. Notes: * PS3 - Now built with SDK 460.001 25/07/14 1.04.05 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fix for pop when stopping events with FMOD_STUDIO_STOP_ALLOWFADEOUT. * Studio API - Fix incorrect scheduling when Multi Sounds contain nested events with timeline transitions. * Studio API - Fix for nested event modules not being cleaned up when used in a playlist module. * Studio API - Fix for events failing to stop when they have instruments on parameters that have Hold enabled. * Core API - Fix combined volume ramp and fade point ramp having an incorrect volume. * Core API - Fix for pop when setting zero volume with vol0virtual enabled. * Core API - Fix for pop when scheduling fade point ramps in the past. * Core API - Fix for pop on a return bus when all incoming sends go idle. * Core API - Fix for faders delaying going idle for a mix when volume is set to zero without ramping. * Core API - Fixed FSB forwards compatibility issue causing load failures. * Core API - XboxOne - Fixed ACP race condition when shutting down / initializing System causing XMA channels to not play. * Core API - XboxOne - Fixed XMA compressed sample channel leak that would eventually result in all sounds playing emulated (silent). * Core API - WinPhone and WSA - Fixed network connection not respecting system timeout value. * Core API - PS3 - Fix IMA ADPCM support for ps3 not working. * Core API - iOS - Fixed potential duplicate symbol error on link. Notes: * Xbox One - Now built with July 2014 XDK. * iOS - Now built with SDK 7.1 (Xcode 5.1.1). 11/07/14 1.04.04 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed a bug where quantized timeline transitions could fail to play the audio at the destination marker. * Core API - Fix channel stealing not calling end callback in playDSP case. * Core API - Fix rare crash if System::playDSP is called, and it steals a channel with a sound on it, and System::update wasnt called in between. * Core API - Mac, iOS and Android - Improved network error reporting. 08/07/14 1.04.03 - Studio API patch release ---------------------------------------------------- Features: * Core API - Added FMOD_ADVANCEDSETTINGS.randomSeed, which specifies a seed value that FMOD will use to initialize its internal random number generators. Fixes: * Studio API - Changed isValid() functions in C# wrapper to call through to C++. * Studio API - Fixed Studio::System::loadBankCustom file callbacks being ignored when System::setFileSystem is using async read functions. * Studio API - Fixed incorrect playback when starting an event instance immediately after creating it. * Studio API - Fixed some snapshot types causing silence on busses if loading files older than those created with FMOD Studio 1.04.02. * Core API - Fixed incorrect FMOD_ASYNCREADINFO.offset value passed to FMOD_FILE_ASYNCREAD_CALLBACK when file buffering is disabled. * Core API - Windows - Fixed WASAPI failing to initialize on certain old drivers. * Core API - Fix FMOD_SPEAKERMODE_RAW being broken. * Core API - Fixed System::set3DRolloffCallback not working. * Core API - Fixed Sound::set3DCustomRolloff not working. * Core API - Fix Geometry API not running in its own thread like it was in FMOD Ex. * Core API - Fixed incorrect DSP clock when re-routing a ChannelGroup immediately after adding DSPs to it. * Profiler - Fixed nodes appearing to overlap each other if multiple outputs were involved. * Core API - PS4 - Fixed unnecessary file reads when playing an AT9 stream. 27/06/14 1.04.02 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed incorrect virtualization of events that have more than one 3D position dependent effect. * Studio API - Studio::EventDescription::getInstanceList, Studio::Bank::getEventList, Studio::Bank::getMixerStripList and Studio::System::getBankList now accept a capacity of 0. * Core API - Fixed a race condition that could lead to DSP graph changes not being handled correctly. * Core API - Linux - Fixed "spurious thread death event" messages appearing when attached with GDB. * Core API - Linux - Fixed internal PulseAudio assert if System::getNumDrivers or System::getDriverInfo is used before System::init. * Core API - Linux - Fixed ALSA not using correct default driver in some cases. * Core API - Send levels set before connecting the Return DSP are now applied immediately rather than fading in over a short time. 19/06/14 1.04.01 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added event playback states FMOD_STUDIO_PLAYBACK_STARTING and FMOD_STUDIO_PLAYBACK_STOPPING. FMOD_STUDIO_PLAYBACK_STARTING will be returned after Studio::EventInstance::start until the event actually starts. FMOD_STUDIO_PLAYBACK_STOPPING will be returned after Studio::EventInstance::stop until the event actually stops. * Core API - PS4 - Added support for background music that cannot be broadcast. Fixes: * Studio API - Fixed playlist module upmixing to system speakermode when playing multiple overlapping sounds. * Core API - Fix streams opened with FMOD_NONBLOCKING from playing at the incorrect position if they go virtual shortly after setPosition is called. * Core API - Fix EOF detection in file system causing rare extra file read past end of file. * Core API - Fix some FMOD_CREATECOMPRESSEDSOUND based samples finishing early if they were playing back at a low sample rate. * Core API - Fix a bug where DSP nodes could get stuck in an inactive state after setting pitch to 0. 11/06/14 1.04.00 - Studio API minor release ---------------------------------------------------- Important: * Added PS3 platform support. * Added WiiU platform support using SDK 2.10.04. * Added Linux platform support. * Added Windows Phone 8.1 platform support. * FMOD_HARDWARE and FMOD_SOFTWARE flags have been removed. All voices are software mixed in FMOD Studio. Features: * Studio API - Added Studio::System::getSoundInfo for accessing sound table entries * Studio API - Added Studio::EventInstance::setProperty, Studio::EventInstance::getProperty and FMOD_STUDIO_EVENT_PROPERTY_CHANNELPRIORITY * Studio API - Added doppler effect support * Studio API - Added libfmodstudio.a import library for MinGW/Cygwin. C API only, C++ linking not supported. * Core API - Improved DSP mixing performance by about 30% * Core API - Added new System callback type FMOD_SYSTEM_CALLBACK_THREADDESTROYED. * Core API - System::attachChannelGroupToPort now has an argument to allow signal to be passed to main mix. Fixes: * Studio API - Fixed nested events never ending if they have a parameter with non-zero seek speed. * Studio API - Fixed AHDSR modulation on snapshot intensity * Core API - Fixed incorrect fader interpolation when reparenting channels with propagate clocks. * Core API - Win - Fixed several issues with ASIO playback. * Core API - Android - Fixed audio corruption on devices without NEON support. * Core API - Fixed FMOD_CREATESOUNDEXINFO.length being handled incorrectly for memory sounds. This length represents the amount of data to access starting at the specified fileoffset. * Core API - Fix truncated FSB causing zero length subsounds, now returns FMOD_ERR_FILE_BAD Notes: * Core API - Renamed C# wrapper SYSTEM_CALLBACKTYPE to SYSTEM_CALLBACK_TYPE so it matches the C++ API. * Core API - Renamed MinGW/Cygwin import library to libfmod.a * Studio API - Deprecated C# wrapper functions Studio.Factory.System_Create and Studio.System.init have been removed. Use Studio.System.create and Studio.System.initialize instead. * Studio API - Deprecated function Studio::EventInstance::getLoadingState has been removed. Use Studio::EventDescription::getSampleLoadingState instead. * Studio API - FMOD_STUDIO_EVENT_CALLBACK now takes an FMOD_STUDIO_EVENTINSTANCE* parameter. * Xbox One - Now built with June 2014 XDK. 29/05/14 1.03.09 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed truncation error when loading sample data from bank opened with Studio::System::loadBankMemory. * Studio API - Fixed numerical error when blending multiple snapshots with zero intensity. * Studio API - Fixed incorrect pitch when an instrument has a non-zero base pitch combined with pitch automation or modulation. * Core API - Xbox One - Fixed potential seeking inaccuracies with XMA sounds. * Core API - Fix occasional audio pops when starting a channel or channel group. * Core API - Fix crash when running out of memory during channel group creation. * Core API - Fixed the C# wrapper for Sound.setDefaults and Sound.getDefaults. Notes: * Studio API - C# wrapper now takes care of setting the FMOD_STUDIO_ADVANCEDSETTINGS.cbSize and FMOD_STUDIO_BANK_INFO.size fields. * Core API - C# wrapper now takes care of setting the FMOD_ADVANCEDSETTINGS.cbSize and FMOD_CREATESOUNDEXINFO.cbsize fields. * PS Vita - Now built with SDK 3.150.021. 21/05/14 1.03.08 - Studio API patch release ---------------------------------------------------- Features: * Core API - Add FMOD_INIT_ASYNCREAD_FAST and FMOD_ASYNCREADINFO.done method, to improve performance of asyncread callback significantly. Instead of setting 'result', call 'done' function pointer instead. * Core API - Multiple channel groups can now be attached to the same output port. * Core API - PS4 - Minor performance improvements in AT9 decoding using new SDK features. Fixes: * Core API - Windows Store - Fixed networking issues. * Core API - Windows Store - Fixed System::getRecordDriverInfo() returning incorrect number of channels. * Core API - Fix System::setFileSystem asyncread callback not setting priority values properly. * Core API - Releasing a channel group attached to an auxiliary output port now cleans up resources correctly. * Core API - Channel groups attached to an auxiliary output port can now be added as children of other channel groups. * Core API - Fix DSPConnection::setMix() not being applied properly. * Core API - PS Vita - Fixed potential crash during System::init if any output related pre-init APIs are used, such as System::getNumDrivers. * Core API - PS Vita - Fixed crash if an attempt is made to load AT9 FSBs as a compressed sample, for PS Vita this is a streaming only format. * Core API - Xbox One - Small improvement to XMA performance. * Core API - Fixed the C# wrapper for System.playDSP. * Core API - Fixed potential crash on ARM platforms when loading an FSB. Notes: * PS4 - Now built with SDK 1.700. * Android - Now built with NDK r9d. 08/05/14 1.03.07 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Improved performance for projects with many events. * Studio API - Improved memory usage for projects with many bus instances. * Studio API - Added Studio::System::setCallback, Studio::System::setUserData and Studio::System::getUserData. * Core API - Added gapless_playback example for scheduling/setDelay usage. * Core API - Improved performance of logging build. * Core API - Added FMOD_SYSTEM_CALLBACK_MIDMIX callback. Fixes: * Studio API - Fixed AHDSR Release not working when timelocked sounds are stopped by a parameter condition. * Studio API - Removed some unnecessary file seeks. * Studio API - Fixed AHDSR Release resetting to Sustain value when instruments with limited Max Voices are stopped repeatedly. * Studio API - Fixed channels within paused events not going virtual. * Studio API - Fixed AHDSR Release not working inside nested events * Core API - Fixed downmixing to a quad speaker setup. * Core API - Fixed fsb peak volume levels on big endian platforms. * Core API - Fixed paused channels not going virtual. 17/04/14 1.03.06 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Improved performance of automation and modulation Fixes: * Studio API - Fixed crash when creating new automation via LiveUpdate * Studio API - Fixed possible internal error being returned from Studio::Bank::getSampleLoadingState when called on an unloading bank. 14/04/14 1.03.05 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Added ChannelControl to the C# wrapper to match the C++ API. * Core API - Fixed the definition of ChannelControl.setDelay and ChannelControl.getDelay in the C# wrapper. * Core API - Replaced broken C# wrapper System.set3DSpeakerPosition and System.get3DSpeakerPosition functions with System.setSpeakerPosition and System.getSpeakerPosition. * Core API - Fixed the capitalization of DSP.setMeteringEnabled, DSP.getMeteringEnabled and DSP.getMeteringInfo in the C# wrapper. * Core API - Xbox 360 - Fix hang on XMA playback * Core API - Fix crash when running out of memory loading an ogg vorbis file. * Core API - Fix symbol collisions when statically linking both FMOD and Xiph libvorbis or libtremor. 08/04/14 1.03.04 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Studio::EventInstance::start now does a full restart of the event if already playing. Restarting events will trigger the FMOD_STUDIO_EVENT_CALLBACK_RESTARTED callback type. * Studio API - Added Studio::MixerStrip::setMute, and Studio::MixerStrip::getMute for muting buses. * Studio API - Added Studio::System::getBufferUsage and Studio::System::resetBufferUsage for querying command and handle buffer size usage. * Core API - System::createSound and System::createStream now faster due to file extension check and immediate prioritization of the relevant codec, before scanning rest of codec types. * Core API - Paused channels now have an effective audibility of 0 and will go virtual if FMOD_INIT_VOL0_BECOMES_VIRTUAL is enabled. Fixes: * Studio API - Added Studio.System.initialize to the C# wrapper to match the C++ API (replacing Studio.System.init, which is now deprecated). * Studio API - Added Studio.System.create to the C# wrapper to match the C++ API (replacing Studio.Factory.System_Create, which is now deprecated). * Studio API - Added missing functions to the C# wrapper: Studio.EventInstance.get3DAttributes, Studio.EventInstance.isVirtual, Studio.EventInstance.setUserData, Studio.EventInstance.getUserData, Studio.MixerStrip.getChannelGroup, Studio.EventDescription.getUserProperty, Studio.EventDescription.getUserPropertyCount, Studio.EventDescription.getUserPropertyByIndex, Studio.EventDescription.setUserData, Studio.EventDescription.getUserData and Studio.System.loadBankCustom. * Core API - Fix for VBR sounds that dont use FMOD_CREATECOMPRESSEDSAMPLE and FMOD_ACCURATETIME not looping when FMOD_LOOP_NORMAL was set. * Core API - XboxOne - Fixed rare mixer hang when playing XMA as a compressed sample. * Core API - Fix crash with combination of FMOD_OPENUSER + FMOD_NONBLOCKING and a null pointer being passed to System::createSound/createStream. Notes: * Added examples to the Programmer API documentation. * Xbox One - Now built with March 2014 QFE1 XDK. * Studio API - In the C# wrapper, Studio.System.init is now deprecated in favour of Studio.System.initialize. * Studio API - In the C# wrapper, Studio.Factory.System_Create is now deprecated in favour of Studio.System.create. * Studio API - Studio::EventDescription::is3D now returns true if any of its nested events are 3D. * Core API - FMOD_CREATESOUNDEXINFO.suggestedsoundtype now tries the suggested type first, then tries the rest of the codecs later if that fails, rather than returning FMOD_ERR_FORMAT. * Core API - Custom codecs. The open callback for a user created codec plugin now does not have to seek to 0 with the file function pointer before doing a read. 28/03/14 1.03.03 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed Studio::EventDescription::getInstanceCount and Studio::EventDescription::getInstanceList incorrectly providing data for all events in the bank, not just the queried event. * Studio API - Added Studio::EventDescription::loadSampleData, Studio::EventDescription::unloadSampleData and Studio::EventDescription::getSampleLoadingState to C# wrapper. 26/03/14 1.03.02 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added Studio::EventDescription::loadSampleData, Studio::EventDescription::unloadSampleData and Studio::EventDescription::getSampleLoadingState functions. * Core API - Added FMOD_ChannelGroup_IsPlaying to C API. Fixes: * Studio API - Fix for setting parameter values that could cause volume changes without the appropriate volume ramp. * Core API - Fix for some incorrect declarations in the C header files. * Core API - Fixed a linker error when calling some C API functions. * Core API - Fixed FMOD_ChannelGroup_AddGroup not returning the DSP connection on success. * Core API - PS4 - Fixed FMOD macros for declaring plugin functions. Notes: * Studio API - Studio::EventInstance::getLoadingState is now deprecated in favour of Studio::EventDescription::getSampleLoadingState. 18/03/14 1.03.01 - Studio API patch release --------------------------------------------------- Important: * Core API - Blocking commands are not allowed to be called from the non-blocking callback. Attempting to do so will log an error and return FMOD_ERR_INVALID_THREAD. See FMOD_SOUND_NONBLOCK_CALLBACK for more information. Fixes: * Studio API - Fixed simple nested events not terminating properly when inside multi sounds * Core API - Fix SRS downmix crash on startup if software mixer was set to 5.1, and the OS was set to stereo, and the system sample rate was not 44/48/96khz * Core API - Fix for deadlock that could occur when executing commands in the non-blocking callback as another thread is releasing sounds. * Core API - Fix for Channel::getPosition and ChannelControl::getDSPClock returning errors when called on emulated channels created with System::playDSP. * Core API - PS4 - Fixed leak of audio output handles on shutdown. * Core API - Fix crash in compressor when placed on a channel with a delay. Notes: * PS4 - Now built with SDK 1.600.071. 03/03/14 1.03.00 - Studio API minor release ---------------------------------------------------- Important: * Added PS Vita platform support. * Updated FMOD Studio Programmers API documentation. * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT * Studio API - Studio API is now asynchronous by default, with the processing occuring on a new Studio thread. Asynchronous behaviour can be disabled with the FMOD_STUDIO_INIT_SYNCHRONOUS_UPDATE init flag. * Studio API - Studio API classes are now all referenced as pointers. This reflects a change in the handle system to make it thread-safe, more performant and match the C and Core API interface. * Studio API - Event and mixer strip paths now include a prefix in order to guarantee uniqueness. See Studio::System::lookupID. * Core API - Core API is now thread-safe by default. Thread safety can be disabled with the FMOD_INIT_THREAD_UNSAFE init flag. * Core API - Codecs must set waveformatversion to FMOD_CODEC_WAVEFORMAT_VERSION in the FMOD_CODEC_OPEN_CALLBACK. * Core API - Removed support for digital CD audio Features: * Studio API - The new .bank file format provides improved support for backward and forward compatibility. Future version updates will not generally require banks to be rebuilt. * Studio API - Added support for events duplicated across banks. * Studio API - Added support for transition marker and loop region probability. * Studio API - Added support for sounds on transition timelines. * Studio API - Added asset enumeration functions: Studio::System::getBankCount, Studio::System::getBankList, Studio::Bank::getEventCount, Studio::Bank::getEventList, Studio::Bank::getMixerStripCount, Studio::Bank::getMixerStripList. * Studio API - Added path retrieval functions: Studio::System::lookupPath, Studio::EventDescription::getPath, Studio::MixerStrip::getPath, Studio::Bank::getPath. * Studio API - Bank loading now takes an extra flags argument. It is possible to load banks in non-blocking mode in which case the function will return while the bank is still in the process of loading. * Studio API - Added Studio::System::setAdvancedSettings. * Studio API - Added Studio::System::getCPUUsage. * Studio API - Studio repositories have improved performance and no longer depend on the standard library map. * Core API - The system callback now includes the error callback type which will be invoked whenever a public FMOD function returns a result which is not FMOD_OK. * Core API - Optimize Sound::getNumSyncPoints when using large FSB files with many subsounds and many syncpoints. * Core API - Made improvements to virtual voices for DSP graphs using sends, returns, fade points, and sounds with varying peak volumes. * Core API - PS4 - Added recording support. * Core API - XBox One - Added dll loading support. * FSBank API - Added support for exporting peak volume per sound using the FSBANK_BUILD_WRITEPEAKVOLUME flag. Fixes: * Core API - Channels now take fade points into account for virtualisation * Core API - Fixed pops when changing Echo DSP Delay parameter * Core API - Xbox One - Removed a CPU spike when first playing a compressed sample XMA. Notes: * Studio API - Replaced Studio::System::lookupEventID and Studio::System::lookupBusID with Studio::System::lookupID. * Core API - The system callback now has an extra userdata argument that matches the userdata specified in System::setUserData. * Core API - Xbox One - APU allocations are now handled internally for developers using memory callbacks or memory pools. 24/02/14 1.02.13 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Removed stalls when removing a DSP chain from a channel * Core API - Fixed Channel::getPosition returning incorrect value for streams with very short loops. * Core API - Fixed rare bug with DSP nodes not being set active in the mixer graph. * Core API - Fixed rare bug with DSP metering not being set. * Core API - Fixed incorrect playback of multi-channel PCM8 data. * Core API - PS4 - Fixed issues with calling ChannelControl::setPosition on AT9 streams and compressed samples. * Core API - PS4 - Fixed audio glitches when using the background music port and the system format is not 7.1 * Core API - PS4 - Added loading of plugins from PRX files. * Core API - Android - Fixed crash on low quality Vorbis encoded FSBs. * Core API - Android - Fixed one time memory leak on System::release when using OpenSL output mode. * Studio API - Fixed playlist instruments occasionally cutting off too early. * Studio API - Fixed rare timing issue that caused spawning instruments to trigger too early. Notes: * Xbox One - Now built with August QFE11 XDK. * PS4 - Now built with SDK 1.600.051. 07/01/14 1.02.12 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Fixed potential crash with net streams. * Core API - PS4 - Fixed rare internal error in AT9 codec when channels are reused after stopping. * Studio API - Fixed nested events getting incorrect 3D position information 17/12/13 1.02.11 - Studio API patch release ---------------------------------------------------- Features: * Core API - Added ChannelControl::setVolumeRamp and ChannelControl::getVolumeRamp to control whether channels automatically ramp their volume changes. * Studio API - Added FMOD_STUDIO_EVENT_CALLBACK_IDLE callback type, fired when an event instance enters the idle state. Fixes: * Studio API - Fixed FMOD_STUDIO_EVENT_CALLBACK_STOPPED callback firing when an event instance is already stopped. * Studio API - Fixed Studio::EventInstance::getCueCount returning 1 even on events with no sustain points. * Core API - Fixed ChannelControl::setDelay rarely being ignored. Notes: * Core API - PCM data will now be read the main data in a single read instead of breaking the reads up into 16kb chunks. * Studio API - Changed behavior of Studio::EventInstance::getCue to return FMOD_ERR_EVENT_NOTFOUND if the event has no sustain points. 02/12/13 1.02.10 - Studio API patch release ---------------------------------------------------- Important: * Core API - Updated the C ChannelGroup functions to take 64 bit integer argument. Fixes: * Core API - Fix FMOD_SPEAKERMODE_SURROUND upmixing to 5.1 or 7.1 incorrectly, ie surround left mixing into LFE and surround right into surround right. * Core API - PS4 - Fix playback of background music when system software format is not 7.1. 26/11/13 1.02.09 - Studio API patch release ---------------------------------------------------- Notes: * PS4 - Now built with SDK 1.500.111 19/11/13 1.02.08 - Studio API patch release ---------------------------------------------------- Important: * Core API - DSP clock now uses 64 bit integers. The following functions have been modified to accept a 64 bit integer argument: ChannelControl::getDSPClock, ChannelControl::setDelay, ChannelControl::getDelay, ChannelControl::addFadePoint, ChannelControl::removeFadePoints, ChannelControl::getFadePoints. Features: * Studio API - Added setParameterValue and setParameterValueByIndex functions in eventInstance to wrap finding and then setting a parameter value. Fixes: * Core API - Fixed positioning of 5.1 surround speakers when soundcard is set to other surround formats * Core API - Fixed excessive log spam making the logging version much slower * Core API - Xbox One - Fixed rare XMA codec hang which could also manifest as FMOD_ERR_INTERNAL. * Core API - PS4 - Fixed crash when assigning a channel group to the controller speaker. * Studio API - Fixed MixerStrip release not working when the user has multiple handles to the same strip * Studio API - Fixed pops when playing nested events that have silent tracks * Studio API - Fixed crash when shutting down with profiler connected. * Studio API - Fixed unused streams being created during event preloading Notes: * Core API - Turned off optimization for user created DSP effects that do not call the read callback if no sound is coming in. read callbacks will now always fire regardless. 'shouldiprocess' callback can be defined to optimize out no input. 12/11/13 1.02.07 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - iOS - Fixed streams returning FMOD_ERR_INTERNAL on ARM64 devices. * Core API - iOS - Fixed automatic interruption handling not working for ARM64 devices. * Core API - Fix possible crash on startup, if using 5.1 mixing on a stereo output (downmixer enabled). * Core API - Fix setMute on master channelgroup not working. * Studio API - Fixed AHDSR modulators starting at the wrong value when attack time is 0 * Studio API - Fixed Multi Sounds and Scatterer Sounds not randomizing correctly after deleting all entries 06/11/13 1.02.06 - Studio API patch release ---------------------------------------------------- Features: * Core API - iOS - Added support for ARM64 devices and x86_64 simulator. Fixes: * Studio API - Fix playback issues after running for more than 12 hours * Core API - Fixed net streaming truncating or repeatings parts of the end of a netstream. * Core API - Fix crash due to missing functions in kernel32.dll on Windows XP. 29/10/13 1.02.05 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Improved performance of Studio::System::setListenerAttributes * Studio API - FMOD profiler can now show Studio Bus and Event instances in the DSP node graph. Fixes: * Studio API - Fixed pan jittering on events that move with the listener 22/10/13 1.02.04 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added ability to continue loading banks when missing plugins. * Studio API - Added FMOD_STUDIO_PARAMETER_TYPE enum to describe the type of a parameter to FMOD_STUDIO_PARAMETER_DESCRIPTION. * Core API - Added function to get parent sound from a subsound. * Core API - Android - Added support for dynamic plugins. Fixes: * Studio API - Trying to set an automatic parameter will return FMOD_ERR_INVALID_PARAM. * Core API - Fix restarting a channel corrupting fader and panner positions if effects are added. * Core API - Fix channel restarting if 1. sound ended, 2. Channel::setVolume(0) with FMOD_VOL0BECOMESVIRTUAL happened, 3. setVolume(>0) happened, in between 2 system updates. * Core API - Fixed issues on PS4 after opening an output audio port fails. * Core API - Calling playSound on a fsb loaded with createStream will now return FMOD_ERR_SUBSOUND. 15/10/13 1.02.03 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - iOS - Fixed potential crash when stopping virtual channels. * Studio API - Fixed click with cross-fade for nested events * Studio API - Mac - Fixed link issues from certain API functions. Notes: * Studio API - FMOD_Studio_System_Create now takes a headerVersion parameter to match the C++ API 07/10/13 1.02.02 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Fixed rare crash when using virtual voices. * Core API - Fixed channel fade state not being preserved when switching to virtual. * Core API - Fixed 5.1 and 7.1 downmix to stereo being off-center. * Core API - Mac - Fixed incorrect downmix logic causing excess channels to be dropped. Notes: * Core API - changed FMOD_DSP_LIMITER_MODE parameter to bool 01/10/13 1.02.01 - Studio API patch release ---------------------------------------------------- Features: * Core API - Improved performance of compressor on X86/x64 platforms. * Studio API - Added support for new automatic parameters: Event Orientation, Direction, Elevation and Listener Orientation Fixes: * Core API - Fixed crash when downmixing to 16-bit output. * Core API - Fixed floating point issue when setting very low pitch values. * Studio API - Fixed sound glitch that could occur after crossfade. * Studio API - Fix for assert when rescheduling with modified pitch. Notes: * iOS - Now built with SDK 7.0. * Mac - Now built with SDK 10.8. 23/09/13 1.02.00 - Studio API minor release ---------------------------------------------------- Important: * Added Android platform support. Features: * Core API - Added FMOD_CREATESOUNDEXINFO.fileuserdata to hold user data that will be passed into all file callbacks for the sound * Core API - Added System::mixerSuspend and System::mixerResume for mobile platforms to allow FMOD to be suspended when interrupted or operating in the background. * Core API - Added float parameter mappings support to plug-ins * Core API - PS4 - Added Output Ports example * Studio API - Reduced memory overhead for several core types. * Studio API - Added Studio::System::loadBankMemory to support loading banks from a memory buffer * Studio API - Added Studio::System::loadBankCustom to support loading banks using bank-specific custom file callbacks * Studio API - Added support for placing multiple tempo markers on a timeline. * Studio API - Better error reporting for instruments scheduled in the past. Fixes: * Core API - Fix incorrect error codes being returned by C# wrapper. * Core API - Fix bug in stereo-to-surround and surround-to-surround panning * Core API - Fix System::playDSP not working * Core API - Fix rare crash with DSPConnection::setMixMatrix. Studio API could also be affected. * Core API - Fix getMeteringInfo not clearing its values when pausing. * Core API - Fix audio pops when restarting sounds due to downmixing. * Core API - PS4 - Fix crash when disconnecting a channel group from an output port. * Core API - PS4 - Fix issue with audio channels not finishing correctly when being played through a port. * Core API - Xbox One - Fixed 'clicking' when a realtime decoded XMA sample loops if adjusting pitch during playback. * Studio API - Fix event priority not working * Studio API - Fix Studio::EventInstance::start() returning incorrect result with non-blocking sounds. * Studio API - Fix memory leaks when loading corrupt banks * Studio API - Fix channels leaking with nested instruments * Studio API - Fix MixerStrip::setFaderLevel on the game side affecting volume levels in the tool when connected via Live Update * Studio API - Fix a potential crash when getting a string property with Studio::EventDescription::getUserPropertyByIndex Notes: * Studio API - Renamed Studio::System::loadBank to Studio::System::loadBankFile * Studio API - Updated the API examples to use the new example project * Core API - Changed FMOD_FILE_OPEN_CALLBACK userdata parameter from void** to void* (it now comes from FMOD_CREATESOUNDEXINFO.fileuserdata rather than being set by the open callback) * Core API - iOS - Removed automatic handling of interruptions. Developers should call the new System::mixerSuspend / System::mixerResume API from their interruption handler. * Core API - iOS - Removed all usage of AudioSession API, developers are now encouraged to use the platform native APIs as there is no possible conflict with FMOD. * PS4 - Now built with SDK 1.020.041. 02/09/13 1.01.15 - Studio API patch release ---------------------------------------------------- Features: * Core API - Performance optimizations. * Studio API - Performance optimizations. Fixes: * Core API - Fix oscillators not changing pitch if System::playDSP was used. * Core API - Fix crash when setting 0 or invalid pitch. * Studio API - Fix for some allocations not propagating FMOD_ERR_MEMORY errors. * Studio API - Fix for memory leak when failing to load a bank. 26/08/13 1.01.14 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Fix crash if adding an FMOD_DSP_TYPE_FADER dsp to a channelgroup. * Core API - Xbox One - Internal WASAPI (mmdevapi.dll) threads will now have their affinity set to match the FMOD feeder thread. Notes: * Xbox One - Now built with August XDK. 19/08/13 1.01.13 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Global mixer strips will now be automatically cleaned up when when the events routed into them complete. * Studio API - Improved performance of Studio::System::Update by removing stalls waiting on the mixer the complete. Fixes: * Core API - Channel::setPitch() now returns an error if a NaN is passed in. Fixes crashes occuring later in the mixer thread. * Studio API - Fixed sustain points at the start of the timeline not working * Studio API - Fixed sustain point keyoff incorrectly being ignored if the cursor is not currently sustaining * Studio API - Fixed sustain point keyoff incorrectly skipping sustain points repeatedly when looping Notes: * Studio API - Changed behavior of Studio::EventInstance::getCue to return FMOD_ERR_INVALID_PARAM if the event contains no sustain points. 12/08/13 1.01.12 - Studio API patch release ---------------------------------------------------- Features: * Added FMOD SoundBank Generator tool for creating .fsb files. Both a GUI version (fsbank.exe) and a command line version (fsbankcl.exe) are provided. Fixes: * Core API - Fix FSB Vorbis seek table containing an invalid entry at the end. * Core API - Fix cpu stall when using System::playDSP. Also if using oscillator in studio. * Core API - Xbox One - Fixed rare crash on System::init when using WASAPI. 05/08/13 1.01.11 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed resource leak. * Studio API - Fixed a crash when releasing an event instance with sub events. * Core API - Fixed FMOD_SYSTEM_CALLBACK_MEMORYALLOCATIONFAILED not being passed to the application. * Core API - PS4 - Fix crashes caused by out-of-memory conditions. FMOD_ERR_MEMORY is now returned correctly. * Core API - Xbox One - Fixed race condition that causes a hang when playing compressed XMA samples and streams at the same time. * Core API - Xbox One - Fixed leak of SHAPE contexts that would cause createSound to fail if playing and releasing lots of XMA streams. * Core API - Xbox One & Win - Fixed surrounds and rears being swapped in 7.1. 29/07/13 1.01.10 - Studio API patch release ---------------------------------------------------- Important: * Studio API - Changed .bank file format - API is backward compatible but must be upgraded for compatibility with Studio tool 1.01.10 or newer. Fixes: * Studio API - Fixed plugin effect sounds not working in game. * Studio API - Fixed a crash in Studio::System::update after calling Studio::EventDescription::releaseAllInstances * Studio API - Fixed sustain points at the start of the timeline not working * Studio API - Fixed sustain point keyoff incorrectly being ignored if the cursor is not currently sustaining * Studio API - Fixed sustain point keyoff incorrectly skipping sustain points repeatedly when looping * Studio API - Fixed a crash when unloading a bank that contains a nested event that is currently playing * Studio API - Fixed Studio::System::update sometimes failing with FMOD_ERR_INTERNAL and leaving the system in an inconsistent state * Core API - Xbox One - Fixed FMOD_CREATECOMPRESSEDSAMPLE XMA playback issues. Notes: * Studio API - Changed behavior of Studio::EventInstance::getCue to return FMOD_ERR_INVALID_PARAM if the event contains no sustain points. 22/07/13 1.01.09 - Studio API patch release ---------------------------------------------------- Important: * Core API - Fixed rare crash in mixer. Features: * Studio API - Fixed spawning sounds not playing at correct 3D position. * Studio API - Fixed 40ms of latency getting added for each layer of event sound nesting. * Core API - Optimized mixer by about 30% in some configurations. Fixes: * Core API - Remove FMOD_CHANNELCONTROL union, used in ChannelControl type callbacks, as it was incorrect and using it as a union would have lead to corruption/crash. A simple opaque FMOD_CHANNELCONTROL type is now used for callbacks, and the user should just cast to the relevant channel or channelgroup type. * Core API - Fixed fade point interpolation on channels with pitch. * Core API - Fixed race condition when channels were reused after stopping. * Core API - Xbox One - Fixed hang for short (2KB) XMA files. * Core API - Xbox One - Fixed incorrect seek offset for XMA files. * Core API - PS4 - Added support for AT9 streams with greater than 2 channels. * Studio API - PS4 - Fixed crash when Handle derived classes went out of scope after the dynamic lib was unloaded Notes: * PS4 - Now built with SDK 1.0. 15/07/13 1.01.08 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added Studio::EventDescription::getMinimumDistance * Studio API - Added Studio::EventDescription::isStream Fixes: * Core API - Fixed crash / corruption from DSP Fader/Panner objects. * Core API - Fixed mod/s3m/xm/mid playback. * Studio API - Fixed Studio::EventDescription::isOneshot() incorrectly returning true for an event that has a loop on the logic track. * Linux - Fixed crash on playback of certain CELT streams. * Xbox One - Fixed potential hangs with compressed XMA samples. * Xbox One - Fixed potential silence if XMA sample rate was not one of 24K, 32K, 44.1K or 48K. 10/07/13 1.01.07 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Fix "Sample Rate Change" tag from passing through 0 rate when EOF was hit on certain MP3 files. * Core API - Fix crash when using FMOD_CREATECOMPRESSEDSAMPLE introduced in 1.01.06 * Core API - iOS - Fixed crash when using DSP Echo. * Core API - iOS - Fixed crash in mixer due to misaligned buffers. 08/07/13 1.01.06 - Studio API patch release ---------------------------------------------------- Features: * XboxOne - Officially added support for XMA. Please note this requires the July XDK to avoid a hang. * Studio API - Added Studio::ParameterInstance::getDescription * Studio API - Added EventDescription getParameter, getParameterCount and getParameterByIndex functions Fixes: * Fix Sound userdata being overwritten when FMOD_SOUND_NONBLOCKCALLBACK was called for a 2nd or more time. * Core API - Fix rare crash in mixer when releasing a ChannelGroup * Core API - Fix 3D Panner DSPs and Studio Event 3d volumes not being considered by virtual voice system. * Core API - Fixed compressor sounding erratic and unresponsive * Studio API - Fixed clicks when a Studio::ParameterInstance::setValue call causes sounds to be cut off Notes: * XboxOne - Now built with July XDK. * Core API - Changed FMOD_DSP_TYPE_PAN FMOD_DSP_PAN_STEREO_POSITION parameter to go from -100 to 100. * Core API - Changed FMOD_DSP_TYPE_COMPRESSOR FMOD_DSP_COMPRESSOR_ATTACK parameter to go from 0.1 to 500ms. 28/06/13 1.01.05 - Studio API patch release ---------------------------------------------------- Important: * Core API - Changed .fsb file format - ALL BANKS MUST BE REBUILT * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT Features: * Studio API - Added Studio::System::unloadAll function Fixes: * Core API - PS4 - Improved AT9 decoding performance, fixed issue with when a sound has loop points not aligned to frame size, fixed seamless looping playback glitches. * Core API - Fixed bug that was causing virtual channels to stop prematurely. * Core API - Fixed fade points leaking when channels go virtual. Notes: * Studio API - Effect data parameter buffers are now 16-byte aligned (128-byte aligned on PS3) * Studio API - Added automatic header version verification to Studio::System::create 19/06/13 1.01.04 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Fix rare crash with Fader DSP unit. * Studio API - Fixed some effects causing events to not stop correctly * Studio API - Fixed multiple concurrent playbacks of one event sometimes failing with FMOD_ERR_SUBSOUNDS returned from Studio::System::update Notes: * Studio API - Changed Studio::EventInstance::getTimelinePosition to const * PS4 - Now built with SDK 0.990.020. 07/06/13 1.01.03 - Studio API patch release ---------------------------------------------------- Features: * Core API - Optimized mixer when pausing or delaying nodes. Should provide significant speed increase for Studio runtime projects. * Core API - Add FMOD_DSPCONNECTION_TYPE_SEND_SIDECHAIN. Fixes: * Core API - Fixed silence in certain DSP configurations. * Core API - Fixed virtual channels not stopping correctly when a parent channelgroup stops due to an end delay * Core API - Fixed virtual channels not cleaning up fade points correctly * Core API - Fixed fade points being ignored when channels go from virtual to non-virtual * Studio API - Fixed crash when playing a multisound after unloading and reloading it's bank. * Studio API - Implemented Studio::Bank::loadSampleData, Studio::Bank::unloadSampleData and Studio::Bank::getSampleLoadingState (they previously did nothing) * Studio API - Fixed crashes and unexpected behavior with sidechains when they are connected to multiple compressors. * Studio API - Fixed a linker error when calling handle assignment operators * Studio API - Fixed a crash in the game when adding a sound to an event while connected via Live Update Notes: * Core API - Specific parameter description structures like FMOD_DSP_PARAMETER_DESC_FLOAT no longer inherit from FMOD_DSP_PARAMETER_DESC; instead, FMOD_DSP_PARAMETER_DESC includes a union of all the specific structures with floatdesc, intdesc, booldesc and datadesc members. The FMOD_DSP_INIT_PARAMDESC_xxxx macros have been updated to reflect this. * PS4 - Now built with SDK 0.930.060. 31/05/13 1.01.02 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed getMixerStrip not returning a valid handle when retrieving a VCA. 30/05/13 1.01.01 - Studio API patch release ---------------------------------------------------- Fixes: * Core API - Fix rare crash in DSPFader. * Studio API - Studio::EventInstance::getParameter and Studio::EventInstance::getCue now use case-insensitive name comparison Notes: * Studio API - Renamed Studio::EventInstance::getNumCues to Studio::EventInstance::getCueCount 27/05/13 1.01.00 - Studio API minor release ---------------------------------------------------- Important: * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT Features: * PS4 - Added support for mono and stereo AT9 FSBs. * Core API - Optimized mixer by about 10% * Core API - Added 'sends' which is a special type of DSPConnection that does not try and execute the input, the output (return) just consumes what was generated by the input (the send). See FMOD_DSPCONNECTION_TYPE_SEND * Core API - Added DSP::getIdle. Very useful for seeing if a signal is still running to a DSP unit. * Core API - Added FadePoint API - now arbitrary volume ramps can be set anywhere on the timeline. ChannelControl::SetDelay removes ramp in/ramp out in favour of this. See ChannelControl::addFadePoint/removeFadePointsgetFadePoints. * Studio API - Added Studio::EventInstance::setTimelinePosition and Studio::EventInstance::getTimelinePosition * Studio API - Disconnect stopped events from the DSP graph to reduce CPU usage * Core API - removed 'sidechain' API, added FMOD_DSPCONNECTION_TYPE which is now a parameter to DSP::addInput. FMOD_DSPCONNECTION_TYPE_STANDARD, FMOD_DSPCONNECTION_TYPE_SIDECHAIN, and FMOD_DSPCONNECTION_TYPE_SEND are now supported. DSPConnection::getType replaces DSPConnection::isSideChain Fixes: * Core API - Fixed FSB Vorbis not working with encryption key enabled. * Core API - Fixed virtual voices not respecting ChannelControl::setDelay * Core API - Fixed parameter index validation when getting/setting DSP parameters. * Core API - Fixed reverb not always idling when it should. * Core API - Fixed bug with loop count being incorrectly set to infinite * Core API - Optimised Echo DSP effect on x86/x64 architectures * Core API - Fixed ChannelControl::set3DLevel, ChannelControl::set3DSpeakerSpread and stereo 3d sounds not working * Core API - Fixed flange effect not updating 'rate' parameter if the rate was set before adding it to a channel or channelgroup or system object. * Core API - PS4 - Added support for music, voice, personal device and pad speaker routing. See System::AttachChannelGroupToPort and fmod_ps4.h * Core API - PS4 - Added dynamic linking option. * Studio API - Fixed stop/release behaviour of event instances containing logic markers. * Studio API - Fixed memory corruption in Studio::System::release * Studio API - Fixed FMOD_STUDIO_STOP_ALLOWFADEOUT cutting off delay and reverb * PS4 - Fixed closing the FMOD::System causing platform wide networking to be shutdown even if the system did not initialize it. Notes: * XboxOne - Now built with April XDK. * PS4 - Now built with SDK 0.930. 09/05/13 1.00.03 - Studio API patch release ---------------------------------------------------- Features: * Core API - Added memory callbacks for DSP plugins Fixes: * Core API - Fixed true peak calculation in loudness meter * Core API - Fix thread related crash in fader DSP and possibly panner DSP. * Studio API - Fixed automatic angle parameter calculation 12/04/13 1.00.02 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed snapshots sometimes not working on some properties * Studio API - Fixed VCAs applying fader level twice to controlled buses 09/04/13 1.00.01 - Studio API patch release ---------------------------------------------------- Important: * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT Features: * PS4 & XboxOne - Reduced CPU usage with optimized SSE and AVX functions. Fixes: * Core API - Fix potential crash when stopping and starting sounds quickly and a leak for FMOD_CREATECOMPRESSED codecs which made all sounds go virtual. * Studio API - Fixed a crash when connecting to the game via Live Update * Studio API - Fixed serialization of snapshots with automation Notes: * XboxOne - Now built with March XDK. 25/03/13 1.00.00 - Studio API major release ---------------------------------------------------- Important: * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT Features: * Mac - Reduced CPU usage with optimized SSE and AVX functions. * XboxOne - Added ability to set affinity via FMOD_XboxOne_SetThreadAffinity. * PS4 - Added ability to set affinity via FMOD_PS4_SetThreadAffinity. Fixes: * Studio API - Fixed Studio::EventDescription::getLength return incorrect values * Studio API - Fixed playback glitches when sounds are placed end-to-end on the timeline * Studio API - Studio::System::lookupEventID and Studio::System::lookupBusID now ignore case * Studio API - Fixed playback of Sound Scatterers with non-zero pitch * Made return DSPs go idle when there is no input from sends * Fixed sends sometimes going silent if there are multiple sends to a single return * Fixed rare hang in mixer when using setDelay with a pitch on the parent Notes: * Studio API - Replaced Studio::System::lookupID with Studio::System::lookupEventID and Studio::System::lookupBusID. * FSBank API will now always encode PCM FSBs as PCM16 instead of deciding based on the source file format. * PS4 - Now built with SDK 0.920. 25/02/13 0.02.04 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Studio::System::loadBank now returns FMOD_ERR_PLUGIN_MISSING instead of FMOD_ERR_FILE_BAD when the bank uses a missing plugin 15/02/13 0.02.03 - Studio API patch release ---------------------------------------------------- Features: * Studio API - Added Studio::System::lookupID() to look up event IDs from paths (using any string tables present in currently loaded banks). * Studio API - Added Studio::Bank::unload() to free loaded bank data. * Windows - Added optimisations to the 64 bit build. Fixes: * Studio API - Fixed a linker error when calling Studio::EventDescription::getID * Fixed constant FMOD_ERR_MEMORY in the TTY and hang if FMOD_ADVANCEDSETTINGS is used with DSPBufferPoolSize being set to 0. * Changed custom DSPs with no shouldiprocess callback to only be processed when their inputs are active. * Fixed high freqency noise coming from send DSP when channel counts mismatches the return DSP. * Fixed metering not working via LiveUpdate * Windows - fixed bug in 5.1 mixing in 32bit builds. Notes: * XboxOne - Now built with January XDK. * PS4 - Now built with SDK 0.915. 18/01/13 0.02.02 - Studio API patch release ---------------------------------------------------- Important: * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT * Studio API - Changed function signature for Studio::System::initialize, added STUDIO_FLAGS field Features: * Studio API - Added FMOD_STUDIO_INIT_LIVEUPDATE flag to make Live Update optional Fixes: * Studio API - Fixed an internal error on instantiating a VCA when not all of the mixer strips it controls are loaded Notes: * XboxOne - Now built with December XDK. 11/01/13 0.02.01 - Studio API patch release ---------------------------------------------------- Fixes: * Studio API - Fixed Distance and Angle parameters not being created properly by live update * Fixed reverb effect generating denorm floats after silence 20/12/12 0.02.00 - Studio API minor release ---------------------------------------------------- Features: * Added Xbox360 support. * Added iOS support. * Studio API - Added sub-event instantiation via Studio::EventInstance::createSubEvent 23/11/12 0.01.04 - Patch release ---------------------------------------------------- Fixes: * Fixed a crash when calling Studio::EventInstance::release in a callback fired from Studio::EventInstance::stop with FMOD_STUDIO_STOP_IMMEDIATE * Fixed a linker error when using Studio::CueInstance::trigger * Fixed a bug in volume conflict resolver 9/11/12 0.01.03 - Patch release ---------------------------------------------------- Fixes: * Fixed a linker error when using Studio::EventInstance::setPaused 29/10/12 0.01.02 - Patch release ---------------------------------------------------- Fixes: * Fixed distortion when the distance between 3D sound and the listener is greater than the maximum attenuation distance. * Fixed memory leaks when playing a persistent event and triggering sounds via parameter changes. 16/10/12 0.01.00 - Minor release ---------------------------------------------------- Features: * Implemented side chaining for FMOD Compressor Fixes: * Studio API - Fixed linker error when calling Studio::EventInstance::isVirtual * Studio API - Added log message for asset not found error Notes: * Second Developer Preview release 28/09/12 0.00.04 - Patch release ---------------------------------------------------- Important: * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT Features: * Add DSP::addSideChain and FMOD_DSP_STATE::sidechainbuffer to allow a DSP unit to support sidechaining from the output of another DSP. Fixes: * Studio API - Fixed Event::getParameter() and retrieving the name of a parameter via EventParameter::getInfo() * Studio API - Added version checking to bank loading, the runtime will return FMOD_ERR_FORMAT when attempting to load an old bank 19/09/12 0.00.03 - Patch release ---------------------------------------------------- Fixes: * Fix panning issue introduced in 5.00.02 * Fix possible crackling noises from mixer optimization in 5.00.02 14/09/12 0.00.02 - Patch release ---------------------------------------------------- Important: * Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT Features: * Optimized mixer to be 20% faster in some cases. * Studio API - Improved performance of event playback containing mono/stereo tracks Fixes: * Studio API - Fixed panning different in game to tool 27/08/12 0.00.00 - Initial release ---------------------------------------------------- Notes: * First Developer Preview release