Detailed Revision History

FMOD Studio API

Firelight Technologies FMOD Studio API

Detailed Revision History

07/12/17 1.10.03 - Studio API minor release

Features:

  • LowLevel 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.
  • LowLevel API - Fixed potential crash in device list changed callback when there are no available devices remaining.
  • LowLevel API - Fix 3D 5.1 sound not panning correctly if Channel::set3DLevel(0) is used.
  • LowLevel API - Fixed ID3v2.4 compatibility issue causing missing or corrupted tags.
  • LowLevel API - Android - Fixed incorrect floating point check on ARM64 devices causing FMOD_ERR_NEEDSHARDWARE with some devices.
  • LowLevel API - Xbox One - Fixed race condition causing internal errors with XMA sounds loaded as FMOD_CREATECOMPRESSEDSAMPLE.
  • LowLevel 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:

  • LowLevel API - UWP - Added Windows Sonic support.
  • LowLevel 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.
  • LowLevel API - Fixed recording devices still being marked as connected when switching to FMOD_OUTPUTTYPE_NOSOUND.
  • LowLevel API - UWP - Made device reset / unplug behavior more robust against failure.
  • LowLevel API - Xbox One - 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.
  • Xbox One - Now built with June 2017 QFE 8 XDK.

01/11/17 1.10.01 - Studio API minor release (build 91339)

Features:

  • UE4 - Expose 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.
  • LowLevel API - Fixed potential crash when re-initializing FMOD::System after failure.
  • LowLevel API - Fixed compatibility issues with Windows XP.
  • LowLevel API - Android - Fixed exported symbols to avoid issues with unwinder.
  • LowLevel API - Android - Automatic output mode selection will now choose AudioTrack rather than OpenSL if Bluetooth is enabled to avoid stuttering.
  • LowLevel API - Xbox One - 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 Xbox One 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.
  • LowLevel 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:

  • LowLevel API - Added FMOD_MAX_SYSTEMS constant, currently 8.
  • LowLevel API - Exposed FMOD_DSP_FADER_GAIN on FMOD_DSP_TYPE_FADER.
  • LowLevel API - Added FMOD_SPEAKERMODE_7POINT1POINT4 speaker mode which includes four height speakers to be used with Windows Sonic output.
  • LowLevel 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.
  • LowLevel API - Windows & Xbox One - 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.
  • LowLevel API - PS Vita - Switched FMOD_PSVita_SetThreadAffinity to accept a mask instead of a core number to allow floating threads.
  • LowLevel 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.
  • LowLevel API - FMOD_DSP_TYPE_ENVELOPEFOLLOWER is now deprecated and will be removed in a future release.
  • LowLevel API - Increment Plugin API version for Output plugins. Dynamic library Output Plugins must be rebuilt.
  • 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.
  • Android - Logging version will now produce proper crash stacks but due to binary size increase the release version will continue to not.
  • Xbox One - Removed "acp" and "feeder" from FMOD_DURANGO_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:

  • LowLevel 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).
  • LowLevel API - Fixed ChannelControl::setDelay being ignored if addDSP was called immediately after it.
  • LowLevel API - Fixed potential crash if calling Channel::setPosition soon after System::playSound with paused as true.
  • LowLevel API - Fixed click on Channel::setPaused(false) caused by a non-zero Channel::setPosition after System::playSound with paused as true.
  • LowLevel API - Fixed potential crash if calling System::getRecordPosition while disconnecting an audio device.
  • LowLevel API - Fix FMOD_ACCURATETIME not looping mod/s3m/xm/it files properly, and midi files not looping properly without the flag.
  • LowLevel 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.
  • LowLevel API - FMOD_CREATESOUNDEXINFO::initialseekposition will now wrap if the value given is longer than the FMOD::Sound length.
  • LowLevel 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.
  • Xbox One - 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.
  • LowLevel 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.
  • LowLevel API - Fixed DSPs with sidechain inputs incorrectly going idle when the main input is idle but the sidechain input is not.
  • LowLevel API - Fixed the compressor DSP not playing out its release correctly when its inputs are idle.
  • LowLevel 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:

08/06/17 1.09.05 - Studio API minor release (build 87666)

Features:

  • LowLevel API - Switch - Added support for HTC sockets to allow communications between FMOD tools and runtime via target manager. Enable using FMOD_NX_SetHTCSEnabled(TRUE).
  • LowLevel API - Xbox One - Added support for System::attachChannelGroupToPort with FMOD_DURANGO_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 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.
  • LowLevel API - Fixed ChannelControl::setMixLevelsInput not working and updated docs.
  • LowLevel API - Fixed Channel::setLoopCount not working with very small streams.
  • LowLevel API - Stricter error checking when loading IMA ADPCM wav files to prevent a potential crash from malformed data.
  • LowLevel API - Fixed potential crash in ChannelGroup operations when a Channel failed to play on it with FMOD_ERR_SUBSOUNDS.
  • LowLevel API - Fixed Convolution reverb panning a mono IR with a stereo input incorrectly.
  • LowLevel API - Fixed race conditions when setting FMOD_DSP_SEND_RETURNID.
  • LowLevel API - Fixed a crash with some MOD/S3M/XM/IT files. Introduced in 1.09.00.
  • LowLevel 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.
  • LowLevel API - PS4 - Fixed GPU compute compatibility issue with SDK 4.508.001. GPU compute is now re-enabled.
  • LowLevel API - Switch - Reduced thread priority to avoid conflict with Profiler.
  • LowLevel 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 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.
  • LowLevel API - Fixed FMOD_DSP_TRANSCEIVER making channels audible that weren't supposed to be (introduced with glitch fix in 1.09.03).
  • LowLevel API - Fixed loop clicks on PCM sounds if using FMOD_DSP_RESAMPLE_CUBIC or FMOD_DSP_RESAMPLE_SPLINE.
  • LowLevel API - Fixed FMOD_ADVANCEDSETTINGS::resamplerMethod being ignored.
  • LowLevel API - Fixed plugin unloading for multi-description libraries potentially failing depending on how it's unloaded.
  • LowLevel API - Fixed stream glitch when going virtual then resuming.
  • LowLevel API - Fixed virtual voices losing their loop/2d/3d status, and not staying virtual if Channel::setMode was used. Introduced in 1.09.00.
  • LowLevel API - Fixed FMOD_UNIQUE not being accepted if Channel::setMode or Sound::setMode was used. (it could be successfully used via createSound/createStream).
  • LowLevel API - Fixed rare crash in mixer, introduced 1.09.00.
  • LowLevel API - Switch - Fixed FMOD_NX_THREADAFFINITY so cores can be ORd together to form a mask.
  • LowLevel API - PS4 - GPU compute disabled due to an incompatibility with SDK 4.508.001.
  • LowLevel 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.
  • Xbox One - Now built with October 2016 QFE 2 XDK.

20/03/17 1.09.03 - Studio API minor release (build 85359)

Features:

  • LowLevel API - Updated the /examples/dsp_custom example to include a lot more functionality including parameters, and capture of wave data.
  • LowLevel API - Add fmod_reduced.js for reduced functionality, but also reduced size.
  • LowLevel 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.
  • LowLevel API - Fixed glitches with Transceiver DSP after inputs go idle.
  • LowLevel API - Fix Channel::setPosition(pos, FMOD_TIMEUNIT_MODORDER) not working when playing paused.
  • LowLevel API - Fixed short streams created as non-looping then switched to looping via the Channel API not looping seamlessly.
  • LowLevel API - Fixed DSP plugin version >= 109 data parameters other than 3D attributes not applying if FMOD_INIT_3D_RIGHTHANDED is used.
  • LowLevel API - Fixed rare crash in FMOD Panner DSP. Introduced in 1.09.00.
  • LowLevel API - Re-Fix MOD/S3M/XM/IT file crash with samples that have 0 length, for 1.09 only.
  • LowLevel API - Fixed potential memory leak if System::init returned an error.
  • LowLevel API - Fix FMOD_ACCURATETIME not looping a mod file properly, and not seeking correctly with FMOD_TIMEUNIT_MODORDER.
  • LowLevel API - HTML5 - Loading FSB sounds did not work properly.
  • LowLevel API - Windows - Fixed 5.1->stereo SRS downmix causing lack of bass.
  • LowLevel 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.
  • LowLevel API - Fix crash when connecting to FMOD Profiler.exe and there is a circular connection
  • LowLevel API - Fix glitches with Transceiver DSP after inputs go idle.
  • LowLevel 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:

  • LowLevel 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.
  • LowLevel API - Fixed Channel::setReverbProperties not resetting reverb connection to a new tail DSP when turning wet mix off and on.
  • LowLevel 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.
  • LowLevel API - Fix MOD/S3M/XM/IT file crash with samples that have 0 length.
  • LowLevel API - Fixed some potential crashes when running out of memory, these will correctly return FMOD_ERR_MEMORY now.
  • LowLevel API - Win - Fixed WASAPI recording device enumeration taking a couple of seconds after System::init before being correct.
  • LowLevel API - Win - Fixed potential error returned from System::update if device is unplugged.
  • LowLevel API - MIDI - Fixed Sound::set/getMusicChannelVolume referring to wrong track indices rather than just a normal 0-15 track index.
  • LowLevel 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.
  • LowLevel 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:

Fixes:

  • Studio API - Fixed incorrect playback volume for instruments and playlist items whose volume property is set to a non-zero dB value.

Notes:

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 Xbox one 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.
  • LowLevel API - Allow DSP::setParameterData with null data and 0 length to free convolution reverb impulse response data.
  • LowLevel API - Fixed short looping streams playing some of the start when switched to non-looping via the Channel API.
  • LowLevel 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
  • Xbox One - 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.
  • LowLevel 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.
  • LowLevel API - Fix FMOD_DSP_TRANSCEIVER memory stomp.
  • LowLevel 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.
  • LowLevel 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:

  • LowLevel 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.
  • LowLevel API - Fix FMOD_SOUND_PCMSETPOS_CALLBACK getting invalid position value when a sound opened with FMOD_OPENUSER loops.
  • LowLevel 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.
  • LowLevel 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:

  • LowLevel API - Fixed error trying to create a Return DSP when the system format is set to FMOD_SPEAKERMODE_RAW.
  • LowLevel API - Fixed FFT DSP crash if window size is smaller than DSP block size.
  • LowLevel API - Removed spurious warning messages when loading plugins on some platforms.
  • LowLevel 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:

01/08/16 1.08.09 - Studio API minor release (build 78489)

Features:

  • LowLevel 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.
  • LowLevel 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.
  • LowLevel API - Fixed channelmix DSP volume not always being initialized.
  • LowLevel API - WiiU - Fixed potential crash during System::init if System::setDriver or System::setOutput has been called.
  • LowLevel API - Fix hang on netstreams when the connection times out.
  • LowLevel API - Linux - Fix FPU control word of the calling thread being modified when the FMOD dynamic library is loaded.
  • LowLevel 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:

  • LowLevel API - Linux - Removed limit of 32 devices with ALSA output mode.
  • LowLevel 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:

Notes:

  • LowLevel 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.
  • LowLevel API - Fix crash when closing a system with a multi-plugin DLL still loaded.
  • LowLevel 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:

  • LowLevel API - Fixed crash on shutdown, after creating multiple systems and setting a system callback.
  • Lowlevel API - PS4 - Fix issues with calling FMOD_Orbis_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.
  • LowLevel API - Fix FMOD_ADVANCEDSETTINGS::maxADPCMCodecs not being applied.
  • LowLevel 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:

  • LowLevel 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.
  • LowLevel 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:

  • LowLevel API - Fixed unnecessary DSP queue flush when using ports.
  • LowLevel API - Fixed ADPCM and FADPCM compressed FSBs not returning FMOD_ERR_MEMORY_CANTPOINT when loaded as FMOD_OPENMEMORY_POINT FMOD_CREATESAMPLE.
  • LowLevel API - Fix pops when channels with a mix matrix that are started virtual become real.
  • LowLevel API - Fixed DSP panner reset not clearing ramps, causing ramping when setting initial parameters.
  • LowLevel 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.
  • LowLevel API - Improved performance of logging.
  • LowLevel 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.
  • LowLevel API - Fixed potential incorrect position when voice comes back from being virtual, which can cause a hang on XboxOne.
  • LowLevel API - Improved handling for out of memory errors when mixing DSP buffers.
  • LowLevel API - Fixed incorrect propagation of FMOD_DSP_STATE::channelmask when mixing signals with differing masks.
  • LowLevel API - Fixed http streams (file from http, not shoutcast/icecast) returning FMOD_ERR_FORMAT. Introduced 1.08.01
  • LowLevel API - Fixed m3u playlist file format support. Was returning FMOD_ERR_FORMAT.
  • LowLevel API - Android - Improved detection of low-latency devices allowing better automatic output mode selection and less stuttering.
  • LowLevel API - Sound::getName will now return "" for sounds without names, instead of "(null)".
  • LowLevel 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.
  • Xbox One - 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.
  • LowLevel 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.
  • LowLevel API - Fixed rare hang when rapidly creating and releasing Return DSPs.
  • LowLevel API - Fixed hang or crash when loading a .it/s3m/mod/mid file as a decompressed sound.
  • LowLevel API - Fixed some shoutcast streams playing back garbled.
  • LowLevel 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.
  • LowLevel API - PS4 - Fix AT9 playback when a sound created as looping is played with the channel loop-count explicitly set to zero before starting.
  • LowLevel API - Win - Fixed ASIO device enumeration not supplying a GUID.
  • LowLevel 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 low level 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.
  • LowLevel API - Increased performance of System::createSound and System::createStream, since they no longer block against System::update.
  • LowLevel API - Added filebuffersize to FMOD_CREATESOUNDEXINFO for customizable file buffering.
  • LowLevel API - Added System::getFileUsage to query file loading information.
  • LowLevel 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.
  • LowLevel API - Added getclock callback to FMOD_DSP_STATE_SYSTEMCALLBACKS to get the clock, offset and length for a custom DSP.
  • LowLevel 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.
  • LowLevel API - Added support for object based panning with two backend providers, Dolby Atmos (FMOD_OUTPUTTYPE_ATMOS) and Playstation VR (FMOD_OUTPUTTYPE_AUDIO3D).
  • LowLevel API - Added 3D object panner DSP (FMOD_DSP_TYPE_OBJECTPAN) to be used with new object pan enabled outputs.
  • LowLevel API - Extended output mode plugin API (FMOD_OUTPUT_DESCRIPTION) to allow custom object panner backends.
  • LowLevel 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:

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.
  • LowLevel API - Fixed some net streams returning 'invalid parameter' introduced in 1.07.06.
  • LowLevel API - Fixed potential crash if calling Sound::release soon after System::createSound with FMOD_NONBLOCKING and async IO callbacks.
  • LowLevel API - Winstore/UWP - Fixed small memory leak on system shutdown.
  • LowLevel API - Winstore/UWP - Fixed occasional crash when closing a socket with a pending asynchronous read.
  • LowLevel API - Xbox One - Fixed potential hang waiting on XMA Sound::release if using async IO callbacks and a cancel was issued.
  • LowLevel API - Android - Relaxed overly strict validation of M4A files introduced in 1.07.07.
  • LowLevel API - Android - Fixed potential JNI_OnLoad failure introduced in 1.07.07.
  • LowLevel API - Fix crash in convolution reverb if wet level is set to -80db and it has no inputs.
  • LowLevel API - Fix seeking on stereo FADPCM compressed streams and samples.
  • Unity 2 - Errors opening log output file are no longer fatal.

Notes:

16/02/16 1.07.07 - Studio API patch release (build 72710)

Features:

  • LowLevel 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:

  • LowLevel API - Fixed System::loadPlugin not unloading the library file in the case of an error.
  • LowLevel API - Fixed automatic format detection failing for some types when the file size is less than 1KB.
  • LowLevel API - Fixed FMOD_CREATESOUNDEXINFO::suggestedsoundtype being ignored for FMOD_OPENMEMORY and FMOD_OPENMEMORY_POINT.
  • LowLevel API - WinStore/UWP - Fixed occasional deadlock when removing the current output device.
  • LowLevel API - Win - Fixed potential crash if switching output mode to ASIO after System::init.
  • LowLevel API - Android - Fixed crash if MediaCodec processes a file that isn't an M4A file.
  • LowLevel 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.

  • LowLevel 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:

  • LowLevel API - Fixed bug if streams start virtual, they may not come back as audible. Introduced in 1.07.00
  • LowLevel API - Update URL in Netstream example.
  • LowLevel API - Fixed net streams not working when server delivers shoutcast with chunked HTTP data.
  • LowLevel API - Fixed memory leak when a network connection fails.
  • LowLevel API - Android - Devices that don't support 5.1 output will now gracefully fallback to stereo.
  • LowLevel API - WinStore / UWP - Fixed WASAPI output so it return the correct 'no drivers' error when none are detected.
  • LowLevel API - WinStore / UWP - Fixed WASAPI output swapped sides and rears in 7.1.
  • LowLevel API - Fix C# wrapper of ChannelGroup.addGroup missing arguments.
  • LowLevel API - Fix crash when using chorus effect on a channel group with channel count greater than the system channel count.
  • LowLevel API - PS4 - Fix validation of thread affinity settings.
  • LowLevel 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:

  • LowLevel API - UWP - Fixed FMOD_SYSTEM_CALLBACK_DEVICELISTCHANGED not firing when the default output device changes.
  • LowLevel API - PS3 - Fix rare crash with reverb.
  • LowLevel 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:

  • LowLevel 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.
  • LowLevel API - Fixed corrupted playback for big endian PCM FSBs.
  • LowLevel API - Fixed crash when switching channel count of generator DSPs during playback.
  • LowLevel API - PS3 - Fix crash reallocating buffers on flange effect.
  • LowLevel API - Xbox One - Fixed rare stall when playing XMA streams and compressed samples at the same time.
  • LowLevel API - Fix crash if the Master Channel Group head DSP was set inactive right after initialization.
  • LowLevel API - Fix Sound::getOpenState() moving from FMOD_OPENSTATE_PLAYING too early on some streaming sounds.
  • LowLevel API - Fix Sound::Release() freeing memory still in use by the mixer.
  • LowLevel 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:

  • LowLevel 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:

  • LowLevel API - When using System::recordStart the provided FMOD::Sound can now be any channel count, up/down mixing will be performed as necessary.
  • LowLevel API - Improved performance of convolution reverb effect when wet is 0 or input goes idle.
  • LowLevel API - PS4 - Added FMOD_THREAD_CORE6 to allow access to the newly unlocked 7th core.
  • LowLevel API - PS4 - Added FMOD_Orbis_GetPadVolume() to retrieve the output volume of the pad speaker as set by the user in the system software.
  • LowLevel 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.
  • LowLevel API - Fixed buffer overrun when convolution reverb is set up with mismatched input and output channels.
  • LowLevel API - Fix crash with invalid .mp3 files.
  • LowLevel API - Fix Sound::getName() not returning a valid UTF8 string when loading a sound with ID3 tags specifying the title as a latin1 string.
  • LowLevel API - Fix pops in flange and chorus effects.
  • LowLevel API - Fix crash when using flange effect on a channel group with channel count greater than the system channel count.
  • LowLevel API - FLAC - Fix crash when seeking in certain flac files.
  • LowLevel API - Android - Automatic selection of OpenSL output mode will now be stricter to reduce stuttering on devices that incorrectly report they are low latency.
  • LowLevel API - PS4 - Fix signal not being routed back to the main output when detaching a channel group from a port.
  • LowLevel API - Fix FMOD_ADVANCEDSETTINGS::reverb3Dinstance not working.

Notes:

02/11/15 1.07.02 - Studio API patch release (build 69450)

Important:

  • AppleTV platform support is now part of the iOS package.

Features:

  • LowLevel API - Improved performance of System::getChannelsPlaying.
  • LowLevel 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.
  • LowLevel API - Fix mixer not running if mixer sample rate is lower than output sample rate.
  • LowLevel 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.
  • LowLevel 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:

Fixes:

  • Studio API - Fixed auto-pitch, cutoff and looping not live updating properly.
  • LowLevel API - Fixed potential crash on ARM platforms when seeking Vorbis compressed FSBs.
  • LowLevel API - Fix ChannelGroup::setReverbProperties from returning FMOD_ERR_REVERB_CHANNELGROUP if a child channel had a reverb connection previously.
  • LowLevel API - Fixed FMOD_CREATESOUNDEXINFO::suggestedsoundtype being ignored if a custom codec of higher priority has been registered.
  • LowLevel API - Fixed System::getRecordNumDrivers incorrectly reporting 0 if called within 1 second of application start on some platforms.
  • LowLevel API - Fixed stereo AIFF files producing static.
  • LowLevel API - Xbox One - Fixed rare crash for stereo XMA streams.
  • LowLevel API - iOS - Fixed MP3 decoding being performed by FMOD cross-platform decoder instead of native AudioQueue.
  • LowLevel 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.
  • LowLevel 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 [email protected] 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.
  • LowLevel 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.
  • LowLevel API - Improved CPU performance when using metering or profiling.
  • LowLevel API - Added support for loading multi-channel FSBs with the FMOD_CREATECOMPRESSEDSAMPLE flag.
  • LowLevel 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.
  • LowLevel API - Added full record device add/removal detection for Windows, Mac, Xbox 360, Xbox One, PS3 and PS4.
  • LowLevel API - Reduced recording latency on Windows, XboxOne and PS4.
  • LowLevel API - Mac - Added support for recording from multiple microphones at the same time.
  • LowLevel API - Win - Improved CPU performance for FSB Vorbis decoding. See Performance Reference section of the documentation for updated benchmark results.
  • LowLevel 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.
  • LowLevel API - Fix rare crash when releasing a streamed sound.
  • LowLevel API - Fix output plugins with GUIDs of zero stopping setDriver working.
  • LowLevel API - PS3 - Fixed send/returns not respecting volume changes or rarely failing with an error when setting return IDs.
  • LowLevel API - PS4 - Rewrote output to use sceAudioOutOutputs instead of multiple sceAudioOutOutput calls on a single thread.
  • LowLevel API - Win - Fixed the audible output driver from resetting when an unrelated device is removed or disabled.
  • LowLevel 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.
  • LowLevel API - Increased FMOD_MAX_LISTENERS from 5 to 8.
  • LowLevel API - System::getCPUUsage update time now includes the metering and profiling part of the update.
  • LowLevel API - Removed support for FSB Vorbis files built using FMOD Ex 4.42 or earlier.
  • LowLevel API - PS4 - Changed default mix buffer size to 512 samples to reduce CPU cost. Previous setting of 256 can be set using System::setDSPBufferSize.
  • LowLevel API - PS4 - The size of each pre-allocated AT9 instance has increased by 8kB.
  • LowLevel API - PS4 - Prebuilt static libraries are no longer provided, only dynamic libraries.
  • LowLevel 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.
  • LowLevel API - Fix rare crash when changing the master channel group head DSP when the software format and system output don't match.
  • LowLevel API - Fix Channel::AddDSP() and ChannelGroup::AddDSP() not correctly moving a DSP if it's already a member.
  • LowLevel 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:

  • LowLevel API - Add Sound::seekData support to HTTP streams.
  • UE4 - Added blueprint functions for loading and unloading sample data.

Fixes:

  • LowLevel API - Fix small reverb pop on sounds that had Channel::setPosition called on then and were muted via a parent channelgroup.
  • LowLevel API - Fix https netstream redirects not working.
  • LowLevel 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:

  • LowLevel API - Fix automatic device changing support if a user called System::update from their own thread.
  • LowLevel API - Fix crash when a channel group cannot be attached to port.
  • LowLevel API - Fixed incorrect loop length being set for ADPCM files.
  • LowLevel API - Win64 - Enable automatic device changing support.
  • LowLevel API - iOS - Fixed error creating the file thread on iOS 9.0.
  • LowLevel API - Fix distance filtering not resetting its parameters properly for channels.
  • LowLevel 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.
  • LowLevel API - Add Channel::setPosition support to HTTP streams.

Fixes:

  • LowLevel API - Fixed System::getDefaultMixMatrix crashing if passed FMOD_SPEAKERMODE_RAW. Now returns FMOD_ERR_INVALID_PARAM.
  • LowLevel API - Xbox One - Fixed crash if all SHAPE contexts are consumed.
  • LowLevel 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.
  • LowLevel API - Fix for inaccurate metering levels when the calculation spanned multiple mix blocks.
  • LowLevel 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:

22/07/15 1.06.07 - Studio API patch release (build 66161)

Fixes:

  • LowLevel API - Win - Fix audio glitches at initialization time when using the WASAPI output mode on Windows 10.
  • LowLevel API - Fix UTF8 strings in MP3 ID3V2 tags not being null terminated properly leading to possible string overflow crash.
  • Lowlevel API - PS4 - Fixed issue with non-1024 sample aligned loop-points and AT9 compressed samples.
  • Lowlevel API - Fixed memory leak when releasing connections that have a user allocated mix matrix.
  • LowLevel API - Added pre-wet and post-wet arguments to WetDryMix in C# wrapper.
  • Lowlevel API - Fixed crash with FADPCM streams.
  • LowLevel API - Fixed another potential crash in PitchShifter DSP if changing channel count while running.
  • LowLevel 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.
  • LowLevel 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:

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.
  • LowLevel API - Fixed rare crash when streams go virtual.
  • LowLevel API - Fixed 3EQ DSP not waiting an extra mix block before going idle, possibly cutting off a tail.
  • LowLevel API - Fixed potential crash in PitchShifter DSP if changing channel count or FFT size while running.
  • LowLevel API - Fixed rare volume pop when ramping with fade points as a channel goes emulated.
  • Lowlevel API - Linux - Fixed record position not advancing with ALSA output mode.
  • LowLevel 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.
  • LowLevel API - Fixed rare case of DSP mixer not responding momentarily if output mode was switched during playback.
  • LowLevel 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:

Fixes:

  • Lowlevel 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.
  • LowLevel API - Fix set3DPanLevel not respecting reverb mix when pan level was approaching 0.
  • LowLevel 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.
  • Lowlevel 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.
  • LowLevel API - Fixed invalid memory access when loading an incorrectly formatted or truncated IMA ADPCM wav file using FMOD_OPENMEMORY_POINT and FMOD_CREATECOMPRESSEDSAMPLE.
  • LowLevel API - Fix rare crash due to race condition when calling Sound::Release() just after the sound has been loaded using NON_BLOCKING.
  • LowLevel API - PS3 - Fix deadlock in streaming when using SPU Threads.
  • LowLevel API - Attempting to attach the Master ChannelGroup to a port will now return FMOD_ERR_INVALID_PARAM.
  • LowLevel API - PS4 - Fix issues with recording at rates other than the driver default.
  • LowLevel 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:

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.
  • LowLevel API - WiiU - Fixed incorrect pitch for DRC if System is running a rate other than 48KHz or 32KHz.
  • LowLevel API - PS4 - Fix small memory leak when closing output ports.
  • LowLevel API - Fixed documentation regarding FMOD_DSP_COMPRESSOR_USESIDECHAIN and FMOD_DSP_ENVELOPEFOLLOWER_USESIDECHAIN.
  • LowLevel 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:

Fixes:

  • LowLevel API - Fixed Channel userdata not being reset to 0 each playSound.
  • LowLevel API - Fixed the C# wrapper for DSP.AddInput and DSP.disconnectFrom.
  • LowLevel API - PS4 - Fixed playback issue with AT9 compressed samples that have a non-zero loop start point.
  • LowLevel API - Fix rare issues with generator DSPs or compressed channels getting stuck looping the same fragment of audio.
  • LowLevel 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.
  • LowLevel API - Improved CPU performance of convolution reverb by 30%
  • LowLevel API - Android - Improved latency by automatically resampling to the native rate to enable the fast mixer.
  • LowLevel API - PS Vita - Removed requirement to use 48KHz mixing, default is now 24KHz for better performance.
  • LowLevel API - Xbox One - Optimized performance for looping compressed XMA.
  • LowLevel API - Xbox One - Added support for greater than stereo XMA streams.
  • LowLevel 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.
  • LowLevel 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:

02/04/15 1.05.15 - Studio API patch release

Fixes:

  • Lowlevel API - Win - Fixed occasional deadlock when removing audio devices.
  • Lowlevel API - Fixed stream crackling if initialseekposition was used immediately followed by Channel::setPosition with a close position value.
  • Lowlevel API - PS3 - Fixed six or eight channels vorbis streams crashing the SPU.
  • Lowlevel API - Xbox One - Fixed rare hang when decoding small XMA compressed audio.
  • Lowlevel API - Fixed DSP::getInfo not returning configwidth and confighheight information for VST plugins.
  • LowLevel 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.
  • Lowlevel API - PS4 - Fixed issue with non-1024 sample aligned loop-points and AT9 compressed samples.
  • Lowlevel 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:

  • Lowlevel 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.
  • Lowlevel API - PS3 - Fixed FMOD_PS3_INITFLAGS overlapping FMOD_INITFLAGS causing certain FMOD_INITFLAGS to affect PS3 specific bit-stream encoding options.
  • Lowlevel API - PS3 - Fixed a rare hang when releasing a DSP that exposes a FMOD_DSP_PARAMETER_OVERALLGAIN parameter.
  • Lowlevel API - PS3 - Fixed opening URL failing with network streams.
  • Lowlevel 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:

  • Lowlevel 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.
  • LowLevel 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.
  • LowLevel API - Fix unnecessary querying of recording driver capabilities during recording.
  • LowLevel API - PS4 - Remove AT9 workaround added in 1.05.12. Fix AT9 compressed codecs with finite loop counts.
  • LowLevel API - PS4 - Removed stalls when an AT9 compressed sample channel is started.
  • LowLevel API - PS4 - Fix crash in recording.
  • LowLevel API - Fix multiple listener support not working properly.
  • LowLevel API - Fix user file crash if using asyncfileread callback, and file open and close happens without any read occuring.
  • LowLevel API - Fix rare crash with Sound::release if a nonblocking setPosition is in process and it is an FSB sound.
  • LowLevel API - Fix thread safety issue loading multiple mod/s3m/xm/it files simultaneously.
  • LowLevel 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.
  • LowLevel API - PS3 - Fixed custom DSP that use the plugindata member.

Notes:

  • Studio API - Updated programmer_sound example.
  • LowLevel 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.
  • LowLevel 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.
  • LowLevel API - Fixed race condition setting resampling speed while resampling is occurring.
  • LowLevel API - Fixed crash loading mod/s3m/xm/it file using FMOD_NONBLOCKING and FMOD_CREATECOMPRESSEDSAMPLE and then immediately calling SoundI::release
  • LowLevel 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:

  • Lowlevel 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.
  • LowLevel API - Fix pop noise when 3d sound goes virtual then becomes real again, only if ChannelControl::addDSP was used.

Notes:

12/01/15 1.05.10 - Studio API patch release

Features:

  • LowLevel API - Xbox One - Added support for recording from microphones.

Fixes:

  • Lowlevel API - PS3 - Fix deadlock in streaming sounds when linking against the SPU thread libraries.
  • Lowlevel API - Windows - Fixed crash when initializing a second ASIO system.
  • Lowlevel API - Fix ChannelControl::getDSPIndex not returning an error if the dsp did not belong in the Channel or ChannelGroup
  • Lowlevel API - PS3 - Fix linker error when using libfmod_sputhreads.a
  • Lowlevel API - Fixed AT9 and ACP XMA incorrectly allowing FMOD_OPENMEMORY_POINT and FMOD_CREATESAMPLE.
  • LowLevel API - Fixed reverb wetlevel from ChannelControl::setReverbProperties being reset after a voice goes virtual then returns as real.
  • Lowlevel 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:

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.
  • Lowlevel API - Fixed crash after setting the input format of a Return DSP to stereo, when the mixer output format is mono.
  • Lowlevel API - Windows - Fix crash calling FMOD_ASYNCREADINFO::done function pointer when default calling convention is not cdecl.
  • Lowlevel API - Fixed FMOD_SPEAKERMODE_RAW panning incorrectly during an up or down mix.
  • Lowlevel API - Fix crash when a Channel::setPosition is called on a non-blocking stream that is going virtual.
  • Lowlevel API - Fixed potential audio corruption when playing sounds with more than 8 channels.
  • Lowlevel API - Fixed emulated channels not updating their parent when when Channel::setChannelGroup is called.
  • Lowlevel API - Fixed channels having their volume reset when changing channel group parents.
  • Lowlevel API - Fixed channels not going virtual when being paused if no other volume changes were occurring.
  • Lowlevel API - Fixed FMOD_INIT_PROFILE_ENABLE enabling all DSP metering regardless of whether FMOD_INIT_PROFILE_METER_ALL was used.
  • Lowlevel API - Added volume ramp up for 3d channels coming back from virtual to real.
  • Lowlevel API - Fixed rare crash if the master channelgroup's DSP Head unit was changed then released.
  • Lowlevel API - PS3 - Fix loudness meter not functioning.
  • LowLevel API - PS3 - Re-enabled playDSP.

Notes:

  • Lowlevel API - Xbox One - Added check to ensure DSP buffer size is specified as the default 512 samples to avoid performance degradation of XMA decoding.
  • Lowlevel 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:

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.
  • Lowlevel API - Android - Improved compatibility with Java 1.6.
  • Lowlevel API - iOS - Added armv7s back to the universal binary.
  • Lowlevel API - Windows - Fix System::getRecordDriverInfo returning incorrect device names. Introduced in 1.05.00.
  • Lowlevel API - Fix FMOD_SPEAKERMODE_RAW creating silence if playing more than 1 sound, introduced in 1.04.15.
  • LowLevel 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:

  • LowLevel API - Android - Added ARM64 support.

Fixes:

  • LowLevel API - Fix ChannelGroup::setMixLevelsOutput causing corrupted audio when the channel group has an input with a channel count greater than the system channel count.
  • Lowlevel API - Fixed ChannelControl::setMute not refreshing channel audibility.
  • Lowlevel API - Windows - Fix calls to DSP::getInfo() from within a custom DSP deadlocking the system during audio device change.
  • Lowlevel API - Fixed some DSP configurations with an idle first input causing signal to be downmixed to mono.
  • Lowlevel 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:

  • LowLevel 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.
  • Lowlevel API - Fixed sound going mono in certain DSP configurations. Introduced 1.05.00.
  • Lowlevel API - Fixed rare timing issue with fade points that caused the fader DSP to generate invalid floats.
  • Lowlevel API - Android - Fixed crashes due to insufficient stack size when running ART instead of Dalvik.
  • Lowlevel API - Windows - Fixed potential crash if using multiple FMOD::System with ASIO output mode. This is not supported by ASIO and is now disabled.
  • Lowlevel 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:

  • LowLevel 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.
  • LowLevel 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.
  • LowLevel API - PS3/X360/Wii-U - Fix vorbis seek getting stuck in an infinite loop.
  • LowLevel 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:

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.
  • Lowlevel API - Fixed for enum mismatches in C# wrapper.
  • Lowlevel API - Fixed FMOD_DSP_LOWPASS click when being reused, ie stopping then starting a new sound.
  • Lowlevel API - Fixed rare hang during Sound::release for sounds created as FMOD_NONBLOCKING.
  • Lowlevel API - Fixed corrupted playback of MOD/S3M/XM/IT/MID sequenced formats. Introduced 1.04.05
  • Lowlevel API - Fixed ChannelGroup::setReverbProperties on the master channel group causing a stack overflow. This is now disallowed as it creates a circular dependency.
  • Lowlevel API - Mac - Replaced error condition if initializing FMOD before activating the AudioSession with a TTY warning.
  • Lowlevel API - Android - Fixed Sound::readData going forever when reading AAC audio.
  • Lowlevel API - Fix the pancallbacks member of the FMOD_DSP_STATE_SYSTEMCALLBACKS structure passed into custom DSP callbacks being NULL.
  • Lowlevel 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.
  • Lowlevel 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.
  • LowLevel API - Fixed 3EQ DSP not clearing out internal state when DSP::reset is called, potentially causing audible artifacts when reused.
  • LowLevel API - Fixed resampler inaccuracies when reading partial looping data.
  • LowLevel API - Mac - CoreAudio output mode will now allow any DSP block size and will correctly use the desired buffer count.
  • LowLevel API - Mac - CoreAudio now correctly exposes its output AudioUnit via the System::getOutputHandle function.
  • LowLevel API - PS3 - Fixed resampler strict aliasing bug on PPU release builds.
  • LowLevel API - PS3 - Fixed playDSP crash.
  • LowLevel API - Fixed convolution reverb input downmix
  • Lowlevel 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:

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.
  • LowLevel API - Fix bug with custom 3D rolloff curve points getting corrupted.
  • LowLevel API - Fixed incorrect documentation for FMOD_CHANNELCONTROL_CALLBACK.
  • LowLevel API - Fix sub-mix channel count being incorrect when playing multiple sounds with different channel counts together. Introduced in 1.04
  • LowLevel 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:

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.
  • LowLevel 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.
  • LowLevel API - Android - Added support for playing AAC files (requires Android 4.2).
  • LowLevel API - Android - Reduced latency for devices that support FastMixer, see "Basic Information" section of the docs CHM for details.
  • LowLevel API - Added DSP::setWetDryMix so any effect can have generic wet/dry signal level control.
  • LowLevel 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.
  • LowLevel 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.
  • LowLevel API - Changed FMOD_FILE_ASYNCCANCEL_CALLBACK to take FMOD_ASYNCREADINFO structure rather than void *handle.
  • LowLevel API - The FMOD_DSP_RESET_CALLBACK documentation has been updated to make it clear that it should leave public parameters unchanged.
  • LowLevel API - PS4 - Thread affinity can now be set as a mask of allowed cores.
  • LowLevel API - iOS / Mac - Reduced default block size to 512 for lower latency.
  • LowLevel API - Android - Renamed Java interface from FMODAudioDevice to simply FMOD, i.e. org.fmod.FMOD.init().
  • LowLevel 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.
  • LowLevel 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.
  • LowLevel API - Fix crash if FMOD_DSP_TYPE_MIXER or DSP with no read/process function is passed to System::playDSP.
  • LowLevel API - iOS - Fixed MP2 files being intercepted by AudioQueue causing an internal error.
  • LowLevel API - XboxOne - Fixed network connect not resolving host names and not honoring the requested time out.
  • LowLevel API - Fix rare crash if calling Channel::stop() which a non blocking Channel::setPosition is happening with a stream.
  • LowLevel API - Winphone and Windows Store Apps - fixed detection of socket errors.
  • LowLevel 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.
  • LowLevel API - PS3 - Fixed some DSP parameter sets being ignored (overwritten by SPU DMA)
  • LowLevel API - Fix System::playDSP not working with custom DSP effects that use the read callback
  • LowLevel API - Added Memory.Initialize function to the C# wrapper.
  • LowLevel API - Fixed incorrect truncation of FMOD_CREATECOMPRESSEDSAMPLE sounds created from MP3 or MP2 files (does not affect FSB).
  • LowLevel API - Fixed FMOD_ACCURATETIME for FMOD_CREATECOMPRESSEDSAMPLE sounds created from MP3 or MP2 files (does not affect FSB).

Notes:

  • LowLevel 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.
  • LowLevel API - PS3 - Fix audio dropout/corruption when using FMOD_SPEAKERMODE_STEREO. Usually when sidechain is involved.
  • LowLevel API - iOS - Fixed System::recordStart returning FMOD_ERR_RECORD.
  • LowLevel 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:

Fixes:

  • LowLevel API - Fixed bug where channels with post-fader DSP units would not play after transitioning from virtual to real.
  • LowLevel API - Fix pops with resampler on loops.
  • LowLevel API - Fix playDSP returning FMOD_ERR_DSP_SILENCE or FMOD_ERR_DSP_DONTPROCESS if the dsp played returned that during query mode.
  • LowLevel API - PS3 - Fix ITEcho, SFXReverb, FFT DSP effects rarely getting parameters reset to old values.
  • LowLevel API - Xbox One - Fixed audio corruption when playing mono streams from an XMA FSB that has both mono and stereo subsounds.
  • LowLevel API - PS3 - Moved vorbis decode work during stream setPosition to the SPU.
  • LowLevel 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.
  • LowLevel API - Fix combined volume ramp and fade point ramp having an incorrect volume.
  • LowLevel API - Fix for pop when setting zero volume with vol0virtual enabled.
  • LowLevel API - Fix for pop when scheduling fade point ramps in the past.
  • LowLevel API - Fix for pop on a return bus when all incoming sends go idle.
  • LowLevel API - Fix for faders delaying going idle for a mix when volume is set to zero without ramping.
  • LowLevel API - Fixed FSB forwards compatibility issue causing load failures.
  • LowLevel API - XboxOne - Fixed ACP race condition when shutting down / initializing System causing XMA channels to not play.
  • LowLevel API - XboxOne - Fixed XMA compressed sample channel leak that would eventually result in all sounds playing emulated (silent).
  • LowLevel API - WinPhone and WSA - Fixed network connection not respecting system timeout value.
  • LowLevel API - PS3 - Fix IMA ADPCM support for ps3 not working.
  • LowLevel 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.
  • LowLevel API - Fix channel stealing not calling end callback in playDSP case.
  • LowLevel 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.
  • LowLevel API - Mac, iOS and Android - Improved network error reporting.

08/07/14 1.04.03 - Studio API patch release

Features:

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.
  • LowLevel API - Fixed incorrect FMOD_ASYNCREADINFO.offset value passed to FMOD_FILE_ASYNCREAD_CALLBACK when file buffering is disabled.
  • LowLevel API - Windows - Fixed WASAPI failing to initialize on certain old drivers.
  • LowLevel API - Fix FMOD_SPEAKERMODE_RAW being broken.
  • LowLevel API - Fixed System::set3DRolloffCallback not working.
  • LowLevel API - Fixed Sound::set3DCustomRolloff not working.
  • LowLevel API - Fix Geometry API not running in its own thread like it was in FMOD Ex.
  • LowLevel 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.
  • LowLevel 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.
  • LowLevel API - Fixed a race condition that could lead to DSP graph changes not being handled correctly.
  • LowLevel API - Linux - Fixed "spurious thread death event" messages appearing when attached with GDB.
  • LowLevel API - Linux - Fixed internal PulseAudio assert if System::getNumDrivers or System::getDriverInfo is used before System::init.
  • LowLevel API - Linux - Fixed ALSA not using correct default driver in some cases.
  • LowLevel 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:

Fixes:

  • Studio API - Fixed playlist module upmixing to system speakermode when playing multiple overlapping sounds.
  • LowLevel API - Fix streams opened with FMOD_NONBLOCKING from playing at the incorrect position if they go virtual shortly after setPosition is called.
  • LowLevel API - Fix EOF detection in file system causing rare extra file read past end of file.
  • LowLevel API - Fix some FMOD_CREATECOMPRESSEDSOUND based samples finishing early if they were playing back at a low sample rate.
  • LowLevel 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:

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
  • LowLevel API - Fixed incorrect fader interpolation when reparenting channels with propagate clocks.
  • LowLevel API - Win - Fixed several issues with ASIO playback.
  • LowLevel API - Android - Fixed audio corruption on devices without NEON support.
  • LowLevel 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.
  • LowLevel API - Fix truncated FSB causing zero length subsounds, now returns FMOD_ERR_FILE_BAD

Notes:

  • LowLevel API - Renamed C# wrapper SYSTEM_CALLBACKTYPE to SYSTEM_CALLBACK_TYPE so it matches the C++ API.
  • LowLevel 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.
  • LowLevel API - Xbox One - Fixed potential seeking inaccuracies with XMA sounds.
  • LowLevel API - Fix occasional audio pops when starting a channel or channel group.
  • LowLevel API - Fix crash when running out of memory during channel group creation.
  • LowLevel API - Fixed the C# wrapper for Sound.setDefaults and Sound.getDefaults.

Notes:

21/05/14 1.03.08 - Studio API patch release

Features:

  • LowLevel 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.
  • LowLevel API - Multiple channel groups can now be attached to the same output port.
  • LowLevel API - PS4 - Minor performance improvements in AT9 decoding using new SDK features.

Fixes:

  • LowLevel API - Windows Store - Fixed networking issues.
  • LowLevel API - Windows Store - Fixed System::getRecordDriverInfo() returning incorrect number of channels.
  • LowLevel API - Fix System::setFileSystem asyncread callback not setting priority values properly.
  • LowLevel API - Releasing a channel group attached to an auxiliary output port now cleans up resources correctly.
  • LowLevel API - Channel groups attached to an auxiliary output port can now be added as children of other channel groups.
  • LowLevel API - Fix DSPConnection::setMix() not being applied properly.
  • LowLevel API - PS Vita - Fixed potential crash during System::init if any output related pre-init APIs are used, such as System::getNumDrivers.
  • LowLevel 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.
  • LowLevel API - Xbox One - Small improvement to XMA performance.
  • LowLevel API - Fixed the C# wrapper for System.playDSP.
  • LowLevel 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:

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
  • LowLevel API - Fixed downmixing to a quad speaker setup.
  • LowLevel API - Fixed fsb peak volume levels on big endian platforms.
  • LowLevel 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:

08/04/14 1.03.04 - Studio API patch release

Features:

Fixes:

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.
  • LowLevel 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.
  • LowLevel 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:

26/03/14 1.03.02 - Studio API patch release

Features:

Fixes:

  • Studio API - Fix for setting parameter values that could cause volume changes without the appropriate volume ramp.
  • LowLevel API - Fix for some incorrect declarations in the C header files.
  • LowLevel API - Fixed a linker error when calling some C API functions.
  • LowLevel API - Fixed FMOD_ChannelGroup_AddGroup not returning the DSP connection on success.
  • LowLevel API - PS4 - Fixed FMOD macros for declaring plugin functions.

Notes:

18/03/14 1.03.01 - Studio API patch release

Important:

Fixes:

  • Studio API - Fixed simple nested events not terminating properly when inside multi sounds
  • LowLevel 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
  • LowLevel API - Fix for deadlock that could occur when executing commands in the non-blocking callback as another thread is releasing sounds.
  • LowLevel API - Fix for Channel::getPosition and ChannelControl::getDSPClock returning errors when called on emulated channels created with System::playDSP.
  • LowLevel API - PS4 - Fixed leak of audio output handles on shutdown.
  • LowLevel 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 low level interface.
  • Studio API - Event and mixer strip paths now include a prefix in order to guarantee uniqueness. See Studio::System::lookupID.
  • LowLevel API - Low Level is now thread-safe by default. Thread safety can be disabled with the FMOD_INIT_THREAD_UNSAFE init flag.
  • LowLevel API - Codecs must set waveformatversion to FMOD_CODEC_WAVEFORMAT_VERSION in the FMOD_CODEC_OPEN_CALLBACK.
  • LowLevel 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.
  • LowLevel 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.
  • LowLevel API - Optimize Sound::getNumSyncPoints when using large FSB files with many subsounds and many syncpoints.
  • LowLevel API - Made improvements to virtual voices for DSP graphs using sends, returns, fade points, and sounds with varying peak volumes.
  • LowLevel API - PS4 - Added recording support.
  • LowLevel API - XBox One - Added dll loading support.
  • FSBank API - Added support for exporting peak volume per sound using the FSBANK_BUILD_WRITEPEAKVOLUME flag.

Fixes:

  • LowLevel API - Channels now take fade points into account for virtualisation
  • LowLevel API - Fixed pops when changing Echo DSP Delay parameter
  • LowLevel 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.
  • LowLevel API - The system callback now has an extra userdata argument that matches the userdata specified in System::setUserData.
  • LowLevel 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:

  • LowLevel API - Removed stalls when removing a DSP chain from a channel
  • LowLevel API - Fixed Channel::getPosition returning incorrect value for streams with very short loops.
  • LowLevel API - Fixed rare bug with DSP nodes not being set active in the mixer graph.
  • LowLevel API - Fixed rare bug with DSP metering not being set.
  • LowLevel API - Fixed incorrect playback of multi-channel PCM8 data.
  • LowLevel API - PS4 - Fixed issues with calling ChannelControl::setPosition on AT9 streams and compressed samples.
  • LowLevel API - PS4 - Fixed audio glitches when using the background music port and the system format is not 7.1
  • LowLevel API - PS4 - Added loading of plugins from PRX files.
  • LowLevel API - Android - Fixed crash on low quality Vorbis encoded FSBs.
  • LowLevel 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:

  • LowLevel API - Fixed potential crash with net streams.
  • LowLevel 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:

Fixes:

Notes:

  • LowLevel 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:

  • LowLevel API - Updated the C ChannelGroup functions to take 64 bit integer argument.

Fixes:

  • LowLevel 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.
  • LowLevel 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:

Features:

  • Studio API - Added setParameterValue and setParameterValueByIndex functions in eventInstance to wrap finding and then setting a parameter value.

Fixes:

  • LowLevel API - Fixed positioning of 5.1 surround speakers when soundcard is set to other surround formats
  • LowLevel API - Fixed excessive log spam making the logging version much slower
  • LowLevel API - Xbox One - Fixed rare XMA codec hang which could also manifest as FMOD_ERR_INTERNAL.
  • LowLevel 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:

  • LowLevel 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:

  • LowLevel API - iOS - Fixed streams returning FMOD_ERR_INTERNAL on ARM64 devices.
  • LowLevel API - iOS - Fixed automatic interruption handling not working for ARM64 devices.
  • Lowlevel API - Fix possible crash on startup, if using 5.1 mixing on a stereo output (downmixer enabled).
  • LowLevel 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:

  • LowLevel API - iOS - Added support for ARM64 devices and x86_64 simulator.

Fixes:

  • Studio API - Fix playback issues after running for more than 12 hours
  • LowLevel API - Fixed net streaming truncating or repeatings parts of the end of a netstream.
  • LowLevel API - Fix crash due to missing functions in kernel32.dll on Windows XP.

29/10/13 1.02.05 - Studio API patch release

Features:

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.
  • LowLevel API - Added function to get parent sound from a subsound.
  • LowLevel API - Android - Added support for dynamic plugins.

Fixes:

  • Studio API - Trying to set an automatic parameter will return FMOD_ERR_INVALID_PARAM.
  • LowLevel API - Fix restarting a channel corrupting fader and panner positions if effects are added.
  • LowLevel 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.
  • LowLevel API - Fixed issues on PS4 after opening an output audio port fails.
  • LowLevel 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:

  • LowLevel 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:

07/10/13 1.02.02 - Studio API patch release

Fixes:

  • LowLevel API - Fixed rare crash when using virtual voices.
  • LowLevel API - Fixed channel fade state not being preserved when switching to virtual.
  • LowLevel API - Fixed 5.1 and 7.1 downmix to stereo being off-center.
  • LowLevel API - Mac - Fixed incorrect downmix logic causing excess channels to be dropped.

Notes:

01/10/13 1.02.01 - Studio API patch release

Features:

  • LowLevel 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:

  • LowLevel API - Fixed crash when downmixing to 16-bit output.
  • LowLevel 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:

  • LowLevel API - Added FMOD_CREATESOUNDEXINFO.fileuserdata to hold user data that will be passed into all file callbacks for the sound
  • LowLevel API - Added System::mixerSuspend and System::mixerResume for mobile platforms to allow FMOD to be suspended when interrupted or operating in the background.
  • LowLevel API - Added float parameter mappings support to plug-ins
  • LowLevel 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:

  • LowLevel API - Fix incorrect error codes being returned by C# wrapper.
  • LowLevel API - Fix bug in stereo-to-surround and surround-to-surround panning
  • LowLevel API - Fix System::playDSP not working
  • LowLevel API - Fix rare crash with DSPConnection::setMixMatrix. Studio API could also be affected.
  • LowLevel API - Fix getMeteringInfo not clearing its values when pausing.
  • LowLevel API - Fix audio pops when restarting sounds due to downmixing.
  • LowLevel API - PS4 - Fix crash when disconnecting a channel group from an output port.
  • LowLevel API - PS4 - Fix issue with audio channels not finishing correctly when being played through a port.
  • LowLevel 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
  • LowLevel 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)
  • LowLevel API - iOS - Removed automatic handling of interruptions. Developers should call the new System::mixerSuspend / System::mixerResume API from their interruption handler.
  • LowLevel 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:

  • LowLevel API - Performance optimizations.
  • Studio API - Performance optimizations.

Fixes:

  • LowLevel API - Fix oscillators not changing pitch if System::playDSP was used.
  • LowLevel 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:

  • LowLevel API - Fix crash if adding an FMOD_DSP_TYPE_FADER dsp to a channelgroup.
  • LowLevel 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:

  • LowLevel 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:

  • LowLevel API - Fix FSB Vorbis seek table containing an invalid entry at the end.
  • LowLevel API - Fix cpu stall when using System::playDSP. Also if using oscillator in studio.
  • LowLevel 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.
  • LowLevel API - Fixed FMOD_SYSTEM_CALLBACK_MEMORYALLOCATIONFAILED not being passed to the application.
  • LowLevel API - PS4 - Fix crashes caused by out-of-memory conditions. FMOD_ERR_MEMORY is now returned correctly.
  • LowLevel API - Xbox One - Fixed race condition that causes a hang when playing compressed XMA samples and streams at the same time.
  • LowLevel API - Xbox One - Fixed leak of SHAPE contexts that would cause createSound to fail if playing and releasing lots of XMA streams.
  • LowLevel 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
  • LowLevel 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:

  • LowLevel 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.
  • Lowlevel API - Optimized mixer by about 30% in some configurations.

Fixes:

  • LowLevel 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.
  • LowLevel API - Fixed fade point interpolation on channels with pitch.
  • LowLevel API - Fixed race condition when channels were reused after stopping.
  • LowLevel API - Xbox One - Fixed hang for short (2KB) XMA files.
  • LowLevel API - Xbox One - Fixed incorrect seek offset for XMA files.
  • LowLevel 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:

Fixes:

  • LowLevel API - Fixed crash / corruption from DSP Fader/Panner objects.
  • LowLevel 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:

  • LowLevel API - Fix "Sample Rate Change" tag from passing through 0 rate when EOF was hit on certain MP3 files.
  • LowLevel API - Fix crash when using FMOD_CREATECOMPRESSEDSAMPLE introduced in 1.01.06
  • LowLevel API - iOS - Fixed crash when using DSP Echo.
  • LowLevel 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.
  • LowLevel API - Fix rare crash in mixer when releasing a ChannelGroup
  • LowLevel API - Fix 3D Panner DSPs and Studio Event 3d volumes not being considered by virtual voice system.
  • LowLevel API - Fixed compressor sounding erratic and unresponsive
  • Studio API - Fixed clicks when a Studio::ParameterInstance::setValue call causes sounds to be cut off

Notes:

28/06/13 1.01.05 - Studio API patch release

Important:

  • LowLevel API - Changed .fsb file format - ALL BANKS MUST BE REBUILT
  • Studio API - Changed .bank file format - ALL BANKS MUST BE REBUILT

Features:

Fixes:

  • LowLevel 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.
  • LowLevel API - Fixed bug that was causing virtual channels to stop prematurely.
  • LowLevel 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:

  • Low Level 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:

07/06/13 1.01.03 - Studio API patch release

Features:

  • LowLevel API - Optimized mixer when pausing or delaying nodes. Should provide significant speed increase for Studio runtime projects.
  • LowLevel API - Add FMOD_DSPCONNECTION_TYPE_SEND_SIDECHAIN.

Fixes:

  • LowLevel API - Fixed silence in certain DSP configurations.
  • LowLevel API - Fixed virtual channels not stopping correctly when a parent channelgroup stops due to an end delay
  • LowLevel API - Fixed virtual channels not cleaning up fade points correctly
  • LowLevel 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:

  • LowLevel 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:

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:

Fixes:

  • LowLevel API - Fixed FSB Vorbis not working with encryption key enabled.
  • LowLevel API - Fixed virtual voices not respecting ChannelControl::setDelay
  • LowLevel API - Fixed parameter index validation when getting/setting DSP parameters.
  • LowLevel API - Fixed reverb not always idling when it should.
  • LowLevel API - Fixed bug with loop count being incorrectly set to infinite
  • LowLevel API - Optimised Echo DSP effect on x86/x64 architectures
  • LowLevel API - Fixed ChannelControl::set3DLevel, ChannelControl::set3DSpeakerSpread and stereo 3d sounds not working
  • LowLevel API - Fixed flange effect not updating 'rate' parameter if the rate was set before adding it to a channel or channelgroup or system object.
  • LowLevel API - PS4 - Added support for music, voice, personal device and pad speaker routing. See System::AttachChannelGroupToPort and fmodorbis.h
  • LowLevel 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:

  • LowLevel API - Added memory callbacks for DSP plugins

Fixes:

  • LowLevel API - Fixed true peak calculation in loudness meter
  • LowLevel 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:

  • LowLevel 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_Durango_SetThreadAffinity.
  • PS4 - Added ability to set affinity via FMOD_Orbis_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:

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:

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:

9/11/12 0.01.03 - Patch release

Fixes:

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:

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