Miles Sound System

Miles Sound System Development History

This change log includes the entire Miles development history.

10.0.62 - Mar 4, 2022

  • [Runtime] "Far" pages are no longer read when an eviction would be required, unless they are very high priority.
  • [Studio] Fixed a crash when opening empty projects
  • [Studio] The client debugger now shows the entire read queue for every mix where a read was or could be issued.
  • [Runtime] Fixed a bug with saved dumps not actually recording the mix block count
  • [Runtime] Fixed an issue with the page reader not using correct priority.
  • [Runtime] Worked around a codegen bug with certain consoles.
  • [Runtime] Fixed a bug with default transitions on switchers that have delays
  • [Runtime] Fixed a bug with controllers on switchers occasionally apply to the wrong track.
  • [Studio] Fixed an issue with removing a language that is currently selected.
  • [Runtime] The logic to estimate duration for events has been updated. This should properly catch events that can be infinite due to "hold" states, and now checks all of the sources instead of just the first one.
  • [Runtime] Fixed a music sync issue that occurs when the first track doesn't end up ever playing anything and thus the voice never gets a BPM assigned.
  • [Studio] Added a way to just load a project, compress the sounds, and exit via command line (--compress-and-exit)
  • [Runtime] Fixed an issue when using very fast playback rates, multiple mix blocks, on a low sample rate device.
  • [Distro] Several missing files have been added to the source distribution.

10.0.61 - Sept 17, 2021

  • [Runtime] Fixed a bug where loop segment events could not play or be delayed.
  • [Runtime] Added support for allowing loop segments events to play during fadeout.
  • [Studio] Added a spatialization visualizer (under Tools)
  • [Runtime] Fixed a bug where planar spatialization would freak out if you were exactly 30 degrees off facing on quad systems.
  • [Studio] Fixed a bug where certain compress cache accesses werent thread safe.
  • [Studio] Added perf reports for tracking some degenerate perf

10.0.60 - Jul 29, 2021

  • [Runtime] Fixed crash with case where pages are looked up before they are created.

10.0.59 - Jul 19, 2021

  • [Runtime] Added some debug logging to try and find a rare crash.
  • [Studio] Fix for Releases assigning the wrong bit when some releases are excluded.
  • [Runtime] Small heap overflow fixed.
  • [Studio] Next/Prev buttons now work with Events in the client debugger.
  • [Runtime] Layers with mismatched channel counts now play, they just have no mixer so you kind of just get what you can. For example, a mono layer on a stereo voice will only play in the left channel, and a stereo layer on a mono voice will just play the left channel.
  • [Studio] Event IDs now shown in the command buffer view in the client debugger.
  • [Studio] The serialization code autogenerator is now included in the distribution
  • [Studio] Resource files now distributed.
  • [Runtime] Virtual input gain is now properly included in the initial clip/kill level (it was included in the running check, just not the initial, causing single mix voices)
  • [Runtime] A pending pause on a stopping voice now causes an immediate kill (previously pauses would kill, but pending wouldn't.)
  • [Runtime] If a voice somehow manages to get a pending stop during a pending kill, it now immediately dies.
  • [Studio] Added a quick Tools menu shortcut to copy a list of Random start positions to the clipboard.
  • [Studio] Added a way to highlight priority classes that match a substring.
  • [Runtime] HRTFs have been disabled as a consequence of the dynamic mix size change below.
  • [Runtime] Mixes can now be set up during driver creation to be a specific number of 64 sample "chunks". Miles historically has always been 64 sample mixes, so a value of 1 matches previous behavior (also leaving the setting unset uses 64). Anything more than 4 is probably a bad idea, but YMMV. This is primarily a knob to control the performance cost of "Management".

10.0.58 - Apr 13, 2021

  • [Runtime] The mixer can now access data pages that have completed but haven't been noticed by the mix management (i.e., if the read completes faster than the time it takes to do a mix, the page can be accessed when it completes, rather than after the next mix)
  • [Studio] Fixed a bug hiding pre mutes in the client debugger
  • [Studio] Fixed a bug deleting a node that was selected in popped out properties.
  • [Runtime] Expose a multiplier for voice counts. Primarily used for removing voice limits for perf testing, but you could theoretically use this for upping counts on high end platforms.
  • [Studio] Fixed a bug when specifying a language in the run replay dialog.
  • [Runtime] Now support up to 20 outstanding reads per mix. The number of reads issued is based on the exponentially weighted moving average of the time reads take to complete, such that we only issue 1 more than we expect to complete over the mix.
  • [Studio] "Fast Game Connect" has been killed as it was no longer fast, and in some cases no longer connected.
  • [Studio] Fixed a crash with editing unsaved assets.
  • [Studio] Added a blinking "perforce working" notification when perforce is doing stuff in the background.
  • [Runtime] ARM6 has been removed from iOS for reasons.
  • [Studio] Reworked how sound data is retained to try to address a crash when undoing nodes that happen to be right on the evict time.
  • [Runtime] Only nearby prefetch pages are marked as recently used, so that a long prefetch doesn't fill the streaming cache with "used" pages that in fact won't be used for a long time. This is just to try and avoid weird churn when at the streaming cache limit.
  • [Studio] Source code is now included! See the studiobuild.txt file for instructions. It's pretty straightforward.

10.0.57 - Mar 12, 2021

  • [Studio] Fixed crash on delete after previewing a sound.
  • [Studio] Fixed a bug with overriding platform for priority groups.
  • [Studio] Can now remove property templates on folders
  • [Studio] Can now filter out voices in the client debugger by prefixing the search with "-"
  • [Studio] Added a next/prev voice in the client debugger
  • [Runtime] Stingers are ended when a transition fires now.
  • [Runtime] Added stinger gain and pitch properties.
  • [Studio] Temp source tooltip no longer occludes the text.
  • [Runtime] Fixed a crash with solo/muting with a stinger playing
  • [Studio] Fixed an issue with spaces in filenames when running a replay.
  • [Studio] The client debugger perf page now shows the parsed command buffer.
  • [Runtime] Many stack allocations have been removed to allow for larger mix granularity.
  • [Studio] Fixed a few ui bugs where events that used to have multiple priority classes but had their controller removed would still think they belonged to the extra priority classes.
  • [Studio] Events are now always recompiled when previewing inside miles studio, to prevent long quiet tails from making it seem like changes aren't getting picked up.
  • [Studio] Fixed an issue with saving large manifests causing absurd slowdowns.
  • [Runtime] Added access to the release list for an event via GetDetails.
  • [Runtime] Added a way to have miles print warnings when a mix is delayed.
  • [Studio] Studio now issues a p4 edit whenever an asset is first altered, to try and catch exclusivity issues before a lot of work gets done.
  • [Runtime] Fixed a bug with timelocked random selectors.

10.0.56 - Jan 18, 2021

  • [Runtime] Fixed an issue where a controller bound stinger will continuously fire as long as the controller is positive.
  • [Runtime] Fixed a crash with multiple stingers.
  • [Runtime] Added layer count protection for content runaway cases causing crashes (rare).
  • [Studio] Added a platform mask for event actions
  • [Studio] Fixed a crash when using the "Select Source" menu shortcut.

10.0.55 - Jan 6, 2021

  • [Runtime] Fixed a bug where 2d voices would try to sleep incorrectly.

10.0.54 - Jan 5, 2021

  • [Runtime] Fixed a bug where voices stopped during a data wait could get stuck on.
  • [Studio] Fixed a bug with the sources list getting 'stuck' on a filter.
  • [Runtime] Data prefetch priority for inactive voices lowered.
  • [Runtime] Congestion control fallback sources are now required to have completed reads, not just outstanding reads.
  • [Runtime] Voice priority weighting for page prefetches increased.
  • [Runtime] Pages for voices that are 'expected' to have a delay are deprioritized in favor of immediate use pages.
  • [Runtime] Page prefetch priority now includes layer delays when calculating time-to-use.
  • [Runtime] Fixed a bug where data wait range checks were requiring extra pages (if present)
  • [Runtime] Orphaned loaders now deprioritize their pages in the read queue.
  • [Runtime] Data waits now only require the currently requested block to be in memory, due to issues with syncing loop points.
  • [Runtime] Data waits as a result of congestion have been disabled, due to undesireable feedback loops
  • [Runtime] Fixes to congestion reader limit calculation.
  • [Studio] Improvements to the Reads page in the client debugger.
  • [Runtime] VoiceId back in queue messages (sorry)

10.0.53 - Dec 7, 2020

  • [Studio] Fixed bug with certain sort patterns of source control file lists.

10.0.52 - Dec 3, 2020

  • [Studio] Bus filter chains can now be per platform.
  • [Studio] Bus channel counts can now be per platform.
  • [Studio] Fixed Sync Client button not enabling after undo.
  • [Studio] Fixed bus levels not showing up after last release.
  • [Studio] Fixed a crash related to hidden bus names.
  • [Runtime] Fixed a bug where dynamic route transitions to longer routes didnt work right.
  • [Runtime] Fixed a bug with state switchers on secondary tracks.
  • [Runtime] Lots of optimizations to event processing - massively improved memory access patterns.
  • [Runtime] Fixed a bug with distance scaling on virtual buses not properly evaluating on the first mix of a voice.
  • [Runtime] Fixed a memory leak with sleeping voices.
  • [Studio] Bus properties now show what snapshots affect that bus.
  • [Runtime] Hardware skips now properly reported for some hardware APIs.
  • [Studio] UI "Stopped Stopped" bug fixed.

10.0.51 - Nov 11, 2020

  • [Runtime] Compiled Bank size optimized a bit.
  • [Studio] --remove-bus-names prevents bus names from showing up in the rendered project.
  • [Studio] --remove-priclass-names prevents priority class names from showing up in the rendered project.
  • [Studio] Events that reference deprecated events are now also properly deprecated.
  • [NX] Various optimizations, including switching to a faster output API.
  • [Studio] Fixed a bug with importing audition captures.
  • [Studio] Pasting copied layers can now optionally include the sources.
  • [Studio] Fixed a crash with temped events referenced from a Run Event action.
  • [Unreal] Fixed a double play issue with components.
  • [Studio] Added property templating system. Currently supports filter chains, releases list, and event availability settings (i.e. RNG congestion fallback). More to come over time.
  • [Studio/Runtime] Added "releases", whereby events can be included or excluded in renders via assignment to one or more releases. Included releases can also be optionally turned on or off via API.
  • [Studio] Added --save-deployed-assets which saves a list of events and sources that were rendered to a file.
  • [Studio] Fixed a crash when dragging from the edge of a random selector.
  • [Studio] Fixed a bug where the scroll bar could wander off in the assets tab with a ton of assets listed.
  • [Studio] Ctrl-T now swaps the "temp" designation on selected sources in the sources list.
  • [Studio] Miles Studio no longer adds .wavs as "text" to perforce.
  • [Studio] In the client debugger, data mutes that are due to no preload existing are in a separate category.
  • [Studio] --remove-release-names removes the included releases from the rendered project. When this is set, the API to enable/disable individual releases will not function.
  • [Studio] Rendered project files now verify against expected hashes to prevent out of sync bugs. Additionally, files have a human readable tail specifying the expected size and hash.
  • [Studio] Now shows in the title bar if the audition server wasn't able to start for any reason.
  • [Studio/Runtime] LFE gain has been removed.
  • [Studio] Added a "Whats New" dialog to try and communicate new features to users.
  • [Studio] When exporting the replay dump from an audition-to-disc capture, run-by-id is automatically replaced with run-by-name using the data in the audition capture.
  • [Studio] Fixed a bug in the client debugger where weird hover popups could occur.

10.0.50 - Sept 16, 2020

  • [Runtime] MAJOR CHANGE - mp3 and vorbis have been removed, while opus has been added. Vorbis never had the memory performance we wanted, and mp3 is obviated by opus. Opus is distributed separately due to licensing, be sure to ask for it if you want it. We still HIGHLY recommend Bink Audio as Opus is around 10x slower than Bink Audio, however Opus is around 2x better compression. Currently Opus hardware decoders are NOT supported - all decoding is done on the CPU in software. We force CELT mode when using Opus (OPUS_APPLICATION_RESTRICTED_LOWDELAY)
  • [Runtime] Fixed a bug where 3D sends wouldn't get any LFE volume at all for planar spatialization.
  • [Runtime] Added a way to ensure that a single Source for an Event is always in memory, so that during periods of IO congestion, there's always an option to fall back to for Random and Random No Repeat selector types. This can be set either on a Priority Class, or per Play Voice Action.
  • [Runtime] Added voice audible mask reporting to the info queue, allowing the game to know whether a given voice is muted for either data or design reasons. Voice starvation is now also posted as well.
  • [Runtime] Added several functions for passing information to a connected audition. The game can now specify a current "zone", a text note associated with a time, a named plot, or a named 3d position.
  • [Runtime] Added a way to specify a maximum time that voices will wait for their data before releasing.
  • [Runtime] Added debug flags to driver create parameters, allowing complete removal of data mute for start position and congestion, independently.
  • [Studio] In the Client Debugger, the Cancels view can now selectively view the reasons for cancels.
  • [Studio] Fixed a bug where "Show"ing a bus would focus on the Master bus instead of the desired bus.
  • [Studio] You can now select a different graph template without having to make local and then reselect.
  • [Studio] You can now jump directly to editing a graph template from a usage point.
  • [Runtime] LFE is no longer spatialized to when using vector spatialization, oops.
  • [Runtime] Built in low pass now actually uses the SIMD lowpass filter kernels.
  • [Runtime] Rearranged some stuff for better memory access patterns.

10.0.49 - July 28, 2020

  • [Studio] Fixed an upgrade bug from several years ago that probably doesn't affect anyone other than my ancient regression tests.
  • [Studio] Fixed a crash bug with loading library folders on an empty cache.
  • [Studio] The cursor keys now update the current selection when moving through the controllers list.
  • [Studio] Cleaned up controller properties UI
  • [Studio] Renaming a user marker that is referenced by an entry or exit cue now updates the entry/exit cue to point to the new name.
  • [Studio] Fixed a couple graph bugs introduced in .48
  • [Studio] Fixed a bug with ADPCM wav files.
  • [Runtime] Minor optimizations with respect to unused 3d falloff graphs (spread, lowpass)

10.0.48 - July 15, 2020

  • [Studio] MAJOR CHANGE - the compress cache has a new on-disk layout to fix the "index 0" cache bug that could appear when Miles Studio crashes during a compression. This is an in-place update - sources will not need to be recompressed, however returning to an earlier version of Miles Studio after this will require a cache rebuild.
  • [Runtime] MAJOR BUGFIX - numerical type graphs with a release that starts before the attack ends were never reaching the attack end point, even though the UI in Miles Studio showed the proper 'drop'.
  • [Studio] MAJOR CHANGE - Controllers now know at what level they are expecting to be set (i.e. either per event instance, or globally). This determines whether the controller is listed when the event details is queried.

  • [Studio] Massive memory savings for projects with mostly old version assets.
  • [Studio] Switch mappings can now be saved to a Graph Template, and mappings can be used anywhere a graph can be used. Additionally, they now support non-integer and negative values. Also, switches and run events can now reference a template for their mappings.
  • [Studio] New graphs default to "Graphical" rather than "Numeric"
  • [Studio] Added right click -> Find References for buses and controllers.
  • [Studio] Experimental Feature Sierra now does a quick first-pass check for valid asset names. This is not exhaustive but should help turnaround times for common errors.
  • [Studio] New projects now have a more representative selection of priority classes.
  • [Studio] F2 now renames priority classes and groups.
  • [Studio] The Run Event action now uses the same switch UI as state switchers in play action.
  • [Studio] Load errors now only offer to remove the project from the recent files list if the source file is missing, not if anything goes wrong.
  • [Studio] Miles now accepts floating point and 24 bit wav files as input, as well as sample rates above 48khz. Audio is converted as necessary before passing to encoders.
  • [Studio] Creating new events enables the Sync Client button.
  • [Studio] Miles Studio now tries to add .wav files to Perforce when they are added to Miles Studio.
  • [Studio] Fixed the audition voice starvation chain bug!
  • [Studio] Fixed a bug with source control integration and the new project load dialog.
  • [Studio] Async threads are now at one-less-than normal priority.
  • [Studio] Fixed a bug with loading Miles Studio on Ryzen cores.
  • [Studio] The currently selected platform is saved in user settings now.
  • [Studio] Switching platforms with outstanding compressions is much faster.
  • [Studio] Fixed a bug where switching platforms wouldn't catch compression changes

  • [Runtime] Fixed a crash in EventGetDetails with states that have no layers.
  • [Runtime] Fixed handling of precise edge values in graphs. Shouldn't ever really be an issue.
  • [Runtime] Added a function to retrieve the min, max, and default values for game controllers.
  • [Runtime] Added a function to retrieve the list of global controllers in a project.
  • [Runtime] Fixed a bug where very short dynamic routes wouldnt' catch the last frame of changes, which could result in the transition sounding like it never happened.
  • [Runtime] Fixed a crash when putting a voice to sleep that only has layers fading out.
  • [Runtime] Added the ability to record audition profile data to disk or a callback, instead of only to the network. These files can be imported in to Miles Studio for post-mortem examination.
  • [Runtime] Miles now reports when the audition connection is lost via the info queue.
  • [Runtime] Fixed a crash when requesting voice information on a voice with no sources.
  • [Runtime] Fixed a bug on some windows drivers when removing all audio devices.
  • [Runtime] Fixed a bug with lost devices on Windows
  • [Runtime] Fixed a bug with insufficient stack being requested for the mixer thread when convolution is used.

  • [PS4] dylibs now no longer have any symbols... but we also now can properly debug crashes when they are sent to us.

  • [Switch] Fixed an alignment issue with audio buffer allocation.

  • [Unreal] Added support for loading localized Miles project.
  • [Unreal] Added blueprint function to send Signals.
  • [Unreal] When launching Miles Studio from Unreal, the current project is loaded if we know what it is.
  • [Unreal] Fixed coordinate space conversion.
  • [Unreal] Launching on device now supported for PS4, XBoxOne, and Windows, with audition connectivity.
  • [Unreal] Lots of bug fixes.
  • [Unreal] Added controller volumes - set a controller to a specified value and optionally reset on exit.
  • [Unreal] Added event volumes - play a specified event inside volumes and stop on exit.
  • [Unreal] The controllers list auto populates in many locations
  • [Unreal] Added better drag options for creating nodes and actors
  • [Unreal] Events list now has a search bar.

10.0.47 - Apr 27, 2020

  • [Runtime] Fixed a bug where WASAPI devices would lost audio when Ease of Access set mono output.
  • [Runtime] Various improvements to the auditioning subsystem. This should hopefully fix the random bug where voices stop getting updates and starve during live game auditioning.
  • [Studio] Fixed a crash with WAV files containing garbage RIFF chunks.
  • [Studio] Fixed a crash with moving sliders on auditioned events under certain circumstances.
  • [Studio] Various UI improvements for non-play voice actions.
  • [Runtime] Switches can now optionally reevaluate on repeat
  • [Studio] UI fixes for graph template editing.
  • [Studio] All language files for a source can now again be viewed in source properties.
  • [Runtime] Added a controller for determining when states can repeat. When set, a state will sit in silence until the value becomes positive.
  • [Runtime] Fix for multi track voices
  • [Studio] Fixed a bug with some events not showing their signals in the controller area at the top of the event details pane.
  • [Runtime] Fixed a rare edge case situation where a resampled source could end up locking up Miles.
  • [Studio] Added a message box check for whenever the post parse cache can't be updated, usually because it's been added to source control and is read only.
  • [Studio] Compression now bases the default thread count on the number of CPUs (Ryzen says hi)
  • [Runtime] Core mixer optimzations.
  • [Studio] Performance improvement when executing some Undo commands.
  • [Studio] Added a command line argument to render a project using entirely original source wav files instead of the compressed versions.
  • [Studio] Fixed a bug where a file with more than 255 markers could corrupt the compression cache.
  • [Runtime] Fixed a bug where delays would occur before a tweener, instead of after.
  • [Runtime] A new fade option "crossfade" is available, which sets the next state's fade in length to match the instigating transition's fade out length. In addition, the crossfade maintains volume across the fade, instead of executing each fade as a linear-in-perceived-loudness.
  • [Runtime] Fading can now be specified to "end at" the transition, or "start at" the transition. This has some subtle effects but is mostly relevant for crossfading repeating states.
  • [Runtime] Fixed several more popping issues with situations where a voice would start with one layer, and then at some point in the future get an additional layer.
  • [Runtime] Added a setting to force states to sync to the beat when they start - this effectively adds delay to ensure that the new sound's entry cue lands on the current beat.
  • [Runtime] Fixed a bug with shutting down after a failed bank load.
  • [Runtime] Fade out is now defined on the transition, not the state, so each transition can have a different fade out time - including repeats.
  • [Runtime] Voice sorting is now stable. This is mostly just for reproducibility during bug hunts.
  • [Studio] Added links to micro help videos on youtube.
  • [Studio] Tons of help icon updates
  • [Studio] Large projects now have a progress window on loading.
  • [Studio] Fixed a variety of minor windowing issues.
  • [Studio] Fix for a crash with new assets and popping out properties.
  • [Studio] Compression settings for sources can be set via the assets view

10.0.46 - Feb 26, 2020

  • [Runtime] Added a complex integration example source file hl_adv_integration.cpp.
  • [Studio] Revamped play voice action layout. Layers and transitions are selectable, as are selectors. State positioning is automatic. Most notably, the list of sources for each layer is now visible in the route view instead of having to scroll down to it. Source selection is now far more compact as well, using tree-view collapse ui affordances instead of whatever nonsense I had before.
  • [Runtime/Studio] Added multi-track voices. Each track maintains its own state.
  • [Runtime] Random start position now chooses a random measure/beat instead of a random second.
  • [Runtime] Stinger clocks no longer reset if the voice is paused.
  • [Runtime] Fixed a bug where loop segments wouldn't jump to the exit cue when stopped.
  • [Studio] Miles Studio can now be set to preview sounds using uncompressed source data instead of the compressed data (set under Preview Controls)
  • [Runtime] Fixed a pop with delayed secondary layers with low gain.
  • [Runtime] Fixed a bug with uncompressed sources ending a few samples early.
  • [Runtime] Fixed a bug where the final 64 samples of a layer would get faded out unnecessarily.
  • [Runtime] Voice clock has been updated to be explicitly in the space of the first layer on the first track. Syncing a transition to a beat, loop, or end of a layer will always be relative to that layer. This fixes a lot of random bugs where transitions would be off if that layer had a pitch adjustment.
  • [Studio] Fixed a bug with user markers on uncompressed files.
  • [Studio] Fixed a visual bug with recompressing compressed files with the sound properties open.
  • [Runtime] State and Repeat delay are now both actually wall clock milliseconds.
  • [Runtime] Switches no longer reevaluate when a state repeats.
  • [Studio] Client Debugger now supports shading voices based on their distance or priority volume, to easily scan for 'important' voices.
  • [Runtime] Fixed a bug where if a voice was running a long transition fade out, it could not respond to a stop command in a shorter amount of time.
  • [Studio] Lots of help icon improvements.
  • [Studio] Fixed a bug with adding platforms generating some garbage data for source availability.
  • [Runtime] Updated the Named Stream postboxs to allow for synchronization.
  • [Misc] Added an example playing a Bink video through a Miles Studio voice.
  • [Runtime] Layer clip levels are now respected when transitioning to a new voice state.
  • [Runtime] Voice transitions can now be set to only fire if the voice is at a certain position.
  • [Runtime] Added RAD NDA platform 'mustard', contact sales for more information.
  • [Runtime] Completion transitions are now more explicit about when they fire by exposing options to the designer: either primary layer completes, primary layer reached exit cue, all layers complete, all layers reach exit cue, meausure count completes, or never.
  • [Runtime] Repeat interval can now be in measures instead of only wall clock (ms).
  • [Runtime] Repeats can now occur after a specified number of measures instead of only at the exit cue.
  • [Runtime] Fixed a bug with queueing events while paused.
  • [Runtime] Repeats can now use the state's start position specification instead of always using the beginning of the source.
  • [Studio] Fixed a crash with syncing new sources over auditioning.
  • [Studio] Initial (experimental) support added for UI scaling to double size. Specify in Edit->Options.
  • [Studio] Fixed a bunch of minor issues with saving window positions across instances.
  • [Studio] Client Debugger now shows timing of individual layers for voices with multiple layers.
  • [Runtime] States are now allows to have no layers now, in order to have states that are just holding on other tracks.
  • [Studio] Fixed a crash with undoing Snapshot changes.

10.0.45 - Nov 19, 2019

  • [Studio] Play voice actions with invalid/missing priority classes now auto-pass text filters in the Assets tab, so you can find them by doing e.g. "@priority=missing"
  • [Studio] Designers can now adjust the platform deployment for a source on an event that uses the source.
  • [Studio] Convolution Reverb IRs can be overridden on a per IR, per platform basis by creating a subfolder under ImpulseReponses that matches the name of the target platform.
  • [Studio] Fixed a bug where per-action user preferences would be applied to all actions in an event.
  • [Studio] Voice priority classes and priority groups can be overridden per platform.
  • [Studio] Fixed a bug where priority ranges could be zero, resulting in random eviction order.
  • [Studio] Sources can override their WAV file on a per platform basis.
  • [Studio] Fixed a bug where the graph at the top of the Client Debugger could show the wrong number of events.

10.0.44 - Nov 7, 2019

  • [Studio/Runtime] Added State Switching. Group states in to a Switcher with an attached controller to cause Miles to automatically migrate between those states using a default transition, optionally overriding the transition. Switches can also "hold" the first state chosen when the voice is created.
  • [Studio] Specifying --console on the command line in Miles Studio will show the debug Windows console.
  • [Studio] Fix for newer Perforce clients not properly handling adding files.
  • [Studio] Fixed a bug with cycle detection on buses preventing drag/drop attachement.
  • [Studio] Multiple event property windows can now be opened, and the properties for the active selection can be "Popped Out".
  • [Runtime] Fixed a bug with opening a null device on a system with no audio adapters.
  • [Studio] Memory usage improvements related to languages (only the selected language is kept in memory)
  • [Studio] Memory usage improvements related to large compress caches.
  • [Studio] Adding a language no longer causes every Source to need to be saved to disc with changes.
  • [Studio] Fixed a hitch when recompressing sources.
  • [Studio] Added a project render flag to command line builds to allow only rendering the base language, as opposed to all languages.
  • [Studio] Recompressing all wav files is faster.

10.0.43 - Oct 4, 2019

  • [Studio] Improved the Performance tab in the client debugger.
  • [Studio] Client Debugger piano now auto scrolls with the full view being utilized instead of half.
  • [Studio] Fixed a bug when reordering priority classes.
  • [Studio] Fixed a bug with undoing changes that affect snapshot groups.
  • [Runtime] Added a new platform
  • [Runtime] Fixed a bug with distance scaling ducks.
  • [Studio] Volume curves can be copy/pasted in the Assets Tab now.
  • [Runtime] MilesEventGetDetails no longer crashes if you pass 0 for the name.
  • [Runtime] MilesEventInfoQueueEnum no longer crashes if the info queue was never enabled.
  • [Studio] Fixed a crash that would occur when copy pasting run events that create self-references.
  • [Studio] Improved classic/state view switching and handling.
  • [Studio] Random Ranges can be set in the Assets Tab now.
  • [Studio] Fixed a bug where double clicking in some cases could create spurious drags.
  • [Studio] Previewing events in Miles Studio runs validation checks more consistently, protecting against some crashes.
  • [Studio] Added a basic copy/paste to state layers.
  • [Studio] The priority classes view can be resized now.
  • [Studio] Undo no longer resets the properties scroll position.
  • [Studio/Runtime] Added "Named Streams", allowing external audio sources (voice chat, synthesizers) to be referenced as Sources from within Miles Studio. To use, create a top level folder "NamedStreams" in the Sources list and create a source as normal under that folder, then reference it in an event. The example "hl_named_streams" demostrates how to pass that audio to the Miles runtime.
  • [Studio] Added a flag to output the list of events that were excluded from project rendering, and why (--trimmed-event-log-file).
  • [Studio] Added several Miles Studio performance counters to try and track down some issues. (Help->View Performance)
  • [Studio] Some project load optimizations
  • [Studio] Sources that are considered "temporary" for any reason are rendered in grey. Hovering over the Source in the Sources list will show a tooltip saying the reason.
  • [Studio] Fixed a crash when opening the client debugger without a project loaded.
  • [Runtime] Fixed a crash when a repeating state has a delay and ends at the exact same time as it is muted.

10.0.42 - August 30, 2019

  • [Studio] Duplicate priority class now copies all fields.
  • [Runtime] Fixed several issues with sleeping events

10.0.41 - August 27, 2019

  • [Studio] Fixed a bug where the event csv remapper would crash if the target event existed in a folder other than the one being operated on.
  • [Studio] Dramatic optimization of moving or renaming assets.
  • [Studio] More Perforce operations are batched - dramatic speedup on some operations.
  • [Studio] Fixed a couple bugs with moving layers up or down in play voice actions.
  • [Studio] Fixed a bug with cancelling the "add controller" dialog in the preview window

10.0.40 - August 20, 2019

  • [Studio] Fixed a bug where priorty class names could end up white on white.
  • [Studio] Fixed a bug where priority class controllers couldn't be assigned.
  • [Studio] Fixed a bug where the assets tab would crash when sources were recompressed.
  • [Studio] Fixed a bug where trying to sync the graph view to the graph data in a graph template would crash.
  • [Studio] Fixed a bug where syncing a project change while a voice was sleeping during auditioning could sometimes crash.
  • [Studio] Fixed a bug where editing a priority class without another project-wide change wouldn't get sent with "Sync Clients".
  • [Unreal] Exiting Play-in-editor now kills all running voices.
  • [Unreal] Added basic auditioning support.
  • [Studio] In the client debugger, the events view and the priority view now incorporate event coloring.
  • [Studio] Fixed a bug where maximizing Miles Studio by double clicking the title bar with the priority tab open would change the selection.
  • [Studio] Fixed a bug where "Edit"ing a Play Voice action in the assets tab wouldn't properly sync the Bank tab events list selection if "Hide Actions" had been set.
  • [Runtime] Added Priority Class Group Limits, which allow Priority Classes to be assigned to groups, each with a voice limit. Voices in the priority classes of a priority class group all count towards that limit, providing multiple tiers of voice limiting withing the priority class system.

10.0.39 - August 11, 2019

  • [Studio] Client Debugger now has a 3d view in addition to the 2d view of events.
  • [Studio] Fixed a bug where large numbers of errors/warnings would prevent the dialog box from showing up when rendering projects.
  • [Studio] Added a color property to Events. This color isn't used everywhere yet - in the voices and 2d/3d view in the client debugger. Can be edited in the Assets view, as well as Event Properties.
  • [Studio] Fixed a bug where voices could sometimes pick the wrong bus for output and not tell you about it. Sometimes this would result in a crash.
  • [Studio] Fixed a bug where mute trigger levels would cause affected voices to always fade in.

10.0.38 - July 22, 2019

  • [Runtime] Fixed a minor bug where random layer volumes would get generated twice.
  • [Studio] Controllers can now specify a graph template that will automatically get set as the transform when the controller is assigned.
  • [Studio] Added a warning when synced voices have incompatible source selector layouts (i.e. wouldn't not stay in sync)
  • [Studio] Added a sync button to sync the view to the actual graph width when editing transforms.
  • [Runtime] Lots of Switch optimizations.
  • [Studio] A variety of UI improvements in the client debugger. Stop and Named signals are shown on the voice timeline, with more visibility in to voices that weren't audible for some reason (data mute or starvation).
  • [Studio] Miles Studio will now properly warn when an asset is created that would cause a duplicate name when Flatten Event Names is set. If such names exist on load, then there's a fallback resolution path for renaming to get rid of those errors.
  • [Runtime] Priority Classes can now blend two adjustment types. This is generally used to combine age with distance, to avoid some annoying degenerate cases when you just use one or the other with things like footsteps.
  • [Studio] Active voices when auditioning or previewing will show their priority as they play on the priority classes tab with a little dot, for help with visualizing.
  • [Runtime] Added an experimental priority proximity suppression system. This system lowers the priority of other voices in the same priority class that are in the same direction. This is to try and manage situations where voices that are in two groups, each in a distinct direction (i.e. one left one right), don't have one group dominate the voice counts because all of the voices are slightly closer than all of the voices in the other group.

10.0.37 - June 15, 2019

  • BREAKING CHANGE - The voice selection/priority system has been migrated from buses to Priority Classes. The upgrade system should minimize any changes. In addition, Distance Sleeping Events have been updated to be per-voice, and so are now Distance Sleeping Voices. The person integrating the update should save the project before checking in the upgrade, as a new file will be created, and that should exist on disc before multiple users start using the new version.
  • [Runtime] IMPORTANT BUGFIX - Specifying the channels on a bus never worked! In the assets view, verify that any bus not set to "Default" channels are buses you expect.
  • [Studio] Fixed a bug with BPM detection in WAV file names.
  • [Studio] Fixed a bug with viewing Source properties with very short WAV files.
  • [Studio] The assets tab no longer searches automatically when the timer expires.
  • [Runtime] Added a driver parameter to cap the maximum level output to the hardware. Some audio devices handle full utilization of the output range poorly. This defaults to 32600 / 32767
  • Lots of Client Debugger improvements. Most notably is the introduction of the Priority view, which shows a moment-in-time view of voices.
  • [Runtime] Fixed a bug with completion transitions on infinite layers.
  • [Runtime] Fixed a bug for extremely long running events with thousands of layers crashing.
  • [Runtime] Muting and unmuting a voice now fades over ~300 ms.
  • [Studio] Fixed a bug with using shift to expand selections in the events list.
  • [Runtime] Added a new API for specifying the priority class for an event to be used by all voices it starts. The old Priority Adjust api has been removed.
  • [Studio] Events previewed in Miles Studio are now visible in the Client Debugger.
  • [Studio] Fixed a crash with editing clean options as a result of a corruption.
  • [Studio] Fixed a bug with dragging sources where the selection cross folder boundaries.
  • [Runtime/Studio] Solo/mute now works for nested events (i.e. run events and loop segment events)
  • [Studio] In the Assets tab, ctrl-c now can copy the asset name to the clipboard.
  • [Runtime] Added a new API for prefetching an event - all sources for the event will have very low priority prefetch queued.
  • [Runtime] Inactive (muted) voices now have lower IO priority.
  • [Runtime] Added congestion control to random selectors. When IO is determined to be under load, random nodes will drop randomization in favor or re-using sources that are in memory.
  • [Studio] Fix for edit boxes in other windows not working when the assets tab is open.
  • [Runtime] Retain is now in seconds, and has an option to be infinite.
  • [Runtime] The I/O latency simulation has been pushed to a lower (more accurate) level.
  • [Runtime] I/O has been updated to a page prefetching model to support new IO features
  • [Studio] Voice Layers can now be "cloned" when editing.
  • [Studio] In the Assets tab, names can be searched using basic wildcards (* and ?).
  • [Runtime] Various runtime performance improvements, especially with muted voices.
  • [Studio] In the Assets tab, string properties no longer pass filter checks when empty.
  • [Runtime] Fixed a crash with Run Event Actions and deleted events.
  • [Runtime] Fix for xaudio occasionally locking when transitioning to the null device.
  • [Studio] Fixed a bug where dragging sources in a certain way could corrupt a source selector.
  • [General] Miles documentation has been updated from CHM to a single searchable HTML file.

10.0.36 - Mar 17, 2019

  • [Runtime] Fixed a bug with controller selectors.

10.0.35 - Mar 15, 2019

  • [Studio] BREAKING CHANGE - Mute/pause has been removed in favor of Distance Sleeping Events. Buses that had a mute/pause level specified now are only mute.
  • [Studio] BREAKING CHANGE - 3D graphs must now be bound to AutoDistance, and can no longer be arbitrarily assigned to controllers. Any such graphs will be updated to AutoDistance.
  • [Studio] Miles Studio no longer requires deprecated sources to be present on disc for renders.
  • [Studio] Added a flag for marking events as temporary. These events respond to the temp render flags the same way as sources.
  • [Studio] Fixed a bug where events wouldn't get properly deprecated if they had a source that was deprecated.
  • [Runtime] Added "Distance Sleeping Events". Events can be flagged to automatically go to sleep when their distance to the listener exceeds the radius specified for the event under Event Defaults. Events will go to sleep at 120% of that distance, and wake back up at 110% of that distance.
  • [Studio] Dramatically sped up rendering large projects with a manifest specified.
  • [Studio] Random weights for source selection can now be set directly, and are explicitly shown (as opposed to just the resulting % chance).

10.0.34 - Feb 15, 2019

  • [Studio] Fix for compress cache corruption in projects with more than 512k wav files.
  • [Studio] Client Debugger now shows the correct initial priority for voices.
  • [Runtime] MilesEventGetDetails now no longer tries to adjust the expected event length with the event pitch, as there are many other pitches, and it's usually random anyway.
  • [Runtime] Planar spatialization now handles 4 channel devices properly, and also now correctly falls back to vector spatialization on unhandled formats.
  • [Studio] Fixed a bug where bus channel counts were displayed incorrectly in the assets tab.
  • [Studio] Fixed a bug with previewing planar spatialization inside Miles Studio.
  • [Runtime] Fixed a bug with END transition timing and random loop segments.
  • [Runtime] Fixed a bug with non-infinite loop counts and random loop segments.
  • [Studio] Added a way to extract single events and dependencies in to a designated folder on disc, including wav files.
  • [Studio] Added --no-compress-cache to force a rebuild of the compress cache when building projects from the command line.
  • [Studio] Fix for language indices being off by one.
  • [Runtime] Mute/pause voice performance improved.
  • [Runtime] SIMD mixer sped up, and fixed a minor bug with volume change ramping.
  • [Runtime] Bus mix sort optimized.
  • [Runtime] Fixed a bug where hard coded bus priority offsets were ignored.
  • [Runtime] Fixed a bug when none of the random loop segments are in memory.
  • [Runtime] Minimum Interval restrictions are now respected for Evict Last voices.
  • [Studio] Deprecated events are now ignored in Run Events.
  • [Studio] Signal names are now restricted to alpha numeric.
  • [Runtime] Layer gain dynamics are now evaluated when voices are inactive.
  • [Studio] Radius computation for events now looks for a place on graphs that is above the cutoff dB, before trying to find where it falls below. Fixes radius computation for middle and far field voices.
  • [Runtime] Layer gain is now included for mute and priority calculations.
  • [Runtime] Loop segment events stop firing once a voice receives the stop signal and is fading out.
  • [Studio] Fixed a bug in the client debugger with the # of active voices being displayed.
  • [Studio] Fixed some bugs with displaying the computed event radius.
  • [Runtime] Added a way to reset a "held" controller, in cases where the game code predictively passes a value, expecting to be able to correct it later.
  • [Runtime] Added a flag to control whether all layers must complete before the completion transition will fire, or just the primary.
  • [Studio] Perforce edits with huge numbers of files are way faster now.
  • [Runtime] The first loop segment event now fires when the voice begins, instead of when its created.
  • [Runtime] Prototype planar spatialization now blends offplane vectors to all speakers.
  • [Studio] Fix for deprecating temp sources.
  • [Studio] Fix for nested event - source - event deprecation. Meaning, if a source deprecates an event, then all of the sources in that event also get deprecated.
  • [Studio] Leaving perforce information empty will attempt to use environment variables for login/port.
  • [Runtime] Random start markers tries to avoid markers that aren't in memory yet.
  • [Runtime] Random Loop Segment Events are now only fired by the primary layer. This includes the exit cue event.
  • [Runtime] Bink Audio bit decoder has been optimized (some more)
  • [Studio] Fixed a bug with projects being rendered multiple times with Deprecated events.
  • [Runtime] All layers in a state jump to the exit cue, when that flag is set (instead of just the primary layer)
  • [Studio] Readahead byte amount for sources now exposed in Miles Studio.
  • [Runtime] Fixed a bug with hardcoded FX chain constants.
  • [Runtime] Fixed a bug with random selector state.
  • [Studio] Previewing events in Miles Studio can now be recorded to a WAV file.

10.0.33 - Oct 18, 2018

  • [Studio] MilesEventGetDetails now reports if the event needs continual orientation updates, or only once.
  • [Runtime] Random List selectors now avoid the last entry used when reshuffling the list.
  • [Runtime] Fixed an issue with WASAPI outputs where switched between devices with different sample rates could crash or lock.
  • [Studio] Most sources of property randomization have been migrated to the "Random Range" style, in order to support randomizer synchronization.
  • [Studio] Fixed an issue with clearing a filter chain template from the assets view.
  • [Studio] Randomizers are now indexed, allowing for generated values to be locked for a desired amount of time. The default randomizer acts as before, always generating a new value. Others default to locking the value for the lifetime of the event.
  • [Studio] Support for loading Really Old Projects has been removed - this shouldn't affect anyone. If it does, use 10.0.32 and save to latest.
  • [Studio] Added a way for Miles Studio to provide the same preloads to auditioning clients as a normal render would. This is disabled by default to prevent Miles Studio from having to access the disc when clients connect - expect longer "hitches" when games connect to Miles Studio when this is enabled. This is controlled by Main Menu -> Audition -> Fast Game Connect. When enabled, Miles will not access the disc when games connect, but will not be a true representation of the preload.
  • [Studio] Fixed several crashes associated with a consistency failure due to snapshots somehow not getting saved when a filter on a bus is removed.
  • [Studio] Planar Spatialization can now be specified when running replays via Tools -> Run Replay.
  • [Runtime] Fixed a bug with pausing events.
  • [Runtime] Planar Spatialization now rotates the listener basis before projecting, to prevent sounds below you when looking down sounding behind.
  • [Runtime/Studio] Event Radius is now computed on build, rather than on demand via EventGetDetails. The default dB cutoff is specified in Project Settings (-40 dB), the cutoff can be manually overridden on a per event basis. In addition, the radius can be manually specified on a per event basis.
  • [Runtime] EventGetDetails now includes radius and controller information from Run Event actions.
  • [Studio] Sources can now be marked temporary explicitly, instead of only via temp/final directories.
  • [Runtime] Random Loop Markers Segments can now run an event when a marker is first jumped to.
  • [Studio/Runtime] Added "Named Signal Transitions". Transitions between states can now signaled by a string queued via MilesQueueEventSignal, instead of just when a controller becomes positive. Such transitions only fire once, preventing the need for complicated selection graphs on controllers and mappings of indeces to states.

10.0.32 - Sept 3, 2018

  • [Auditioning] Changing project settings and doing a "Sync Client" now saves the running events and destroys them, reloading them afterwards instead of trying to keep voices running across the recreation. This should fix several spurious crashes, however random volumes and pitches will be reselected for active voices. Please report any major anomalies!
  • [Studio] Fix for marker tool tips.
  • [Studio] Controllers with "Hold First Value" can now be previewed in Miles Studio in a useful way.
  • [Runtime] States can now reevaluated the manual position for an event on entry. This allows repeat actions to change their event's position each time they repeat.
  • [Studio] Fixed a bug where Sources couldn't be moved to another folder as a group.
  • [Runtime] Added the ability for a transition timed to end on a loop boundary to jump to the exit cue afterwards.
  • [Runtime] Added randomized marker segments to source playback. To enable, specify a loop start marker for a voice state. Once specified, a checkbox below will cause Miles to use the loop start marker as a set of markers to randomly play, avoiding repeats. Each segment plays until the following marker, whether or not it matches the loop start marker specification.
  • [Studio] Fixed a bug where draging a bus send to itself causes a stack overflow crash.
  • [Runtime] Using a marker for a start position, loop start position, or loop end position now matches any marker that /starts with/ the given string, instead of requiring an exact match. If multiple matches exist, one is randomly selected. Repeats are allowed.
  • [Runtime] Several fixes for state transition, including allowing multiple layers in states other than the initial state.
  • [Runtime] MilesEventGetDetails has been updated to provide controller names as well as enough information to know what event setup queue functions are needed for a given event (e.g. position, orientation).
  • [Studio] Function controllers now have a min and max value, and correctly respond to out-of-bounds like Game controllers. As a result, they also now have a slider when setting their value in Preview Controls.
  • [Studio] Added a helper dialog to compute the BPM for a file given a number of beats in the file.
  • [Runtime] Beats / Minute can now go up to 64000.
  • [Runtime] BREAKING CHANGE DEPENDING ON PROJECT - Bus fader values now interpolate the final value ONLY instead of each independent snapshot. This fixes a subtle bug where if a bus fader had multiple snapshot groups targeting it, accumulation would be incorrect and double count the base bus value. Fixing this breaks current mixing levels, but the value used will now be the expected value.
  • [Studio] Fixed a bug when closing Miles Studio with a game still connected.
  • [Runtime] Added "stingers" to transitions. Transitions can now start a source when they are fired, in addition to the transition source that starts on the transition timing.
  • [Runtime] Added the ability to "Sleep" events, which removes them from active processing. Major state is saved, but transitionary state is not.
  • [Runtime] Improved performance for temp asset deprecation during builds.
  • [Studio] Fix for highlighting playing sources in events with Run actions.
  • [Runtime] Fixed a pop on voices with multiple layers.
  • [Studio] Fixed crash in Graph Templates
  • [Runtime] Misc performance fixes
  • [Studio] Adding performance measures to Miles Studio.

10.0.31 - Jun 25, 2018

  • [Studio] Fixed a bug where changing a deprecated event would allow it to get sent to the client when syncing during auditioning.
  • [Runtime] Added a code accessible gain control for voices.
  • [Studio] The "shipping" flag for builds has been removed in favor of separate build flags (use /? to view)
  • [Runtime] EventGetDetails now checks the Gain2 in layers for distance falloff.
  • [Runtime] Fixed a bug where clearing the random state in a selector could affect other values.
  • [Runtime] Layers now have a clip db level, where if their gains sum to less than that value, the layer is prevented from being created.
  • [Runtime] Layers can now specify their volume envelopes to be wall-clock instead of only percent completed.
  • [Studio] Added a horizontal situation indicator to the client debugger that shows spatialized events relative to the listener.
  • [Studio] A bunch of readability improvements to various Client Debugger screens.
  • [Studio] Added the ability to replay a recorded miles capture from within Miles Studio (Tools->Run Replay)
  • [Studio] UI for deprecated availability cleaned up.
  • [Runtime] Added a switch which causes controllers to only take the initial value they are set to, and never change afterwards.
  • [Runtime] Angle and Distance controller types are now checked in MilesEventReferencesControllers.
  • [Studio] Function controllers now properly respond to the view for editing in transforms.
  • [Studio] Fixed a bug with importing > 1 event at a time in the csv remapper.
  • [Studio] Added a flag to disable the minimum 1k preload for sounds. Disabling this breaks manifest compatibility with deployed audio (i.e. you cannot patch projects that were deployed with this flag changed.) Change in Project Settings.
  • [Runtime] Setting a 0ms preload now properly causes voices to wait for data instead of thinking a valid preload exists.
  • [Studio] Fixed a bug with solo/mute and Flatten Names being set.
  • [Studio] Fixed a UI bug where the angle type in controllers was displayed backwards (source to listener was actually a listener to source controller).
  • [Runtime] Fixed a bug with MilesEventReferencesControllers failing due to event compression.
  • [Runtime] Added a way to add latency to reads for simulating slow drives.
  • [Runtime] Added a flag to events that causes all voices to wait if any would wait, so they remain in sync. This defaults to on.
  • [Studio] Added a search filter to the Assets view to find on action index (@action = number)
  • [Runtime] Fixed a variety of minor read prioritization bugs and improved the congestion model.
  • [Studio] Massive improvements to the Asyncs view in the client debugger. Now called "Reads", it allows for skipping to data mutes/delays and starvation, as well as better monitoring of the read backlog. Also, the reason for the data delay is now shown.
  • [Runtime] Added a flag that controls whether a voice will continue to advance in time when waiting for data, or will pause instead. Defaults to pause.

10.0.30 - May 17, 2018

  • [Studio] Voices in the client debugger can now be grouped by bus. Right click on a bus header to hide that bus.
  • [Studio] Voice dynamic routing is now displayed in the client debugger.
  • [Studio] Fixed a bug with controller move graphs.
  • [Runtime] Fixed a bug where voices with sends could get incorrect send gains when changing dynamic routes.
  • [Studio] Voices can now be filtered by name in the client debugger.
  • [Studio] Voice dynamic graphs now are all shown in a small size by default, with the ability to expand as desired.
  • [Studio] Added a help button and corresponding docs to the Event CSV Remapper.
  • [Runtime] Fixed a bug where certain ordering of voices could cause a lost voice in the voice limiting code.
  • [Studio] Voice Counts now visible in the Assets View. Doesn't support Named Limits yet.
  • [Runtime] Experimental spread support added to the prototype planar spatialization system.
  • [Studio] If another user deletes a file from Perforce and the current user hasn't synced, Miles Studio will no longer treat it as an orphaned file that needs to be added.
  • [Studio] Layer definitions in voices can now be reordered.

10.0.29 - May 9, 2018

  • [Runtime] Added 7.1 support to prototype planar spatialization
  • [Studio] Solo/Mute support for layers
  • [Studio] Fix a rare case where undo grouping could get lost.
  • [Runtime] Added an addition gain value to Layers.
  • [Runtime] EventGetDetails now checks layer gains for distance/radius computation.
  • [Runtime] Fixed incorrect angle neighborhooding in prototype planar spatialization
  • [Runtime] Event metadata is now compressed.
  • [Unreal] UMilesComponents now visualize their radius in UnrealEd.
  • [Unreal] Performance stats are now available from inside UnrealEd.
  • [Unreal] Added FireMilesEventAttached, which plays the given event on a socket on a given actor
  • [Unreal] Added an animation notify that fires a Miles event.
  • [Runtime] Stingers now only reset triggers if the state is fully left and re-entered (i.e. not on a Repeat).
  • [Studio] Rotating the listener in the Preview Controls now requires holding down CTRL.
  • [Studio] CSV export/import now supports adding in sources to events by having multiple entries for the same source tree path.
  • [Studio] Child window size and position now saved across execution.
  • [Studio] Shift+Space now stops the currently playing events.
  • [Studio] User data is now less strict with respect to allowed characters.
  • [Runtime] Added MilesQueueEventFadeOutTime to override fade out times when voices are stopped by code via the "STOP" event.
  • [Runtime] Source metadata is now only loaded for the active language.
  • [Studio] Added a checkbox to hide folders in the assets view event name.
  • [Studio] Added != as a filter operator in assets view.
  • [Runtime] Compiled Graph pooled is now enabled.

10.0.28 - Apr 10, 2018

  • [Runtime] Fixed a bug with Spread on stereo devices.
  • [Studio] Event Action Switches can now be copy/pasted in the Assets view.
  • [Unreal] Initial unreal plugin has been released.
  • [Runtime] Fixed a bug with MilesEventGetDetails when input gain had a random range.
  • [Studio] Fixed a bug with deleting events when actions are hidden in the events view.
  • [Runtime] Fixed an alignment bug with convolution IRs in some circumstances.
  • [Studio] Layer gain, delay, pitch, and volume envelope can now be edited in the assets view.
  • [Studio] Sources now flash in the Source List when they are changed due to a recompress.
  • [Studio] Added a menu item to expand/collapse all child folders.
  • [Runtime] Graphs now always clamp to property limits.
  • [Studio] Fixed a bug where random source weights could get set to zero on creation, and an associated crash.
  • [Runtime] Fixed a bug where action switches or solo/mute would be off for events that have manual position.
  • [Runtime] Fixed a bug where pops or rarely crashes could occur during convolution IR transitions.

10.0.27 - Mar 2, 2018

  • [Studio] Fix for keyboard decrementing setting to -96 on send gains.
  • [Studio] Layers can now be named.
  • [Studio] Layers can now have a volume envelope as well as a delay
  • [Studio] Most properties that have graphs now show the graph inline.
  • [Runtime] Fixed a bug where clearing the queue save function wouldn't work.
  • [Runtime] Added random latch length to random controllers, for a more "meandering" style of random.
  • [Runtime] Repeat Interval now properly respects controllers.
  • [Runtime] State Delays now properly respect controllers.
  • [Runtime] Updated the resamplers used for stepdown convolution reverbs.
  • [Studio] The "Recompress" button at the bottom of the Sources list now recompresses all selected sources.
  • [Studio] Moving a state in a play action now "undo"s a lot more intelligently.
  • [Studio] Fixed a crash when trying to rename play actions from the events list.
  • [Studio] Fixed a bug where the right click menu for event states would always use the first state when executing the action.
  • [Studio] Fixed "Show File In Explorer" when the project has a relative path adjustment set.
  • [Runtime] Fixed a bug where the new accessor for event and voice counts wouldn't provide the event count.
  • [Runtime] Fixed a bug where some convolution impulses would stop transitioning.

10.0.26 - Feb 13, 2018

  • [Runtime] Fixed an instance of the memory free callback passing the wrong size
  • [Studio] Source selecters now have a way to delete all their children.
  • [Studio] Filter templates can now force sync their users during auditioning.
  • [Studio] Fix for pasting events in nested folders getting placed in incorrect folders
  • [Studio] Now correctly handle a situation when Bus files somehow get out of sync with respect to dynamic routes.
  • [Studio] Hovering over the filter template name in an event now shows a tooltip with the filter template name.
  • [Runtime] Optimized the stereo resampler.
  • [Runtime] Optimized the biquad filter kernel (lowpass, highpass, bandpass, parmeq)
  • [Runtime] Optimzied handling of data pages for loaded sources.
  • [Runtime] Fixed a bug with convolution transitions failing occasionally.
  • [Runtime] Optimized the bus dynamics evaluation.
  • [Runtime] Added support for downsampling convolution reverb tails for speed.
  • [Runtime] Fixed a bug with soloing actions in events that contain run events.
  • [Runtime] Added PRX shared libraries to the PS4 distribution.
  • [Runtime] Added a runtime accessor for voice and event counts, to use in perf overlays.

10.0.25 - Jan 17, 2018

  • [Runtime] Optimized common usage patterns for the Compressor filter.
  • [Runtime] Routes (sends) can now spatialize to any channel count, not just the output hardware channels.
  • [Studio] Keyboard navigation improvements to the Assets tab: Ctrl-tab to switch tabs, tab to move between assets/filters, +/- adjusts some basic types (more as demanded), the current view follows keyboard navigation in the assets list, shift + up/down extends the asset selection, and ctrl-f moves the focus to the asset filter.
  • [Studio] The number keys load the corresponding project in the Load Recent dialog when opening Miles Studio.
  • [Runtime] Performance improvements to the Convolution Reverb.
  • [Runtime] The center and lfe channels now properly use the center impulse response in the Convolution Reverb.
  • [Runtime] Performance improvements to bus dynamics.
  • [Runtime] Basic profiling data has been refined.
  • [Studio] Fixed a crash when deleting buses under certain circumstances.
  • [Runtime] Fixed a crash when passing NaNs as controller values.

10.0.24 - Dec 19, 2017

  • [Runtime] Fixed an issue with distance scaling and snapshots, when the baseline mix value was not attached to a controller.
  • [Runtime] Added Linux x64 and Arm32 platforms, defaulting to ALSA output.
  • [Runtime] A capture API has been added, but is currently implemented only on linux.
  • [Studio] Fixed a bug where marking a tree of events as deprecated wouldn't work.
  • [Runtime] The default voice orientation has been updated to be in line with the default listener orientation.
  • [Studio] Added the ability to specify the direction and distance of an event from Miles Studio. The event is placed on the same 2d plane as the listener (identified by forward and left vectors), and is not moved after creation. Event's with manual positioning ignore positioning specified by the game. This position can also be in world coordinates, which will use the X/Z plane in that case.
  • [Studio] Added Random and Oscillator controller types.
  • [Studio] Added the ability to timelock a source selector. When a voice selects a branch or child in a selector, if timelocked, the voice will 'lock' the result for the given time in milliseconds. Any voice that uses that selector during that time will use the same result, until the lock expires. Then a new result is chosen using the selectors rules.
  • [Runtime] Miles no longer reports that there is no audio device on systems with no audio device if the game requested a null or memory output device.
  • [Studio] Fixed a crash when right clicking certain properties in the Assets view.
  • [Studio] Fixed a crash when sorting by name or type in the Assets view.
  • [Runtime] Fixed an incredibly annoying glitch in bink audio decoding that occurs when the system memcpy takes advantage of the 'overlapping buffers are undefined' behavior.
  • [Studio] Notes and labels can be edited from the Assets view, and can be used as a search filter.
  • [Runtime] Added a basic Gain filter. Currently for performance this filter alters the final volume scaling instead of running a full buffer multiply, and as such will not work correctly when placed before a non-linear filter (e.g compressor, gainblock).
  • [Studio] Fixed a crash when undoing a deleted bank.
  • [Runtime] Fixed a bug with volume and pitch controllers bound to Layers.
  • [Studio] Added the ability to randomize most properties that can be bound to a controller. The result is selected from a range and can be directed to favor mid, low, high, or none.

10.0.23 - Nov 2, 2017

  • [Studio] Added a way to hide the individual actions in the events list (right click on an event to see the option)
  • [Studio] The assets view now retains the bulk copy properties after an asset refresh.
  • [Studio] Properties bound to graph templates now show the controller in the Assets tab.
  • [Studio] Added the ability to mark an event "deprecated", which prevents the event from being compiled when the project is rendered.
  • [Studio] Fixed an issue where in high traffic auditions, the game and Miles Studio could get stuck waiting for each other to receive data.
  • [Runtime] Fixed an issue with multichannel send delays.
  • [Studio] MilesEventReferencesControllers has been updated to be consistent with what the event compiler believes the event uses.
  • [Runtime] Drivers will now report when no audio devices seem to be present.
  • [Runtime] Stop transitions now always ignore transition lockouts.
  • [Studio] Added filter chain templates. Events and Play actions can assign a filter template, which defines the filters on the asset. Filter parameters can be overridden at any level, and everything is propogated to "children". E.g. if an event selects a filter template, all of the play actions in that event will use that template, and if the event overrides a given property, all of the play actions will inherit that override. Filter chain templates can be created from an existing filter chain, or in the Templates tab. The templates tab also provides a way to find all assets that have the same filter structure, allowing all to be set to the template. Currently, filter templates do not work for buses.
  • [Runtime] Fixed a bug where send delay buffers could be leaked in certain use cases.
  • [Runtime] Fixed a bug with setting voice position on uncompressed sources.
  • [Studio] Graphs of Time properties no longer use 16 million as the vertical axis when editing.
  • [Studio] The results from controllers and graphs are now properly clamped to property limits to prevent out-of-bounds results.
  • [Runtime] The convolution reverb has been more optimized to handle longer impulse responses.
  • [Runtime] The convolution reverb now properly handles changes to the selected impulse response while audio is running through the filter.
  • [Studio] Fix for volume min/max variance not being properly editable when a controller is bound.
  • [Studio] Source selector nodes can be marked as "Latches", which prevents further evaluations of the source node for the same voice from selecting a different branch.
  • [Runtime] Smoothing controllers should now work in all cases.
  • [Studio] Graph Templates now have a menu option (off the gear) to mark users of the graph as audition dirty so that edits can be applied during audition.
  • [Studio] The Assets view now defaults to NOT automatically overridding inherited values when setting properties. To allow the old behavior, there is a checkbox at the top of the tab.
  • [Studio] Added "Initial Delay" property to events and play actions. Acts as Delay, except only on initial start instead of every state entry.
  • [Runtime] Adjusted the parametric EQ filter to be more numerically stable.

10.0.22 - Sept 7, 2017

  • [Studio] Fix for certain configurations of source selectors
  • [Studio] Fix for an upgrade path bug from .16
  • [Studio] Drop highlighting in source selectors is more clear
  • [Runtime] Bus controllers with no bound bus no longer crashes.
  • [Studio] Fix for graph template reference resolution failure during load.
  • [Studio] Batch Property Copy has been added to the Assets tab. Multiple properties can be copied from a single asset, and pasted in to any number of assets. Right click on the property in the assets list heading to add the property to the batch copy, then right click on the name of an asset and select "Copy Batch Properties". Once copied, select a set of assets, right click, and select "Paste Batch Properties" to apply.
  • [Runtime] Project recreation due to changes during auditioning has been updated to transition voices to the new bus hierarchy more consistently.
  • [Studio] Fix for a corruption issue with long controller functions.
  • [Runtime] Volume envelopes no longer crash when there is no currently active layer.
  • [Studio] Fix for a compress cache issue when Miles Studio shuts down with outstanding compressions.
  • [Runtime] The transition lockout has been removed currently due to being longer than some voices. It will return at some point with appropriate UI for controlling it.
  • [Runtime] MilesEventGetStarvedVoiceCount now actually returns nonzero when voices starve.
  • [Studio] The edit box for function controllers is now longer.
  • [Studio] Send delays are now editable in the assets view.
  • [Runtime] Fix for multichannel send delays.
  • [Runtime] The max registered convolution reverb count has been upped to 32 for iteration purposes. Note that actually shipping with this many in active use would likely be a performance issue!

10.0.21 - Aug 14, 2017

  • [Studio] IMPORTANT - Compress Cache has been dramatically updated. All sources will be recompressed on project load after upgrading.
  • [Studio] Compress cache is now unique to the project file.
  • [Studio] Compress cache is now 3 files instead of 1 per source wav.
  • [Studio] Compress cache is now correctly locked for multiple process access, allowing multiple instances of Miles Studio. Trying to write to a cache that is open for read in another process (ie the project is being rendered) will cause the source compression to fail, and it will need to be recompressed in Miles Studio.
  • [Studio] Compress cache relative paths are forced relative to the Miles Studio EXE, instead of the OS current directory.
  • [Runtime] Added accessor for hardware starvation count. Increments when the hardware API buffers fall to zero (ie when Miles isn't getting enough CPU time or has too high of a processing load.)
  • [Runtime] Added play action switches and conditions. Events can have switches, which will play a given play action based on the value of a controller. Actions can either be bound to a switch, or have a conditional controller, where the play action will only play if the controller is > 0.
  • [Runtime] Voice priority can now be bound to a controller. What was Zero Priority before is now a separate flag called "Evict Last".
  • [Runtime] Fixed a bug with muted voices not necessarily ending.
  • [Studio] Copy and Paste now works in the Templates tab list box.
  • [Studio] Template list box can be resized.
  • [Runtime] Priority Offset can now be bound to controllers.
  • [Studio] Properties bound to graphs in the Assets view will now show what controller the property is bound to.
  • [Studio] Controller preview values are now saved any time the project is saved, instead of only when Miles Studio is closed.
  • [Studio] Convert Controllers have been reenabled after a long hiatus.
  • [Runtime] Added an API to decode a saved queue buffer to a human-readable format.
  • [Runtime] Fixed a bug where if a layer was scheduled to stop before it ever started, it wouldn't ever start, no matter how far in the future the stop was scheduled.
  • [Studio] Sources now no longer store metadata regarding the file in perforce, preventing sync issues with source data from creating needless perforce accesses.
  • [Runtime] Fixed a crash with empty play actions in MilesGetEventDetails.
  • [Studio] Auditioning no longer potentially reads the wrong source data when files are updated and recompressed during audition.
  • [Studio] Auditioning performance on the Miles Studio side increased.

10.0.20 - July 26, 2017

  • [Runtime] Fix for direct controller references being able to provide out-of-bounds values for properties.
  • [Runtime/Studio] The RunEvent action can now select from a list of events based on a controller. Play action conditionals will be SoonTM.
  • [Studio] Controllers can now explicitly declare an initial value in case the game never sets a value.
  • [Runtime] Fix for dynamic route transitions that change the overall length of the route using an incorrect crossfade time.
  • [Runtime] Routed Sends bound to controller values that output to Dynamic Routes (I need better names) now properly update.
  • [Runtime/Studio] Virtual buses can now define a 3D Falloff Bias that is added to the 3D volume for voices that route through the bus. This falloff can be bound to sample controllers (i.e. distance controllers) to adjust overall falloffs for voices, and is crossfaded for dynamic routes.
  • [Runtime] Fix for controllers not updating their respective targets when a sample is created, unless the controller is changed after the voice is activated.
  • [Runtime] Fix for MilesQueueEventStartTime not working since the introduction of state based events.


  • [Runtime] Fix for a few bugs with non-unity distance scales.
  • [Studio] Fix for a Miles Studio crash with controllers bound to route channel levels.
  • [Runtime] Applying a named limit now immediately evicts voices over new voice count limits on buses.
  • [Studio] Fix for bus cycle detection and dynamic routes.


  • [Studio] Notes and string properties in the Assets view can be properly copy and pasted.
  • [Runtime/Studio] Routes (sends) can have independent delays, the duration of which can be set by Controller.
  • [Runtime] XBoxOne distribution has been switched to DLLs.
  • [Runtime] Fix for certain crashes with muted samples.
  • [Runtime] Fixed a crash with relative age priority adjustments
  • [Runtime/Studio] Buses can now have multiple primary outputs. Each voice can select its own path by controller, and the path can change while the voice is running, crossfading over a set number of milliseconds.
  • [Runtime] Stingers are now scheduled from when the state's source starts, rather than when the transition begins.
  • [Runtime] Entry cues now properly adjust the source start times when transitioning voice states.
  • [Studio] Fix for right-click deleting sources in a selector could delete the wrong entry.
  • [Studio] Dragging a source on to a selector now clearly shows whether the source will replace or append.
  • [Studio] Sliders have larger thumbs.


  • [Runtime] Fix for dynamics sometimes not evaluating immediately on voice activation.
  • [Studio] Fix for loading older compress caches that were sorted incorrectly.
  • [Studio] Fixed a crash where play actions with no sources wouldn't upgrade correctly.
  • [Runtime] Fixed filter decay samples not working with voices
  • [Runtime] Fixed a crash with convolution reverbs not updating the impulse response in certain cases during audition syncs.
  • [Studio] Fixed a crash with copy and pasting sources.
  • [Studio] P4 client specs can now contain . _ and -.
  • [Runtime] Delay and fades now once again default to wall-clock instead of beat-clock.
  • [Runtime] Playing a completed source that has had a new position set no longer rewinds the source.
  • [Studio] Double clicking an entry in a selector list once again auditions it
  • [Studio] Dragging a source on another entry in a list will replace instead of add (unless dragging on the title)
  • [Studio] The Source 'Properties' menu item is now first in the right click menu.
  • [Runtime] Fix for using distance scale in an unapplied snapshot
  • [Studio] Fix for undo crash when undoing action addition/removal.
  • [Studio] Previewing an event in Miles Studio now highlights the source that was selected.
  • [Studio] Preview values for controllers as well as certain dragger positions are now saved across execution.
  • Sources can now have BPM and signature specified for them, as well as an entry and exit cue marker. Currently BPM and signature are constant across the entire source. Beats are tracked from the entry cue marker.
  • [Studio] Source Properties now renders the waveform and allows for creating new markers that were not present in the source wav file.
  • Stingers - Voice States can now have "stingers" specified that will play when a set of conditions are met.
  • Voices can now disable their "Completion" transition, preventing them from being destroyed when their layers are complete (another transition must be executed in order to end the voice)
  • Signal transitions have been added - allowing transitions other than "stop" and "completion" between states. Transitions are executed when the controller on them is greater than zero.
  • [Studio] Game Controllers that are referenced by the selected event or any bus on the primary output route now have their preview sliders displayed above the default routing for the event.
  • [Studio] Rendering projects now stages stream writes in a memory buffer to decrease total seek count.

10.0.16 - May 14, 2017

  • State Based Voices - Voices can now maintain an active state, with transitions. This initial release is sparse on features - however new features should roll out rapidly from here on out. Currently, initial documentation is available by emailing
  • [Studio] UPGRADE NOTICE - if you are using blends Email before upgrading!
  • [Studio] FUNCTIONALITY CHANGE NOTICE - the sources that any event utilizing Repeats or Blends references must all have the same channel count.
  • [Studio] Miles Studio project files have had redundant information removed, dramatically decreasing on-disc space and parse time.
  • [Runtime] Fix a rare bug due to certain a starvation case in the bink audio decoder.
  • [Studio] The full path of projects is shown in the title bar, as well as the load recent dialog.
  • [Runtime] Structural/foundational work for upcoming adaptive music system.
  • [Runtime] Code for loading patches has been changed, removing the WaitingForPatches parameter in MilesBankLoad. Miles will automatically not complete the bank load until all patches have been delivered. The number of patches can be retrieved once the bank metadata has been loaded. See the documentation for MilesBankLoad for examples.
  • [Runtime] Fix for snapshots with an isolated baseline group not accumulating correctly.
  • [Studio] The main Miles Studio window's position and size is now saved across execution (!)
  • [Studio] Whether a folder is expanded or collapsed is now saved across execution.

10.0.15 - Mar 22, 2017

  • [Studio] Designers can now solo/mute buses via the buses list or right clicking on a bus.
  • [Studio] The Buses list now has a search bar
  • [Studio] Start action notes & labels are now searchable via the Assets view.

10.0.14 - Mar 20, 2017

  • [Studio] Fix for impulse responses during multiple client connections in a session.
  • [Runtime] Events can maintain their own randomizer state that can be seeded via API.

10.0.13 - Mar 15, 2017

  • [Studio] Added batch copy/rename for events. Select a group of events to copy the events as a group with a new name prefix.
  • [Runtime] Fix for profile auditioning with a patched runtime.
  • [Studio] Audition temps directory now uses a single-file cache for dramatic time improvements in streaming in sources after load.
  • [Studio] Only one instance of Miles Studio can be run at a time.
  • [Runtime] Added NX support.
  • [Studio] Added an export/import path for event/source linking, for batch editing in Excel.
  • [Studio] Fixed a bug where altering a source file without changing its size wouldn't mark the file for updating during auditioning.
  • [Studio] F2 renames, Shift-F2 copies the asset name to the clipboard.
  • [Studio] The search bars are now always visible.
  • [Studio] Replay queues can now be saved from Miles Studio when auditioning.
  • [Studio] Various loading time performance updates.
  • [Runtime] Source data in the event system is now paged, allowing dramatically smaller streamed memory footprints and lower wait times before voice start.
  • [Studio] The STREAMED availability type has been obviated by the new paging system, and has been removed.

10.0.12 - Jan 25, 2017

  • [Runtime] Initial HRTF support added.
  • Convolution Reverb added. See docs for how to specify impulse responses in Miles Studio.
  • [Runtime] Denormal issue fixed
  • [Runtime] Fix for a mixing issue when the WASAPI output device was changed during runtime to another channel count.

10.0.11 - Jan 9, 2017

  • [Studio] Lots of UI improvements with viewing bus dynamics in the client debugger
  • [Runtime] Event system resuming now uses the event id from the pause to resume sounds, to prevent issues with the filter returning different sets of sounds.
  • [Studio, Runtime] When targeting a bus via the Pause Sounds event, this now sets a latch on the bus to stop all sounds on the bus, until the latch is cleared using a Resume Sounds event.
  • [Runtime] The initial controller value has been changed to 0, from the minimum value.
  • [Runtime] Fix for evicted loaders not managing sound memory limits correctly
  • [Studio] The Default routing type has been changed to be Routed pointing to a global default routing.
  • [Runtime] 8.1 and 6.1 have been removed, contact support if 8.1+ is needed.
  • [Runtime] Fix for preload buffer going past end of file.
  • [Runtime] Fix for rare issue with Bink Audio seek tables failed at end of file.
  • [Studio] Ducks are now automatically separated in to a distinct snapshot group to allow for default behavior to accumulate with baseline.
  • [Studio] Added access to the CHM help file from within Miles Studio
  • [Studio] Stability fixes
  • [Studio] UI for assigning groups to snapshots has been dramatically improved.
  • [Studio] Auditioning snapshots has been changed - right click and select "Listen To This" to activate the snapshot. Multiple snapshot groups can now be active at once.
  • [Runtime] The Miles Version is now 4 digits. The final digit is for fixes integrated in to previous releases.
  • [Studio] Improved readouts for command line building.
  • [Runtime] Patch diff is now generated using the source hash + compression settings instead of compressed hash.
  • [Studio] Full recompress of large projects from the UI now uses less memory and doesn't slog down the Windows VM system.
  • [Studio] Fix for large full recompresses occassionally failing one or two files due to spurious Windows errors.
  • [Studio] Number of threads for compression is now controllable via command line option, and defaults to a higher number to speed up full recompression.
  • [Studio] Command line args have been standardized: -load is now --load, -nocache is now --nocache.
  • [Runtime/Studio] Bink Audio no longer needs Process For Looping to seamlessly loop.
  • [Runtime] Functions with ActiveEvent has been renamed to UpdateEvent for API clarity.
  • [Studio] Concrete buses have been renamed to Mixing buses for clarity.
  • [Studio] Fix for loading empty projects
  • [Studio] Various fixes for auditioning during edge cases.
  • [Studio] Can now right click->create event from the Missing Events UI in the Client Debugger.
  • [Runtime] Fix for volume changes on a bus than has no audio streaming through it getting interpolated on next activation, causing pops in some cases.
  • [Runtime] Bus Dynamics are applied prior to first voice start to avoid pops in some cases.
  • [Runtime] Fix for 3D pan fold being slightly off if the voice position is off the listener plane.
  • [Runtime] Added WinUWP(RT) support.

10.0.10 - Sept 1, 2016

  • [Runtime] Seeked voice starts now wait for a bit more headroom before assigning the voice.
  • [Studio] Virtual buses are now colored correctly in the event details pane.
  • [Studio] The -nocache command parameter now works.
  • [Runtime] Voice starvations that occur right before the requisite load completes now properly resume the voice instead of stopping it.
  • [Runtime] Voice starvations now properly resume once the data arrives, instead of rewinding.
  • [Studio] Source properties now provide a way to list the events referencing the source.
  • [Studio] Fixed a crash when viewing bus dynamics in the client debugger.
  • [Studio] Fixed a lane assignment bug when viewing activated ducks in the client debugger.

10.0.9 - Aug 24, 2016

  • [Runtime] Fixed a bug from 10.0.8 where starved voices would never restart.
  • [Runtime] Renamed MilesQueueEventFilterIndex to MilesQueueEventFilterTemplateId
  • [Studio] UI for virtual bus properties now hides channel count, as virtual buses have no channel count.

10.0.8 - Aug 21, 2016

  • [Runtime] Fixed a bug where activated ducks would lose track when auditioning and a project resync happened.
  • [Studio] The Stream Buffer Size for a source is now editable in the Assets view.
  • [Runtime] Fixed a bug where streamed files smaller than the preload size would crash on end of buffer
  • [Studio] Under auditioning, Streamed availability is forced to Buffered.
  • [Runtime] Fixed a bug where a sample's Routing would get set prior to sample setup when the source was Streamed.
  • [Studio] Fixed a bug where using the Assets view to set a source's availability back to Default would cause a crash.
  • [Runtime] Large Buffered Sources that are seeked several seconds in to the sound now have their loads split, allowing the data near the seek point to be streamed in without waiting for the rest of the file.
  • [Runtime] NaN paranoia is back off.

10.0.7 - Aug 15, 2016

  • [Studio] Fix for Check Routing finding errors on inactive sends.
  • [Studio] Fixed a bug where if the sum of all priority adjustments on a primary output route hit zero, the voice would never evict.
  • [Studio] Fixed a big where Volume Envelope inheritance was uneditable.
  • [Studio] When selecting a bus in the Design pane, all input buses are highlighted as well as output.
  • [Studio] In the Event Details view, the entire output chain is rendered for play actions and defaults.
  • [Studio] Misc UI clarifications and consistency fixes.
  • [Runtime] Fixed a bug where an undefined function controller would cause a crash.
  • [Runtime] NaN paranoia is STILL ON
  • [Studio] Fix for a crash in routing error checking if the selection extended past the end.
  • Documentation updates.

10.0.6 - Aug 8, 2016

  • [Studio] Minor UI changes for clarity in Miles Studio
  • [Runtime] Fixed a bug with optimized mute where the output buffer wouldn't get zerod correctly in some cases.
  • [Runtime] MilesAuditionStartup and MilesAuditionConnect now properly take the API lock.
  • [Studio] Patches can now be generated without the shipping build flag for testing purposes (only from the command line)
  • [Studio] Fixed a bug where Miles Studio would try to validate routes on sends that had been deleted.
  • [Runtime] NaN paranoia is STILL ON

10.0.5 - Aug 2, 2016

  • [Runtime] Enable NaN Paranoia

10.0.4 - Aug 2, 2016

  • [Runtime] Fixed device format changes when using the XAudio layer causing a lockup.
  • [Runtime] Added more WASAPI compatibility paranoia with IAudioClient::Initialize (Now directly use the mix format pointer they give us)
  • [Studio] Pre/Post compression sample rates now visible in Assets View.
  • [Runtime] Updated several filters to flush NaNs that creep in to the histories.
  • [Runtime] FTZ now set for SSE operations during a mix.
  • [Runtime] Added saved reference pointers for post mortem forensics to buses.
  • [Runtime] Removed a spurious Report during MilesShutdown.

10.0.3 - July 27, 2016

  • Auditioning event lookup sped up dramatically
  • Fix for localized sounds reporting an incorrect TemplateId in MilesBankGetSourceTemplateId
  • Fix for Miles Studio crash when recompressing currently compressing localized sources.
  • Fix for Miles Studio incorrectly handling added files in Perforce.
  • Miles Studio is now more robust against WAV file types that aren't supported.
  • Checking for routing errors now marks the relevant play actions, so they can be searched in the Assets View (@Routing Error). Only refreshes when the dialog is reopened.
  • Property filtering in the assets view is more intuitive (comma separated list of substring matches)
  • Fixed a bug where Random List nodes were limited to 32 children (now matches other nodes at 255)

10.0.2 - July 25, 2016

  • * Decoders are now DLLs on windows, due to an unavoidable compatibility issue with static libs between Visual Studio versions. *
  • Added a new memory tracking level for retaining details free information with large allocations.
  • Fix for Miles Studio incorrectly handling re-added files in Perforce
  • Fix for a crash in the Asset View
  • Link Randomizers is now accessible in the Asset View
  • Fix for syncing an auditioned client immediately after saving not working.
  • A warning is now displayed when using a Duck mixer snapshot in an Apply Snapshot action.
  • Build Tags are now supported to prevent mismatched bank / stream files during development.
  • MilesAsyncSetCallbacks can now be used to return the callbacks to default
  • Fixed a bug when creating new sources when a path adjustment had been set in the project settings.
  • The Client Debugger now reports the levels for concrete buses.
  • Fix for unresponsive UI when a bus has a controller bound to an output gain as well as an input gain.
  • Fix for some paused sounds not responding to a stop command
  • Fix for Miles Studio trying to evict sounds when not all languages are present and loaded.
  • Added an optimized mute function to enable fast-pass for when apps are in the background.
  • Fix for an occasional crash when deleting sources in Miles Studio
  • Reverted a 10.0.1 changes where paused sounds were deactivating their ducks.
  • Fixed a bug in Miles Studio where an event with the same name as a bus would fail to preview if the capitalization were different.
  • Added UI for finding routing fallback failures.

10.0.1 - July 8, 2016

  • Fix for syncing sources with default events under audition
  • Fix for a class of auditioning crashes
  • Cap iteration loop in EventGetDetails to prevent locks when presented with degenerate data
  • Fallback to XAudio when XAudio fails.
  • Support for grouping Sample allocations for better cache coherency when mixing.
  • Fix for a crash when playing uncompressed files in the high level.
  • PostParseCache flag is now properly retained across upgrades.
  • Projects can now set a relative path adjustment, which causes the stored relative path in Sources to not be from the project directory, but instead from a directory "above" it.
  • Fix for missing events not showing correctly in the Client Debugger.
  • Readability adjustments for Code events in the Client Debugger.
  • Fix for selecting a bus dynamic in the Client Debugger.
  • Pausing a voice now deactivates its ducks, reactivating on resume.
  • Added Activated Ducks UI to Client Debugger.

Changes from 9.4e to 9.4f (12-11-2019)

  • Fixed iOS link error.
  • Updated to latest platform SDKs.

Changes from 9.4d to 9.4e (6-25-2019)

  • Fixed android arm64 issue.
  • Updated to latest platform SDKs.
  • Removed SPU support (old version with SPU support available on request).

Changes from 9.4c to 9.4d (7-7-2017)

  • Timer implementation adjusted to be less vulnerable to pathological timer issues.
  • Updated to Nintendo NX SDK 3.0.

Changes from 9.4b to 9.4c (4-12-2017)

  • Timer implementation adjusted to be less vulnerable to pathological timer issues.
  • Updated to Nintendo NX SDK 3.0.

Changes from 9.4a to 9.4b (2-2-2017)

  • Fixes for NX
  • Switched to DLLs for XBox One

Changes from 9.3z to 9.4a (11-14-2016)

  • Added new secret platform (Contact Mitch).
  • Threading and synchronization primitives updated.

Changes from 9.3y to 9.3z (6-2-2016)

  • Added function to restart audio after iOS phone call/alarm.
  • Fixed a crash in the high-level under certain out of memory conditions.
  • Dropped the LTCG libs on Xbox 360 and Xbox One (not worth the compiler versioning pain).

Changes from 9.3x to 9.3y (2-11-2016)

  • Added Android ARM64 build.
  • Added Apple tvOS build.
  • Allow setting of the DirectSound HWND before opening the sound driver.
  • Fixed a crash when DirectSound can't find an app HWND to use.

Changes from 9.3w to 9.3x (1-21-2016)

  • Added iOS bitcode.
  • Updated SDKs for Orbis and Durango.
  • Windows 10 Universal binaries added.

Changes from 9.3v to 9.3w (6-8-2015)

  • Fixed an issue with wall clock usage on PS4.

Changes from 9.3u to 9.3v (5-18-2015)

  • Fixed an issue with wildcard matching in the event system.
  • PS4 mixer overhead has been optimized.
  • Fixed an issue with multiple audio instances on Android.

Changes from 9.3t to 9.3u (12-17-2014)

  • Added an ARM64 target to the iOS build.
  • Fixed an issue with enumerating the active presets.
  • Fixed an issue with seeking Bink audio files in certain situations.

Changes from 9.3s to 9.3t (10-13-2014)

  • PS4 audio output granularity lowered, which prevents long mix mutex holds.
  • Updated to the new public radtypes header from rrCore.
  • Fix for race condition when rewinding compressed samples that are nearly complete.
  • Fix for potential alignment issues with queued user buffers in the high level.
  • Generic output management has changed - if you use AIL_open_generic_digital_driver, the RADSS install function is now a AIL_output_x function of the relevant type in order to add clarity.

Changes from 9.3r to 9.3s (8-22-2014)

  • Fixed a literal one-in-a-billion bug.

Changes from 9.3q to 9.3r (8-21-2014)

  • Expose the PS4 audio submit thread and sit initial priority to +3.

Changes from 9.3p to 9.3q (8-16-2014)

  • Fix a race condition when enqueuing events.

Changes from 9.3o to 9.3p (8-12-2014)

  • Fixed command line parsing of languages in Miles Studio.
  • Fixed an occasional bug in Miles Studio when auditioning buses.
  • The side-chain compressor now has a couple of new ways to work that are more useful than a 'classic' side-chain compressor.

Changes from 9.3n to 9.3o (7-23-2014)

  • Updated an internal cache in the event system to save handle heap space.
  • Added a flag to force mixing to start as soon as the driver is opened.
  • Fixed a linker issue on PS4.
  • Fixed an issue with label references not being found when using multiple banks.

Changes from 9.3m to 9.3n (7-9-2014)

  • Fixed an issue with pausing recently started sounds in the high level.

Changes from 9.3L to 9.3m (6-20-2014)

  • On PS Vita, fixed a rare linker issue.
  • Added Android as a target platform for the Miles Sound Studio.
  • On Android, fall back to sdcard if files aren't found in the package.
  • Fixed a bug where very short streams never ended.

Changes from 9.3k to 9.3L (5-28-2014)

  • [Android] Workarounds added for GCC 4.8 optimizer philosophy.
  • Fix for some edge case async read failures.
  • [Studio] Fix for a crash on exit.
  • Fix for AIL_minimum_sample_buffer_size returning incorrect values on some platforms.
  • Fix for sound-local variables in the event system.

Changes from 9.3i to 9.3k (4-8-2014)

  • Added 32-bit x86 and ARM Windows Phone support.
  • Fixed nasty bug in the event system.

Changes from 9.3h to 9.3i (4-7-2014)

  • Added 64-bit MacOS X support.
  • Added 64-bit Linux support
  • Added 32-bit x86, 64-bit x86 and ARM Windows Store App 8.0 and 8.1 support.
  • Added x86 Android support.
  • Added workaround for some Android devices to avoid incessant skipping due to aggressive power policies.
  • Added workaround for some Android devices to avoid the speaker popping on open.
  • Switched to CoreAudio for recoding on MacOSX due to OS bug.
  • Fixed SELinux integration issue from version 9.3h.

Changes from 9.3g to 9.3h (3-14-2014)

  • Integrated changes from Valve to run on SELinux.
  • On Xbox One, switched to the March XDK.

Changes from 9.3f to 9.3g (12-4-2013)

  • [Vita] Fix for OGG files on Vita.
  • Misc minor edge case fixes.
  • Fix for MP3 on x64 linux.
  • [Studio] Fix for a race condition when using custom temp directories.
  • Windows AIL_last_error() will no longer report an error on successful multichannel driver creation.
  • Soundbank information functions will now work correctly when auditioning.

Changes from 9.3e to 9.3f (10-14-2013)

  • Speaker routing is only allocated if channel mask is non standard.
  • [Studio] Compressed audition files can now use a temporary path.
  • [Studio] Fix for compressing banks from the command line.
  • [Studio] Connected clients now use the selected audition language instead of the game language.
  • [PS4] Fix for certain semaphore usage cases.
  • [Studio] Win64 platform added.
  • [Studio] stdout redirection updated for certain cases.
  • [Studio] A rare perforce error is now handled.
  • [Studio] Fix for deleting assets under source control.
  • [Studio] Various crashes fixed.
  • Fix for certain cases using directsound on windows.
  • Fix for Xbox One jump tables.

Changes from 9.3d to 9.3e (4-24-2013)

  • Fix for latency bug associated with recent granularity change on Win32.
  • Fix for dashes in clientspecs in MilesStudio.
  • Fix for relocated sound banks with certain invalid relative paths causing a crash.
  • Fix for blended sounds.
  • Added hook for high level sample creation.
  • Fix for platform compression defaults breaking.
  • Update to GCC 4.7 on android.

Changes from 9.3c to 9.3d (2-1-2013)

  • Fix popping on 3d samples.
  • Fix Win64 RIB loading

Changes from 9.3b to 9.3c (1-23-2013)

  • iOS fix for Siri.
  • Fix for samples having more channels than output.
  • Fix for packing causing potential alignment issues.

Changes from 9.3a to 9.3b (12-12-2012)

  • AIL_WAV_marker_* functions now recognizes loop points set via the SMPL chunk as markers of name LoopStart and LoopEnd.
  • Bink Audio now support sample-accurate loop points via the new AIL_set_sample_loop_samples function.
  • Miles Studio now reconizes markers from source waves and will retain positioning when compressed using Bink Audio.
  • Multiple OpenAL devices now continue functioning across AIL_close_digital_driver.

Changes from 9.2c to 9.3a (11-26-2012)

  • Big, new release with lots of new low- and high- level features!
  • Added Android and another secret platform.
  • Adding pushing and popping of the sound system state!! AIL_push_system_state allows temporary reset/resume of entire sound state (useful, for example, when popping up a menu over the game).
  • Added AIL_end_fade_sample - ends with a fadeout, instead of hard clip.
  • Added AIL_schedule_start_sample - schedules a sample to start at an exact time.
  • Added AIL_start/stop/resume/end_sample_group - control a group of samples at the exact same time.
  • Default mix granularity is now 1 millisecond on all platforms.
  • Added the concept of spread - how much a 3d spatialized sound spreads to surrounding speakers.
  • Added line segment based sample positioning. You can now represent a sample's position as a series of line segments instead of a single point (also useful for area based sounds).
  • Allow OpenAL to share the ALContext to prevent threading issues with multiple open contexts.
  • Example PS3 now uses MSS_MC_STEREO for Stereo PS3 output.
  • On Wii-U, fxied surround speakers going to the right speaker.
  • On Wii-U, protect against invalid buffer position reads.
  • On MacOSX, fix headphones insertion/removal.

Changes from 9.2b to 9.2c (9-11-2012)

  • Miles now supports graphs for distance based computations! Low pass, Volume, and Exclusion can be controll via graph over distance.
  • Fixed a crash when under extremely high loads in the event system.
  • Miles will now attempt to continue processing the event queue on error, instead of aborting.
  • Bugfix for high-level limits.
  • [Studio] Variables can now be transformed by the sound designer using a graph.
  • Switched to 2.07.03 Wii-U SDK.

Changes from 9.2a to 9.2b (8-15-2012)

  • Fixed memory leak when streaming very small files.
  • Misc event system bugfixes.
  • Added an example for sidechain compression.
  • Bug fix for very large reverb predelays.
  • Closing sync datastructure changed from Mutex to Semaphore to allow AIL_shutdown to be called from another thread.
  • Linux rpath handled correctly, along with shared object dependencies.
  • [Studio] Sounds can now be marked as Gathered, which will allow management of many sounds under one asset. Primarily for dialog usage.
  • [Studio] Misc bug fixes in Miles Studio.

Changes from 9.1f to 9.2a (7-12-2012)

  • [Studio] Added per platform compression defaults.
  • Various bug fixed related to Limits.
  • [Studio] Various minor fixes.
  • Enqueuing events has been altered to support initializing various values.
  • [Studio] Added more options during multiselect.
  • [Studio] A sound with a path containing a language reference can be set to pull from a different directory for each language.
  • [Studio] Added an option to remove unreferenced sounds during complication.
  • Sound Selection has been added - very useful for dialog!
  • [Studio] Support for editing the prefix used with Create Event For Sound.
  • [Studio] Sounds can now be ordered in Cache Sounds events.
  • [Studio] Basic compilation stats can be written to a parallel file.
  • Sound sources now have a mix volume for attentuation on a per source basis.
  • A basic limiter can be enabled on a bus or driver to prevent clipping.

Changes from 9.1e to 9.1f (6-4-2012)

  • Switched to WiiU FS API (from FSA which has been deprecated).
  • Removed deprecated AXSetMode calls on WiiU.
  • Miles Sound Studio fixes for Windows XP.
  • Added secret platform (contact us for details).

Changes from 9.1d to 9.1e (5-4-2012)

  • Fixed a subtle bug on iOS where the background threads were sleeping too little - big performance increase!
  • Switched to Wii-U SDK 2.04.
  • Fixed a few bugs in the Miles Sound Studio.

Changes from 9.1c to 9.1d (4-19-2012)

  • Miles now supports busses! Assign samples to busses and treat the group as any other HSAMPLE.
  • In Miles Studio, busses have been added to settings. This requires a rebuild of compiled banks.
  • A compressor filter has been added for side-chaining from other busses.
  • [WiiU] DRC support added. A new example demonstrates this.
  • [WiiU] Bug fix with streaming.

Changes from 9.1b to 9.1c (4-3-2012)

  • Miles Studio 64bit now available!
  • In Miles Studio, Banks will upgrade in this release, and compiled banks will need to be recompiled!
  • In Miles Studio, the sounds that are not ready to audition are listed under bank properties.
  • In Miles Studio, only top level assets will appear in search dialogs.
  • In Miles Studio, dragging a folder with both sounds and banks will no longer pollute the recent files list.
  • In Miles Studio, various edge case crashes fixed.
  • In Miles Studio, Cache Sounds is now capped, and will encounter fewer issues when loading very large numbers of files.
  • In Miles Studio, sound designers can now move and control variables without programmer intervention.
  • In Miles Studio, sound designers can mark a variable to oscillate at low frequencies (less than 15hz).
  • Switch to SDK 2.03 on WiiU.
  • PSP2 Threads have better core management.
  • The number of milliseconds of audio a sample has produced in total is now available via AIL_sample_mixed_ms().
  • binka_encode can now resample prior to compression.

Changes from 9.1a to 9.1b (2-16-2012)

  • Fixed a variety of minor bugs with the event system and Miles Studio.

Changes from 9.0g to 9.1a (12-10-2011)

  • In Miles Studio, settings banks are introduced. Details are in the docs, please CONTACT us if you have *any* issues upgrading!
  • In Miles Studio, fixed an occasional spinlock when auditioning.
  • Switched to SDK 1.9 on WiiU.
  • Switched to SDK 2.4.2 on the 3DS.
  • Auditioning support on WiiU.
  • Auditioning support on Vita.
  • Variety of runtime bugs fixed.
  • Updated UI for network and info tab.
  • Added Audition Client Example to use for testing out hotloading and timeline captures without you're own game.

Changes from 9.0f to 9.0g (11-01-2011)

  • In Miles Studio, fixed a bug where source control queues would fail to get a correct result from p4.exe.
  • Updated iOS example to include basic event functionality.
  • Fixed a random crash when using AIL_enqueue_event_by_name.
  • Switched to SDK 1.8 on a secret platform.
  • In Miles Studio, fixed drag-and-drop not matching capitalized extensions(e.g. .WAV vs .wav).
  • In Miles Studio, fixed a memory leak related to waveform rendering.
  • In Miles Studio, fixed various minor gui bugs.
  • Updated to Telemetry 1.1a.

Changes from 9.0e to 9.0f (10-03-2011)

  • Fixed a bug when async loading files less than 4K in size with an offset into a file on a secret platform.
  • Switched to SDK 1.7 on a secret platform.
  • In Miles Studio, fixed 'use source control' never saving.
  • In Miles Studio, fixed removing compression during multi-select.

Changes from 9.0d to 9.0e (08-18-2011)

  • Fixed a bug when async loading files less than 4K in size.
  • Added a function to get the rough length of a high-level event.

Changes from 9.0c to 9.0d (08-15-2011)

  • Fixed a new save errors in the new tool.
  • Added a new NDAed Nintendo platform.
  • Updated iOS thread primitives.
  • On 3DS, updated to SDK 2.4.

Changes from 9.0b to 9.0c (07-28-2011)

  • Fix AIL_stream_status for very short sound samples.
  • Adding the Sony NGP platform.
  • Child assets are now listed in the main asset list.
  • Added a way to find dangling asset references, as well as unused assets.
  • Added a way to requeue failed loads in the high level system due to removed discs.
  • Updated Mac and GNU/Linux to latest 9.0 runtime.

Changes from 9.0a to 9.0b (07-12-2011)

  • Fix for endianness in compiled banks in some cases.
  • Various UI fixes in Miles Studio.
  • Fix for duplicate persisted presets with the same name.
  • Fix for multiple sound assets with the same file size.
  • Fix for occasional event system asyncs never completing.

Changes from 8.0k to 9.0a (07-04-2011)

  • Introducing the new Miles Studio 9! Completely rewritten to be more usable and powerful.
  • Games can now connect to Miles Studio, which will allow complete replays of recorded sessions.
  • New file structure for banks allows for multi-user editing.
  • Miles Studio Perforce integration.
  • Recorded sessions allow for in-depth debugging and performance analysis.
  • Connected clients can hot load assets from Miles Studio.
  • High level variables are introduced and can be used for game-driven properties.
  • Vastly improved streaming and threading.
  • Blended sounds allow for crossfading and pitchbending between groups of sounds.
  • Sound banks now compile and are loaded in place in very few allocations.
  • Sound loading in the event system is now all asynchronous and hitch-free.
  • Ramps allow for smooth interpolation of volume, wet level, low pass, and pitch.
  • Multiselection/unlimited undo for easy editing in Miles Studio.
  • Intuitive asset specialization for platform and language.
  • Miles Studio background loading and compression of sounds.

Changes from 8.0j to 8.0k (05-15-2011)

  • Added iOS as an official platform (had been shipping as beta for a long time).
  • The iOS libraries are now fat and contain simulator, ARM 6 and ARM 7 versions.
  • Fixed a bug that caused Ogg Vorbis files less than 8 KB long to fail to play.
  • Fixed a bug that could cause AIL_enumerate_BinkA_frames() to crash.
  • Fixed a bug in the Wii file IO code (with small seeks forward).
  • Fixed a problem when resuming a stream that had not been started.
  • Fixed some corner cases in AIL_stream_status.
  • Changed some memcpys to memmoves.
  • On 3DS, build with more optimized settings.
  • On 3DS, work around some odd semi-hosted linker errors.
  • On 3DS, switched to light semaphores, since there are only 8 'real' ones (systemwide).

Changes from 8.0i to 8.0j (03-15-2011)

  • Fixed bug that could cause crashes when seeking within Ogg Vorbis files under certain conditions.
  • Fixed bug that could cause AIL_stream_status() to incorrectly return SMP_PLAYING after stream termination.
  • Fixed bug that could cause AIL_start_stream() to fail to restart a completed stream under certain conditions.
  • Fixed bug that could cause streams to stop playing after calling AIL_set_stream_position() under certain conditions.
  • Released for Nintendo 3DS!
  • On Xbox, switched to the Feb 2011 XDK.
  • Cleaned up some missing files from the source distributions.

Changes from 8.0h to 8.0i (01-26-2011)

  • Fixed deadlock in the streaming code (when under heavy IO load).
  • Fixed a bug on machines with more than 32 cores.
  • Changed the referencing of external asset files in a sound bank to allow the file size to change after deploying.
  • Fixed a bug where external referenced file names weren't being compared case insensitively.

Changes from 8.0g to 8.0h (01-13-2011)

  • Fixed a bug in the Bink audio encoder where a bit of data could be lost after the first block.
  • Fixed a bug in the makeloop utility where Bink audio files are looped improperly.
  • Fixed a bug if you used a sub-block loop with a position beyond the end of the buffer.

Changes from 8.0f to 8.0g (12-06-2010)

  • All new IO and streaming system (optimized with Telemetry) - uses background thread loading on all platforms (including Wii). Much, much better sharing when reading from multiple streams at once. You can even read static files during streaming safely.
  • Millisecond accurate Bink Audio seeking and querying has been added (including streams). Bink Audio are compressed with a seek table and you can seek time-perfectly now.
  • Added Telemetry markup throughout Miles - if you have Telemetry, then you can monitor all Miles resources automatically.
  • On Windows, fixed the AIL_delay function to be milliseconds (instead of 60ths of a second).
  • On Wii, we are now thread based instead of interrupted based.
  • On Wii, we now require you to install a memory allocator by default (and it has to be thread safe).
  • Added the AIL_sample_loaded_len function which returns the number of bytes queued on the HSAMPLE in total.
  • Added the AIL_stream_filled_percent function wihich returns the percentage that the IO buffer is full for the specified HSTREAM.
  • Switched to Visual Studio 2008 on Windows (and built with stack frames, so traces are cleaner).
  • Added the AIL_timer_thread_handle function to return the platform's thread handle (HANDLE on Windows, sys_ppu_thread_t on PS3, etc) for the Miles timer and mixer thread.
  • Added the AIL_IO_thread_handle function to return the platform's thread handle for the Miles IO thread.
  • Several fixes to the Bink Audio encoder to enable accurate seeking.
  • For convenience, AIL_sample_output_levels() now returns a single value that reflects the peak amplitude of any/all channels in the HSAMPLE.

Changes from 8.0e to 8.0f (10-14-2010)

  • MAKELOOP.EXE no longer tries to open the sound hardware, so it can run on a server.
  • Tempfiles created by MAKELOOP.EXE and BINKA_ENCODE.EXE are now deleted properly.
  • .WAV file streaming now works with filename offset/len markup for packed-file access. Previously, only compressed formats worked with this feature.
  • Durations calculated correctly for Bink Audio files in Miles Sound Studio and in the streaming API.
  • Exit codes when command line building is set properly on error.
  • Write mini-dumps in user folder for permissions.
  • Added -o[path] option to Miles Sound Studio to specify the output directory.
  • Made the Miles Sound Studio handle redirected stdout correctly (surprisingly tweaky).

Changes from 8.0d to 8.0e (07-07-2010)

  • Functionality change: The programmer must add a soundbank to be available to the high-level event system before it can be used. Previously, the high-level event system would load a soundbank if it was referenced, but this caused too many accidental loads. Now you must first call AIL_add_soundbank before it can be used.
  • File format change: The Miles Soundbank format has changed. To update your master soundbanks, run the bankupgrade.exe utility (in the tools directory) on each soundbank.
  • Fixed a bug that could cause audible glitches after multiple iterations of looped .MP3s and other compressed samples.
  • Fixed a clicking bug when flipping between DSP-filtered and non-DSP-filtered modes (rarely audible).
  • Fixed a bug in the Miles Sound Studio where you couldn't delete a sound asset, if the source sound asset could not be found.
  • Added a Bink Audio button to all of the console examples.
  • Fixed a mixing bug when applying resampling to an uncompressed sample that had any DSP filtering on it.
  • Fixed an optimization bug where the SPU would play static for any DSP filter.
  • Removed the concept of a base path from the event system, as all sound banks must now be added explicitly.
  • Fixed a bug where event comments could cause an event to fail at runtime.
  • Fixed a bug where a streaming sound started via event could not start successfully.
  • Fixed a minor memory overwrite bug in the event system.
  • Fixed a pathing bug where sounds might not be correctly located relative to their banks.
  • Path separators are canonized to forward slashes on most platforms now.
  • Added a few more informational fields to the MILESEVENTSOUNDINFO structure.
  • Added high-level event system callbacks for more sophisticated resource management.
  • Switched to the new standard RAD type header file (rrcore.h).
  • Added the Bink Audio SPU library to the distribute (previously built-in the Miles SPU library, but that made rebuilding difficult).
  • For static library platforms, fixed a bug to allow Bink and Bink Audio to coexist in the same application.

Changes from 8.0c to 8.0d (05-17-2010)

  • On the PS3, Bink Audio is now decompressed on the SPU!
  • Official release of Miles for the Sony PSP!
  • Bink Audio is about 10% faster on all platforms and uses less memory during decompression (it now uses the least memory of all codecs, by far).
  • Bink Audio uses less code and table space on all platforms as well.
  • Fixed a bug when looping a streamed Bink Audio file.
  • Bumped up the maximum Bink Audio channels to 8 (for 7.1 audio).
  • The Miles Sound Studio can now accept drag-n-dropped files.
  • You can now create label queries in the Miles Sound System (with wildcards and logical matching).
  • Increased the background thread space by 16 KB on all platforms.
  • Fixed a bug in the AIL_sample_playback_delay query function.
  • Worked around a hardware bug with XMA audio when streaming multichannel audio files.
  • Clarified the documentation for the DIG_3D_MUTE_AT_MAX preference and related behavior.
  • Fixed an issue with stereo input files in the WAVMUX utility.
  • binka_encode no longer uses hardcoded tempfile names.

Changes from 8.0b to 8.0c (03-20-2010)

  • Added new features to the eventtest example application.
  • Added error callback for the event system.
  • Several fixes to event system runtime.
  • More XMA fixes for streamed sounds.
  • Fixed several crashes in the Miles Sound Studio.
  • Cleaned up the file extensions in binka_encode.

Changes from 8.0a to 8.0b (03-04-2010)

  • Added the Linux platform.
  • Added the MacOS platform.
  • Fixed a goofy build problem on Win64.
  • Optimized the plug-in data structures (which saved about 100k of static runtime memory).
  • Worked around a few more XMA weirdnesses - sigh.

Changes from 7.2g to 8.0a (02-25-2010)

  • Added the new high-level Miles Sound Studio tool! Now your sound designers can create sophisticated soundscapes without any programmer involvement! Author sound assets, sound presets, environmental factors and sound events and then deploy them for different platforms!
  • Added high-level event system APIs so that programmers can trigger sound events authored with the Miles Sound Studio.
  • Added the new Bink Audio compression format - it is close to MP3 and Ogg in compression size, but uses around 40% less CPU and far less memory! We expect most customers to use this format - it's perfect for games!
  • Added full SPU support for the PS3 - mixing, decompression, DSP filters and reverb are all on the SPU. Miles now uses no PPU cycles!
  • Optimized the ADPCM decoder on most platforms to be 10 to 20% faster.
  • Added separate control to the wet and dry path of all of the DSP filters (instead of just a mix parameter).
  • Added the new AIL_set_sample_playback_delay function, which lets you start a sample with a millisecond delay.
  • Made AIL_decompress_ADPCM and AIL_decompress_ASI more memory efficient and faster with large files.
  • Switched the Mac build to use CoreAudio for multi-channel output support.
  • Added Altivec and SSE optimizations to the Mac build.
  • The Mac and GNU/Linux builds both now use our Windows-DLL loader for their plug-ins.
  • Optimized a lot of the memory layout for SPU, which helped the performance for most of the other platforms.
  • Merged the Win32 and Win64 builds - there is now just one Windows platform.
  • Added beta versions of Sony PSP and Apple iPhone.
  • Optimized the MP3 decoder - uses much less memory and is faster.
  • Added tons of SIMD optimizations for mixing, clamping, MP3 and Ogg decompress on any platform with 4-way SIMD (most of them).
  • Split the Miles library into two halves - digital, and MIDI/tools.
  • Removed the DOS, original Xbox, and pre-MacOS X builds.
  • Fixed a redundant allocation that saved several KB per sample when playing both Ogg Vorbis and XMA files.
  • Set correct channel mask in multichannel files recorded by the Capture filter.
  • Added AIL_inspect_Ogg and AIL_enumerate_Ogg_pages.

Changes from 7.2f to 7.2g (04-22-2009)

  • On Xbox, added support for XMA2 files (which lets you use multichannel XMA files).
  • Added SIMD optimizations for MP3 files on Xbox 360 and PS3 (Windows and PS2 already had them).
  • Fixed a few path problems with the user build scripts.

Changes from 7.2e to 7.2f (04-13-2009)

  • Added AIL_set_sample_playback_rate_factor and AIL_sample_playback_rate_factor functions.
  • Added AIL_WAV_marker_count, AIL_WAV_marker_by_index, and AIL_WAV_marker_by_name functions.
  • Added fast Ogg loading - defers Ogg parsing to the background thread which drops the hit on the primary thread when starting Oggs to basically nothing.
  • Fixed a parsing bug with some rare Ogg files.
  • Fixed the built-in low-pass filter to make it click-free (surprisingly complicated).
  • Switched to Xaudio 2 on the Xbox 360.
  • Fixed bug that could cause failures when streaming very small files.

Changes from 7.2d to 7.2e (10-30-2008)

  • Fixed several memory leaks in the new Ogg decoder - everyone should update!
  • Made AIL_decompress_ASI not take Miles mixer lock on modern platforms (prevents skipping when decoding heavy duty files while sound is playing).
  • Fixed a bug where the new Ogg decoder failed on tiny files when using AIL_decompress_ASI.
  • Fixed the source code rebuild batch files on several of the platforms.

Changes from 7.2c to 7.2d (10-22-2008)

  • This release contains many of the performance features of the upcoming MSS 8.0, so that those paths can start getting exercised.
  • Added SIMD mixers for SSE 2, MMX, Xbox 360 VMX, PS3 VMX, and PS2 VU0 - mixing up to three times faster!
  • Added a new clean-room-developed Ogg decoder, written directly from the Ogg specification - that is, we no longer use libVorbis. That means you can now use Ogg, even if you have LGPL restrictions - this is 100% RAD source code. Even better, our decoder is natively SIMD - it supports SSE, Xbox 360 VMX, PS3 VMX, PS2 VU0 and Wii packed singles - it is the fastest Ogg decoder available (almost twice as fast as libVorbis, and faster than any other SIMD implementation as well). It also uses quite a bit less runtime memory. Ogg is now our recommended compressed format (over MP3).
  • Added the new AIL_set_sample_speaker_scale_factors function that lets you modulate the final volume on a speaker by speaker basis in both 2D and 3D mode. You usually want to use AIL_set_sample_channel_levels to select which input channel goes to what speaker and use AIL_set_sample_speaker_factors to modulate the volume scaling.
  • Added the new AIL_set_sample_is_3D function to flip a sample handle into or, more commonly, back out of 3D spacializing mode.
  • Mono sounds in 2D mode on multi-channel output now play to the front left and right channels (not every channel as before).
  • On Wii, switch to our own stack buffer during callback and timer time.
  • You can now set low pass and DSP filter settings on an input channel basis (you can set different settings for the left vs. the right channel, for example. This changed a few of the filter properties, and changed the AIL_sample_stage_property and AIL_set_sample_low_pass_cut function parameters.
  • Removed the DIG_PCM_ORDER flag, since you can better control speaker placement with the AIL_set_channel_levels function.
  • Removed the final parameter from AIL_init_sample, since there is no DIG_PCM_ORDER flag.
  • Fixed several minor issues with the built-in lowpass/occlusion filter.
  • Fixed a bug that could cause a crash when using 8.1-channel and 6.1-channel output formats.
  • Fixed a bug that could cause a crash with the Delay filter under EAX/DirectSound3D.
  • MAKELOOP.EXE is now compatible with LAME 3.98. When running MAKELOOP with LAME versions prior to 3.98, the /x command-line switch must be used.

Changes from 7.2b to 7.2c (3-27-2008)

  • Added VMX optimizations to the PS3 - mixing to 5.1 or 7.1 is about three times faster.
  • Fixed bug that could cause truncation of certain Ogg Vorbis files, particularly short ones.
  • Fixed a sound skipping problem on Wii.
  • Fixed a crash bug on Wii when using mono sound output.
  • Changed the structure padding on many of the structures in Miles to work around a code generation bug with the PS3 GCC (which could cause a crash in the DLS synthesizer).

Changes from 7.2a to 7.2b (1-18-2008)

  • Fixed a bug that could cause loss of volume in one or more channels after seeking in certain streams.
  • Fixed a crash when using nonstandard DLS 1 bankfiles that had more than one articulation chunk on a melodic instrument.
  • The PS3 version is now built with system software 210.

Changes from 7.1a to 7.2a (12-20-2007)

  • Multichannel Ogg Vorbis files are now fully supported by the MSS API. They may be played with either AIL_open_stream or AIL_set_named_sample_file.
  • Multichannel (WAVEFORMATEXTENSIBLE) PCM .WAV files are now supported via AIL_set_named_sample_file.
  • The Miles Sound Player now supports multichannel .WAV and Ogg Vorbis files.
  • Added new WavMux.exe command-line utility to create multichannel .WAV files which may be played directly as static HSAMPLES or converted to multichannel Ogg Vorbis files, e.g., with the free OggDrop encoder, for either static playback or streaming.
  • Extensive simplifications made to FAQ `How do I use multi-channel sound output in Miles?` Specifically, the new MSS_SPEAKER enum type eliminates all channel-count dependencies in level-control function calls.
  • Several API functions related to per-channel level control have been changed to accommodate multichannel source support using the new MSS_SPEAKER type, and are now more programmer-friendly as well. These functions include AIL_set_sample_channel_levels, AIL_sample_channel_levels, AIL_set_speaker_reverb_levels, AIL_speaker_reverb_levels, and AIL_calculate_3D_channel_levels.
  • Added AIL_sample_channel_count function to return the channel width (1=mono, 2=stereo, >2=multichannel) of the specified HSAMPLE.
  • Added AIL_sample_output_levels function to return the final amplitude scale factor applied by the MSS mixer to any given HSAMPLE. This takes all scaling sources into account, including 3D distance and cone functions (both default and user-supplied), AIL_set_sample_channel_levels, and the various volume/pan functions.
  • AIL_init_sample's return type has been changed from void to S32. See the function description for details.
  • The AILSOUNDINFO structure now includes a 32-bit channel_mask member which can be used to specify gaps in the default (WDM-based) channel order for multichannel samples.
  • Added AIL_set_sample_buffer_count and AIL_sample_buffer_count to allow the application to determine the number of buffers used for low-level streaming. Changed AIL_sample_buffer_ready to AIL_sample_buffer_available, and modified the parameters of AIL_sample_buffer_info. If your application uses these low-level streaming functions, you should carefully review the function descriptions and the dbtest.cpp example when upgrading to this version of MSS.
  • Fixed a bug that could cause lockups when calling AIL_close_digital_driver after unplugging headphones on certain Windows systems.
  • Added WIN32_POSITION_ERR property for AIL_platform_property function to allow the application to detect removal of headphones, speakers, or other sound hardware at runtime.
  • AIL_set_sample_51_volume_pan and AIL_set_sample_51_volume_levels now establish consistent front/back and left-right levels for all output modes, not just 5.1 modes.
  • Fixed a bug that could cause audible artifacts when using software DSP filters (including the built-in LPF) with EAX/DirectSound3D providers
  • Fixed a memory leak in the Xbox 360 implementation of AIL_close_digital_driver.
  • Cleaned up some IO error handling code on the Wii.
  • Fixed a bug in the Wii init code that was causing the digital latency to be too high.
  • Removed 500 ms of silence at the front of the `coolmidi` sample MIDI file.
  • Lowered the DLS synthesizer startup latency.
  • Fixed a (typically-harmless) bug in AIL_filter_DLS_with_XMI that could truncate the output file by 8 bytes.

Changes from 7.0x to 7.1a (06-25-2007)

  • Released the final version of Miles for Nintendo Wii! We've done lots of PPC assembly optimizations to make Miles run super-fast on this great little CPU. We are really happy with the results - check it out!
  • Built the Xbox 360 version with the new June XDK. If you switch your game to the June XDK, then you must update to this version.
  • Fixed a bug on the pre-MacOS X version of Miles where streaming could skip.
  • Fixed bug that could cause a crash at shutdown time when using AIL_register_trace_callback.

Changes from 7.0w to 7.0x (06-01-2007)

  • On Windows, fixed a bug in our SSE memset where machines with SSE but without SSE 2 would crash.
  • On MacOS, fixed a problem with SSE detection - MP3 playback will now be much faster.
  • On MacOS, fixed stack alignment problem on the x86 DLL loader.
  • Cleaned up a few of the build batch files.

Changes from 7.0v to 7.0w (05-10-2007)

  • Changed the default falloff power for multichannel positioning from 1.0 to 3.0. You may wish to review the AIL_set_speaker_configuration function to understand how this change affects the behavior of the MSS 3D positioner.
  • The AIL_set_sample_channel_levels function can now be used to modify the channel levels established by the 3D positioner. In previous versions, this function had no effect on 3D-positioned HSAMPLEs and HSTREAMs.
  • It is now possible to apply 3D positioning to stereo files. 3D-positioned stereo sources will be downmixed to mono. Previous versions of MSS did not support 3D positioning of stereo sources.
  • Fixed a bug that could cause truncated playback of extremely-short XMA samples.
  • Fixed a bug that could cause XMA samples to fail to begin playing under certain conditions.
  • Fixed a bug that caused the auto_3D_wet_atten parameter for AIL_set_sample_3D_distances to be ignored for sounds beyond the maximum distance from the listener.
  • Fixed a bug on Mac that would cause a lockup, if you called AIL_shutdown twice.
  • Updated to the PS3 1.60 SDK.
  • Updated to the Xbox 360 April SDK.
  • Updated to the Visual Studio 2005 on Windows.
  • Updated to the Wii 2.4 patch 3 SDK.
  • Added internal SSE versions of memcpy, memmove and memset on Win32.

Changes from 7.0u to 7.0v (02-1-2007)

  • Fixed a bug that could cause memory corruption during DSP filtering on PS3.
  • Fixed a bug that could cause output channel levels to change during stream-seek operations.
  • The capture filter now supports Xbox and Xbox 360 in addition to Windows.
  • Xbox 360 is always opened in MSS_MC_51_DISCRETE mode regardless of the channels parameter passed to AIL_open_digital_driver.

Changes from 7.0t to 7.0u (01-10-2007)

  • Added AIL_CPU_AFFINITY preference for Xbox 360.
  • Renamed the MP3Loop.exe utility to MakeLoop.exe, and added support for ADPCM loop generation.
  • Added -r option to MakeLoop.exe.
  • Fixed a bug that could cause certain ASI codecs and filter providers to crash on CPUs without SSE support.
  • Added the AIL_platform_property function to allow applications to control Miles's thread affinity and other platform-specific behavior.

Changes from 7.0s to 7.0t (11-16-2006)

  • Added the new MP3Loop.exe command line tool. This tool will create loopable MP3 files automatically!
  • Worked around a compiler code-gen bug on the Xbox 360 in the Ogg decoder.
  • Switched to using the pthread library on mach-O MacOS.
  • Simplified the memory allocator on mach-O MacOS.
  • Made the streaming API use a background thread on MacOS when not using async file IO (which usually means mach-O).
  • Removed the dynamic MIDI playback timing adjustment code on Mac (since Macs are so much faster now-a-days).
  • Changed the PS3 thread code to allow the system to be shutdown on a thread other than the one that started it.
  • Fixed a bug in the PS3 stereo ADPCM decoder.
  • Made the MIDI to XMI convert tolerate bad MIDI files that have partial events at the end of the file.
  • Made the 5.1 volume functions work on other platforms when running in 5.1 speaker mode.
  • AIL_inspect_MP3 now reads some of the LAME specific information in an MP3 file.
  • Fixed a bug when playing very short Ogg files where the first packet would repeat.

Changes from 7.0r to 7.0s (10-04-2006)

  • Added custom_filter.cpp, a console application which demonstrates the basics of writing an MSS-compatible DSP pipeline filter.
  • Discontinued use of a compiler optimization (-Oz) which was causing crashes in Xbox 360 release-mode builds.
  • Added AIL_set_file_async_callbacks function docs for the PS2 and Mac versions, and clarified the documentation for file-callback support in general.
  • Fixed a bug in AIL_set_file_callbacks that prevented it from disabling asynchronous file operations on the PS2.
  • Updated the PS3 library and examples to the 096.002 SDK.
  • Updated to the Xbox 360 September XDK build.

Changes from 7.0q to 7.0r (9-17-2006)

  • Added an Intel Mac version of Miles. This platform has all the features of the Windows version, including identical performance. The performance is identical because rather than port all of our assembly, we instead wrote a DLL loader and load the Windows RIB DLLs on MacOS!
  • Fixed a too-conservative locking situation in the streaming API that would cause one of the disc buffers to not preload with MP3 or Ogg data. So, even if you called AIL_service_stream to fill the internal buffers, when you began playback, you could stall while a disk seek happened.
  • Tweaked the streaming API to not lock the mixer mutex while IO is running, so that if you take a large IO hit on a background stream thread, then normal in-memory and other well-cached streams won't skip.
  • Fixed a silly bug on the PS3 where a thread handle was leaked for each stream that was played.
  • Fixed a crash bug in the AIL_quick_load_mem function.
  • Split the definitions of the driver properties and sample properties. This will require a few changes on the application side if you are using DSP filters or EAX preferences. Usually, you will simply have to change enums like DP_FILTER_0 to SP_FILTER_0.
  • Removed the C runtime from most of the RIB DLLs (so they can be used on MacOS) which had the side effect of shrinking most of the binary files by 20 to 60K.
  • Removed the Ogg encode routines from the function tables which shrunk the Ogg decoder's code footprint in half.
  • Moved the multi-channel copy and the adpcm decompressor over to a separate mixer module. On Intel Mac, this module is separate (mssmixer.mix), but on all other platforms, it remains built-in to the Miles library directly. This moved a fair amount of code around.
  • Build with better switches on MacOS PPC, so fewer internal functions are exported.

Changes from 7.0p to 7.0q (8-21-2006)

  • Updated the PPC mixer assembly to not use any microcoded asm instructions.
  • Fixed a bug that could cause crashes when streaming .XMA files (Xbox360 only).
  • Fixed a bug that was causing crashes on the Xbox360 with the call-logging debug feature enabled.
  • Fixed a bug that could prevent listener-orientation changes from taking effect on non-Win32 platforms.
  • AIL_open_digital_driver now fails gracefully on generic `Surround sound speakers` Win32 configurations if MSS_MC_USE_SYSTEM_CONFIG is selected when matrix filter providers are not available.
  • NULL HPROVIDER pointers may now be passed to AIL_find_filter.
  • Added listener-orientation control to examms.exe example.
  • Fixed a bug in AIL_set_sample_low_pass_cut_off that could cause noise on samples played through drivers opened at lower sample rates.

Changes from 7.0n to 7.0p (7-20-2006)

  • On the PS3, moved the streaming I/O onto another thread, so that mixing couldn't be delayed by a slow device.
  • Fixed a mutex leak on the PS3 when calling AIL_shutdown.
  • On the PS3, moved the internal Miles data tables into the code section to avoid overflowing the game's data section (fixes `relocation truncated to fit` errors on link).
  • Fixed a bug that could cause noise/distortion in certain high-amplitude source samples at faster-than-normal playback rates.
  • AIL_open_input now allocates a chain of 8 waveIn buffers, rather than 2.
  • On Windows, made the skip detection code use timeGetTime to avoid problems on AMD dual core machines.

Changes from 7.0m to 7.0n (6-2-2006)

  • Added support for the Sony Playstation 3! All of the Miles functionality is present and works terrific!
  • Fixed a bug where the low-pass filter coefficients would be reset, even if you were selecting the same low-pass settings.
  • Fixed a bug where Voxware files could play back incorrectly when seeking to a non-frame boundary.
  • Fixed a memory leak in the chorus, delay, and flange filters.
  • Made the delay filter's buffer length shorter to save memory.
  • Fixed a problem with 8-bit multichannel output.

Changes from 7.0L to 7.0m (5-8-2006)

  • Fixed a potential deadlock issue with the EAX output filters.
  • Fixed a bug that could cause position-update failures during listener movement when multiple DirectSound3D/EAX sounds were playing.
  • Fixed bug introduced with remnant-buffer optimization that could cause clicking when resampling compressed data.
  • Made some preliminary changes and additions for upcoming Ogg Speex support.
  • Added new All-Pass Filter, intended primarily for experimental use in phase-domain effects.
  • Added AIL_register_falloff_function_callback to allow the software mixer's 3D-distance falloff calculations to be overridden.

Changes from 7.0k to 7.0L (4-21-2006)

  • Released final Miles 7.0 for MacOS! New to this platform is a Carbon Mach-O version of the library, so you can now use Miles with XCode and GCC. Support for Intel Macs coming soon.
  • Changed the mixer slightly to avoid 1-sample remnant buffers - sped up mixing of compressed formats very slightly.
  • Removed a dependency on a newer-than-necessary XMA library on the Xbox 360.

Changes from 7.0j to 7.0k (4-18-2006)

  • Released beta of Miles 7.0 for MacOS.
  • Miles Sound Player now uses our MP3 frame-inspection API instead of a hardwired parser.
  • Fixed a potential source of crashes when selecting options in the Miles Sound Player that cause an MP3 file to be reloaded.
  • Added next_frame_expected member to MP3_INFO structure used by frame-inspection API.
  • Fixed the redistribution path in the streamer and multiflt examples so that they would work on Win64 and Mac.
  • Added a delay to the console examples, so that spinning on kbhit doesn't hog the CPU
  • Fixed a few files being installed to the wrong places on Win64.
  • Fixed a bug where downsampling an MP3 file by more than 2 to 1 when not using the resample filter (which you shouldn't do anyway) could cause the playback cursor to stop advancing.

Changes from 7.0i to 7.0j (4-10-2006)

  • Added Ogg Vorbis support to the Miles Sound Studio and the Miles Sound Tools installations.
  • Made the Miles Sound Player decode the waveform data on a background thread (player plays immediately now).
  • Added a Win64 version of Miles! The entire Miles API is now available for Win64 and is completely compatible with Win32 Miles code. Thanks to AMD for their kind support of this porting effort!
  • MSS.h no longer includes any system header files (like windows.h or xtl.h).
  • Put memory fences around the interlocked functions in Miles (prevents some really obscure bugs).
  • The Miles Sound Tools includes both Win32 and native Win64 versions of the tools.

Changes from 7.0h to 7.0i (3-15-2006)

  • Added optional Ogg Vorbis support! This new ASI decoder requires signing a special separate license with RAD before you can download it. It's available for all Miles platforms and is completely integrated into Miles. It uses a bit more CPU than MP3 and doesn't quite loop as well, but is a good option when you need low bit-rates.
  • Added DTS multi-channel output on the PS/2. This is a great-sounding output layer that takes very little CPU. Perfect for supporting PS/2s that are hooked up to home theaters. You must obtain permission from DTS before you can link with this output layer. Recommended for all PS2 developers.
  • Lots and lots and lots of internal changes to support the upcoming Windows 64-bit version of Miles.
  • Merged RIB attributes and preferences into a new concept called properties. There is now just one function to both retrieve and set properties, and properties are retrieved into a memory buffer instead of on the return stack. This means if you are setting filter preferences, then you will have to make a few simple code changes. Larger changes are necessary if you are interfacing directly to RIB plugins (or you have written your own); contact us for details on this change.
  • Big changes to the EAX 4 properties. You now set a particular EAX4 effect onto a slot directly (instead of the other way around). This is more consistent with what the hardware is doing and makes for a better API. If you have a lot of EAX 4 code, contact us and we'll help you update.
  • Fixed a bug where the low-pass filter cut off was based on the hardware DMA output rate instead of the sample rate.
  • Fixed a bug where the Xbox hardware low-pass filter wasn't being applied until the sound moved.
  • Fixed some occasional clicks when restarting a sample or rapidly changing the volume of a compressed digital sample.
  • Fixed a crash in Miles Sound Player with large compressed files.
  • OUTPUT_BIT_RATE property is now reported correctly by Voxware codecs.
  • Fixed a timer wraparound bug where the CPU usage would be measured incorrectly every 70 minutes.
  • Fixed the PS/2 file handle support, so that you can just pass in a file handle instead of a RAD_IOP_ASYNC_OPEN_DATA structure.
  • Built the Xbox 360 version with the April XDK (works with XDKs back to February).
  • Added new Gain Block Filter for generalized linear gain/nonlinear distortion effects.
  • PS2 and Xenon examples now start sounds at their intended 3D positions.
  • Fixed occasional trailing glitches when playing certain streams through hardware 3D voice filters on Win32 version.
  • AIL_mem_free_lock can now be used safely from within background callbacks on the PS2. The freed memory will be released during the next foreground call to AIL_mem_alloc_lock or AIL_mem_free_lock.

Changes from 7.0g to 7.0h (12-27-2005)

  • Fixed a silly bug that caused distortion with the software low-pass filter.

Changes from 7.0f to 7.0g (12-21-2005)

  • Made a few changes to the Xbox 1 XADPCM code to prevent clicks at the end of a stream and garbage after starvation.
  • Updated the Miles for PS2 build to link with CodeWarrior.

Changes from 7.0e to 7.0f (12-14-2005)

  • Made the Windows 3D audio hardware filters respect the master digital volume level.
  • Added missing PS/2 example media files.
  • Tweaked the PS/2 example program, so that you can pass in the host paths on the command line.

Changes from 7.0d to 7.0e (12-02-2005)

  • Added XMA playback to Xbox 360.
  • Added new demo for Xbox 360.
  • Switched to dcbt instead of xdcbt on Xbox 360 - no measurable performance difference and it is safer.
  • Added new demo for Sony PS2.
  • Added a complete SPU ADPCM voice API for Sony PS2 (now you can drop Multistream completely, if you'd like).
  • Added the ability to read from and to IOP and SPU memory with RAD_IOP. You can even stream MP3s out of IOP or SPU RAM!
  • Fixed CPU load-measuring on Sony PS2.
  • Fixed a bug in the DLS compressed-instrument decompressor.
  • Added a new DLS sample file.
  • Tweaked the distance-setting code on Xbox 1 to avoid pointless asserts in the Xbox system library.
  • MulitFlt.c example now demonstrates how to close a filter/driver binding.
  • DBTest.c example updated to demonstrate low-level double-buffering of .MP3 files.
  • FileHndl.c example updated to demonstrate how to stream from an existing file handle.
  • Fixed a bug that could cause looped streams to reset themselves under certain conditions.
  • Moved internal low-pass filter to post-resampling stage, for better compatiblity with .FLT filters

Changes from 7.0c to 7.0d (9-23-2005)

  • First open beta of Miles for the Xbox 360! Only XMA playback remains to be done.
  • First open beta of Miles for the Sony PlayStation 2!
  • Fixed a bug that could cause low-level 125-Hz spurs in upsampled or downsampled sounds with the software mixer.
  • Fixed a bug that could cause a click when transitioning from unity-sampled playback rates to undersampled (pitch-up) rates.
  • Reduced zipper noise when changing parameters in certain filters (such as Parametric EQ).
  • Added `Mix` preference and attribute to all filters except Volume Ramp and Capture. This parameter ranges from 0.0 to 1.0, and determines the filter's degree of contribution to its own output signal. You can bypass a filter's effect altogether by setting its `Mix` parameter to 0.0. This will reduce the filter's CPU load significantly when the filter is not needed, while allowing its effect to be turned back on later without adding artifacts associated with filter initialization. Note that all filters with existing wet/dry mix parameters now use `Mix` instead. For instance, the phaser filter's `Phaser Mix` parameter is no longer present, having been renamed to `Mix`.
  • Fixed a bug in the Compressor filter that caused incorrect operation with stereo source samples.
  • Added AIL_register_trace_callback function.
  • Fixed an incorrect pan value in the demo.c sample.
  • Documentation updated for PlayStation 2-specific library features.
  • Made a small change to allow redistribution files to be loaded from a Unicode path on Win32. Added a FAQ to describe how to do this.

Changes from 7.0b to 7.0c (9-07-2005)

  • Fixed a bug in the DirectSound3D/EAX output filters that could cause voices of restarted samples to play at incorrect 3D positions.
  • Fixed a bug in the DirectSound3D/EAX output filters that could cause voices to stop playing under certain conditions.
  • Added CPU usage display to the examms example. This readout shows the load placed on a single CPU by the MSS background service thread.

Changes from 7.0a to 7.0b (8-02-2005)

  • New unified 3D/2D API -- no more H3DSAMPLES! EAX and DirectSound3D applications now work with HSAMPLEs, giving them access to the entire Miles digital audio API.
  • Added support for discrete multispeaker surround-sound output, including 4-channel, 5.1, 6.1, 7.1, and 8.1 formats. You can use our software multichannel provider for more voices and maximum consistency, or use EAX/DirectSound3D for hardware-accelerated effects.
  • DSP filters may now be stacked up to eight levels deep. AIL_filter_sample_attribute and AIL_set_filter_sample_preference have been deprecated in favor of AIL_sample_stage_attribute and AIL_set_sample_stage_preference, respectively. These functions take a constant from DP_FILTER_0 (formerly the only available per-sample filter slot) to DP_FILTER_7 (the last of eight available slots in the new version).
  • Added two new classes of filters. 'Matrix' filters perform postmix processing for output formats such as Dolby Surround and SRS Circle Surround. 'Voice' filters actually replace the Miles mixer itself, performing their own hardware buffer management on a per-voice basis. All of the EAX/DirectSound3D functionality previously implemented in M3D providers is now based on voice filters. Both matrix- and voice-output filters are installed automatically when AIL_open_digital_driver is called with the appropriate enum value from MSS_MC_SPEC.
  • All platforms, including Xbox and DOS, now support DSP filters.
  • New digital audio loop editor added to Miles Sound Player lets you generate seamless loops even within MP3 files!
  • Added support for SRS Circle Surround(R). This is a Dolby-compatible matrix provider that offers discrete rear-channel positioning on supported receiver hardware.
  • Removed some obsolete, unmaintained, and/or little-used 3D providers (RSX, QMixer, A3D).
  • Replaced exam3d.exe and con3d.exe example programs with more-general examms.exe example.
  • Complete rewrite of EAX/DS3D code to support unified API. Improved performance due to more-efficient buffer reuse.
  • AIL_HWND ignores WS_DISABLED windows when searching for a window associated with the current process.
  • Several issues with the DOS version were addressed (the timer interrupt stack size was bumped from 2K to 32K, the DP_DEFAULT_MERGE provider is now set correctly, sample pipeline filters are now supported, SSE support has been disabled for DOS extender compatibility, and ASIFILE works correctly with MP3 decoder)
  • Miles Fast 2D provider moved into core library. (All drivers offer 3D distance/directional attenuation now, enabled by calling AIL_set_sample_3D_position on an HSAMPLE.)
  • MP3 frame headers are now checked for consistency against the most recent valid frame, rather than the first frame in the file (which may have been corrupted or incorrectly-detected).
  • Added a frame-level MP3 disassembly utility to the Miles Sound Studio. The disassembler is accessed via the File Info button (formerly File Type).
  • Added frame-level MP3 inspection to the API via the AIL_inspect_MP3 and AIL_enumerate_MP3_frames functions.
  • ID3v2 tags in the middle of an MP3 file are now handled properly.
  • MP3 frames with insufficient data now generate silence rather than simply being skipped (improves robustness in subblock loops).
  • Accumulated MP3 output data (and its associated filter state) is no longer discarded during looping (only during normal seek operations, e.g., in response to AIL_set_sample_position).
  • Removed external reverb filters. The core library's reverb implementation offers a superset of the removed filters' functionality.
  • Removed Lagrangian resampling filter (not competitive with internal resampler).
  • Made several changes to the internal API for pipeline filter providers to support multichannel build buffers and postmix processors. Third-party FLT providers will need to be revised for use with MSS 7. Added inline helper functions to imssapi.h for ease of maintenance.
  • Always perform predelay calculations to position the reverb tail pointer correctly, even when wet level is zero.
  • Doppler calculations now use cosine scaling to discriminate against sources moving perpendicular to source-listener axis.
  • Removed EAX 1 support, due to EAX 1's lack of standardization, feature-poor control API, buggy OEM drivers, and the widespread presence of EAX 2-compatible hardware. All EAX 1 applications should migrate to EAX 2 or (preferably) discrete software-mixing configurations.
  • Fixed various bugs in the EAX providers, including an array-overflow bug in EAX 4 and incorrect 3D auto-attenuation flag control in EAX 2/3. Significant changes were made to the way occlusion, obstruction, and exclusion are applied to dry and wet levels in the various providers, with the goal of harmonizing their behavior across providers to the greatest extent possible. Some preferences such as EAX_REVERBMIX are now under API control, and were removed. This means that EAX applications optimized for use with Miles 6 may need to be re-tweaked when upgrading to Miles 7!
  • Added auto_3D_wet_atten parameter to AIL_set_sample_3D_distances.
  • For improved compatibility with certain streaming applications, AIL_load_sample_buffer no longer automatically starts playback. You must call AIL_start_sample yourself, after submitting either one or two valid buffers. (AIL_start_sample no longer restarts playback of double-buffered samples that are already playing, so there's no need to check the sample's playback status when calling AIL_start_sample after AIL_load_sample_buffer.)
  • Removed AIL_set_sample_type and moved its parameters to AIL_init_sample. It is no longer necessary to call AIL_init_sample prior to AIL_set_sample_file, AIL_set_named_sample_file, or AIL_set_sample_info.
  • Removed the AIL_allocate_file_sample and AIL_register_EOF_callback functions. Use AIL_set_sample_file or AIL_set_named_sample_file instead.
  • Removed the (previously-deprecated) AIL_waveOutOpen function. Use AIL_open_digital_driver instead.
  • Fixed a bug that could cause AIL_open_digital_driver or AIL_waveOutOpen to fail when using waveOut.
  • Fixed a bug that could cause a short glitch when restarting playback of an MP3 file.
  • We no longer allow a sample's state to reach SMP_DONE if an ASI decoder still has some data in its output buffer. This fixes a bug that could cause the last few kilobytes of output data from an MP3-based sample or stream to be lost.
  • Two Win32-specific preferences, DIG_PREFERRED_WO_DEVICE and DIG_PREFERRED_DS_DEVICE, have been added to force AIL_open_digital_driver to use a specific waveOut device ID or DirectSound LPGUID. These preferences take the place of the dwDeviceID parameter in AIL_waveOutOpen. Most applications should leave these preferences at their default values of WAVE_MAPPER and NULL, respectively.
  • Added a new preference, DIG_LEVEL_RAMP_SAMPLES, which determines the number of samples over which volume level changes will be ramped in at each software-mixing interval. With this feature, all software-mixed platforms will experience significantly less unwanted clicking and `zipper noise` during changes to volume control levels and 3D positions.
  • Fixed a bug which could introduce clicking artifacts on samples whose playback rates are swept through unity. This fix improves Doppler-effect quality significantly in some cases.
  • Renamed AIL_set_3D_room_type and AIL_3D_room_type to AIL_set_room_type and AIL_room_type, respectively. AIL_set_digital_master_room_type has been removed. The room-type functions are now available even for samples that aren't undergoing 3D positioning by MSS.
  • Likewise, AIL_set_3D_sample_occlusion, AIL_set_3D_sample_obstruction, AIL_set_3D_sample_exclusion, AIL_3D_sample_occlusion, AIL_3D_sample_obstruction, and AIL_3D_sample_exclusion have been renamed to AIL_set_sample_occlusion, AIL_set_sample_obstruction, AIL_set_sample_exclusion, AIL_sample_occlusion, AIL_sample_obstruction, and AIL_sample_exclusion.
  • Removed the concept of the 3D HPROVIDER from the API. The functions AIL_set_3D_distance_factor, AIL_set_3D_doppler_factor, AIL_set_3D_rolloff_factor, AIL_set_room_type, AIL_3D_distance_factor, AIL_3D_doppler_factor, AIL_3D_rolloff_factor, and AIL_room_type now take an HDIGDRIVER rather than an HPROVIDER. AIL_enumerate_3D_providers, AIL_enumerate_3D_provider_attributes, AIL_set_3D_provider_preference, AIL_3D_provider_attribute, AIL_find_3D_provider, AIL_open_3D_provider, and AIL_close_3D_provider have been removed.
  • Removed the AIL_set_3D_speaker_type function and the MILES_SPEAKER_TYPE definitions. Speaker types are either specified by the end user via their Windows control panel or OEM configuration applet, or are implicit in the MSS channel specification passed to AIL_open_digital_driver (e.g., MSS_MC_51_DISCRETE or MSS_MC_STEREO).
  • Removed the H3DSAMPLE type from the API. Most functions that formerly operated on H3DSAMPLEs were removed, including AIL_3D_sample_attribute, AIL_3D_sample_length, AIL_3D_sample_loop_count, AIL_3D_sample_offset, AIL_3D_sample_playback_rate, AIL_3D_sample_status, AIL_3D_sample_volume, AIL_allocate_3D_sample_handle, AIL_end_3D_sample, AIL_register_3D_EOS_callback, AIL_release_3D_sample_handle, AIL_resume_3D_sample, AIL_set_3D_sample_info, AIL_set_3D_sample_loop_block, AIL_set_3D_sample_loop_count, AIL_set_3D_sample_offset, AIL_set_3D_sample_playback_rate, AIL_set_3D_sample_preference, AIL_set_3D_sample_volume, AIL_start_3D_sample, and AIL_stop_3D_sample.
  • Removed AIL_active_3D_sample_count.
  • Removed the H3DPOBJECT type, as well as the AIL_auto_update_3D_position, AIL_open_3D_listener, AIL_close_3D_listener, AIL_open_3D_object, AIL_close_3D_object, AIL_3D_user_data, and AIL_set_3D_user_data functions. The remaining functions which took H3DPOBJECTs, including AIL_3D_orientation, AIL_3D_position, AIL_3D_velocity, AIL_set_3D_orientation, AIL_set_3D_position, AIL_update_3D_position, AIL_set_3D_velocity, and AIL_set_3D_velocity_vector have been replaced with versions specific to HSAMPLEs (AIL_sample_3D_orientation, AIL_sample_3D_position, AIL_sample_3D_velocity, AIL_set_sample_3D_orientation, AIL_set_sample_3D_position, AIL_set_sample_3D_velocity, AIL_set_sample_3D_velocity_vector) and HDIGDRIVERs (AIL_listener_3D_orientation, AIL_listener_3D_position, AIL_listener_3D_velocity, AIL_set_listener_3D_orientation, AIL_set_listener_3D_position, AIL_update_listener_3D_position, AIL_set_listener_3D_velocity, AIL_set_listener_3D_velocity_vector).
  • Renamed the remaining AIL_3D_sample...() / AIL_set_3D_sample...() functions to AIL_sample_3D...() / AIL_set_sample_3D...() to reflect the fact that 3D positioning is now just another property of an HSAMPLE, rather than a feature implemented by a separate '3D sample' type. The newly-renamed functions are AIL_set_sample_3D_distances, AIL_sample_3D_distances, AIL_set_sample_3D_cone, AIL_sample_3D_cone, AIL_set_sample_3D_position, AIL_set_sample_3D_velocity, AIL_set_sample_3D_velocity_vector, AIL_set_sample_3D_orientation, AIL_sample_3D_position, AIL_sample_3D_velocity, AIL_sample_3D_orientation, and AIL_update_sample_3D_position. Note that an HSAMPLE's 3D properties are ignored by MSS until the application requests 3D positioning support by calling AIL_set_3D_position! Once enabled for a given HSAMPLE, 3D positioning can be disabled by releasing and reallocating the HSAMPLE, or by calling AIL_init_sample, AIL_set_sample_file, AIL_set_named_sample_file, or AIL_set_sample_info.
  • Removed AIL_3D_sample_effects_level and AIL_set_3D_sample_effects_level. Reverb effects for all samples (whether or not they're 3D-positioned) are now controlled by AIL_set_sample_reverb_levels. Note that the per-sample wet mix defaults to 0.0, so at least one call to AIL_set_sample_reverb_levels is mandatory before you'll be able to hear any reverb/room effects on any given sample.
  • Added AIL_DLS_sample_handle and AIL_stream_sample_handle functions to allow access to the HSAMPLE associated internally with an HDLSDEVICE or HSTREAM. This allowed us to remove AIL_DLS_set_reverb_levels, AIL_DLS_get_reverb_levels, AIL_stream_reverb_levels, AIL_set_stream_reverb_levels, AIL_DLS_processor, AIL_set_DLS_processor, AIL_stream_processor, AIL_set_stream_processor, AIL_stream_playback_rate, AIL_set_stream_playback_rate, AIL_set_stream_low_pass_cut_off, AIL_stream_low_pass_cut_off, AIL_set_stream_volume_pan, AIL_stream_volume_pan, AIL_filter_stream_attribute, AIL_set_filter_stream_preference, AIL_filter_DLS_attribute, and AIL_set_filter_DLS_preference.
  • Added AIL_set_speaker_configuration and AIL_speaker_configuration.
  • Added AIL_set_listener_relative_receiver_array and AIL_listener_relative_receiver_array. These functions are reserved for future use, and are undocumented at present.
  • Added AIL_set_speaker_reverb_response and AIL_speaker_reverb_response.
  • Added AIL_set_sample_channel_levels and AIL_sample_channel_levels.
  • Added AIL_digital_output_filter, AIL_enumerate_output_filter_driver_attributes, AIL_output_filter_driver_attribute, AIL_set_output_filter_driver_preference, AIL_enumerate_output_filter_sample_attributes, and AIL_enumerate_sample_stage_attributes. (Note that sample-level attribute and preference values for voice output filters may be accessed by specifying DP_OUTPUT in calls to AIL_sample_stage_attribute and AIL_set_sample_stage_preference. Matrix output filters do not support per-sample attributes and preferences.)
  • AIL_open_filter now returns -1 (rather than 0) if the filter HPROVIDER was already associated with the specified HDIGDRIVER.
  • Release candidate for version 7 on Windows and Xbox.
  • Major speed optimizations over version 7.0a - 300% faster multichannel mixing, 200% faster DSP effects.
  • Xbox can play now 3D audio on a 2D digital driver by using the pan and volume spacialization code from Win32. This means you are no longer restricted to the Xbox's 64 3D audio voices.
  • Xbox can now use the Miles software DSP filters. The only restriction is that you can't apply the software DSP filters to Xbox ADPCM voices (since the hardware decompresses them).
  • Renamed the AIL_speaker_reverb_response to AIL_speaker_reverb_levels - this function now allows you to set the master volume level for both wet and dry, so you can use it to set balance levels of each speaker.
  • Replaced the mono/stereo delay filters with a single unified delay filter that can serve both purposes.

Changes from 6.6h to 7.0a (5-16-2005)

  • Beta of the new 7.0 system.

Changes from 6.6g to 6.6h (12-10-2004)

  • Fixed a small memory leak in 3D sample handle allocation when the buffer format changed (introduced in 6.6g).
  • Fixed a sound clip in the RSX provider when playing 8-bit sounds.

Changes from 6.6f to 6.6g (12-07-2004)

  • Added a new DSP filter to allow you to smoothly ramp up or down volume over time. You can ramp your volumes on a sample by sample basis over any length of time with 3 lines of code. Also added a FAQ explaining how to use this new filter.
  • Added a new utility function, AIL_find_filter, to quickly and easily locate a filter by name. This just saves you from having to do the enumeration yourself.
  • Added another utility function, AIL_find_3D_provider, to quickly and easily locate a 3D provider by name. Like AIL_find_filter, this just saves you from having to do the enumeration yourself.
  • Optimized the AIL_set_3D_sample_data functions so that a DirectSound buffer is only reallocated if the sound format has changed. This can double the speed of these common functions on most hardware.
  • If the format of a sound buffer didn't change in AIL_set_3D_sample_data, then we no longer reset the position, orientation, volume, etc. of the 3D sample. We no longer do this because you will usually immediately change these settings anyway, and it makes a big difference in setup time. If you were previously relying on the settings to be cleared, then you can clear them by hand, or you can release and then reallocate the 3D handle.
  • Fixed a bug in the DirectSound hardware 3D providers where you could allocate one more 3D sound handle than the hardware could play. No sound would ever play on this handle, so you could unknowingly have had sounds that were never being played. Due to this fix, you may want to double check your AIL_allocate_3D_sample_handle logic to make sure it can handle a null return value (which will now happen if you exceed the sound card's internal buffer limit).
  • Fixed a bug in the upsampling filter (on PC and Mac) that caused clipping. This would also affect the Miles Fast 2D providers as well.
  • Fixed a bug when using the upsampling filter on ACPCM or MP3 compressed data where one sample at the end of each decompressed buffer might be skipped (this causes a periodic clicking at very slow playback rates).
  • Clear the previous sample filter values whenever you restart a sample playback (to avoid a click from the filter if you previously stopped it in the middle of a sound).
  • We now exclude disabled top level windows in our automatic HWND detection code (DirectSound requires an HWND) - this avoids occasionally identifying hidden application message windows.

Changes from 6.6e to 6.6f (10-31-2004)

  • Tweaked the Audigy bug handling and detection again (sigh).
  • Added AIL_set_sample_info to the 2D digital sound system to be orthogonal to the 3D AIL_set_3D_sample_info function.
  • Fixed a bug where the MP3 decoder DLL could crash if it was unloaded twice (if there were two copies of the DLLs accidentally loaded).
  • We no longer reload the RIBs when you specify `.` for the redistribution path.
  • We no longer auto-register AIL_shutdown to be called in the application's atexit handler. This was convenient but caused too many wacky linker bugs. You have to do this yourself, if you want this behavior now.
  • Fixed AIL_stream_position to be much more accurate (added thread protection) and to give accurate values around loop points.
  • Fixed a bug in the streaming system where if you jumped to the end of an ADPCM sound image, then we would pad out the buffer even though we never read the unpadded final ADPCM block. This would cause looping ADPCM streams to play garbage if you seeked off the end.
  • Fixed a bug in the DirectSound code where, if you cranked up the DIG_DS_MIX_FRAGMENT_CNT preference to maximum, then you could overwrite the play cursor which would cause sound glitching.

Changes from 6.6d to 6.6e (10-23-2004)

  • Added some code to work around yet another Creative Labs driver bug. This Audigy 2 driver bug is identical to the SBLive bug from several years ago - after ten hours or so of looping, a DirectSound buffer will suddenly stop reporting buffer position changes. We now watch for any time positions stop changing for longer than 128 ms, and upon this unhappy event, we reset the buffer. This gives a little click of sound (once every ten hours), but at least the audio continues playing.
  • Changed some logic to allow streams to be closed inside an end of stream callback (which we don't really recommend anyway).

Changes from 6.6c to 6.6d (08-17-2004)

  • Set the thread stack size lower on the Xbox version.
  • Fixed a rare bug that could cause a divide overflow crash when looping an MP3 stream that ended precisely on an MP3 frame boundary.
  • Fixed a bug on the Xbox version where setting the velocity would change the position instead.
  • Limit the number of Xbox streaming buffers that are allocated to never be more than the number of HSAMPLEs that are allocated.
  • Fixed a stupid editting error that causes the ADPCM decompressor to fail on MacOS.
  • Checked for the digital driver being NULL in several of the sound functions for safety.
  • Made the EAX4 provider automatically turn on `environment mode` when selecting the room reverb filter.

Changes from 6.6b to 6.6c (05-18-2004)

  • Added all new EAX 4 support. Nice, clean, streamlined support for the otherwise complicated EAX 4 API, along with a new simple example application to show you how to use it.
  • Added some thread protection to the DX calls in the DirectSound3D based 3D providers to avoid rare crashes when making 3D sound calls from a background thread or timer.
  • Fixed a free buffer problem that eventually led to crashes when streaming files on the Xbox.

Changes from 6.6a to 6.6b (04-18-2004)

  • Fixed a SMP crashing bug on MacOS.
  • Optimized the 16-bit sample clippers on MacOS.
  • Optimized the 64-bit divider on MacOS.

Changes from 6.5h to 6.6a (03-31-2004)

  • Major optimizations on the MP3 decoder - added SSE support and did lots of memory and code generation tweaks to improve playback speed. On P4s, MP3 decompression is 1.9 times as fast. On P3s, we are 1.7 times as fast. The fastest MP3 decoder is now almost twice as fast!
  • Fixed MP3 files with ID3 tags being clipped off at the end.
  • Fixed AIL_quick_unload to avoid a crash on fast machines when closing a MIDI with DLS sample.
  • Made streaming playback begin immediately in AIL_start_stream, instead of the next time the background thread executed.
  • Fixed a bug when pausing and resuming when using the low-level stream APIs where the playback would never unpause. This could cause the high-level streaming services to stall if pausing a stream immediately after playing it on a very fast machine.
  • Tweaked thread latencies on Windows and Xbox so that DirectSound is polled less often.
  • Default memory alignment is now 32-byte boundaries for SSE.
  • Updated CPU detection to detect SSE first, then 3DNow, and then then MMX.
  • Fixed some floating point epilson checks to avoid overflows in DirectSound volume setting functions.
  • Fixed the Xbox 5.1 support, so that the right right speaker is handled correctly.
  • Fixed the Xbox version, so that it wasn't always logging debug dumps to the hard drive.
  • Fixed streaming of Xbox ADPCM files.
  • Fixed crash on Xbox when decoding multiple IMA ADPCM or MP3 files at once.
  • Turned the Xbox sample headroom values back on, so that 2D and 3D volumes are better balanced.
  • Fixed the MP3 data tables, so they weren't modified in place (so you could re-init the library without reloading the DLL).
  • Fixed a bug in the MP3 decoder where perfectly tonal sound samples could have a periodic volume drop.
  • Added a new preference `DirectSound Sample Buffer` to obtain the DirectSound handle to a H3DSAMPLE.
  • Brought the Mac version up to date with the PC and Xbox versions.

Changes from 6.5g to 6.5h (11-25-2003)

  • Fixed a problem where denormal floating pointing values were leaking into the IIR filter (which caused CPU use to be way too high on P4s when using the software EAX filter).

Changes from 6.5f to 6.5g (11-01-2003)

  • First release of Miles for Xbox! Miles for Xbox maps the entire Miles API onto the powerful Xbox hardware. Without changing your code, you'll get hardware acceleration of almost all Miles features!
  • Fixed a link setting that prevented Visual Studio 6 from linking Miles.
  • Improved the performance of the DLS synthesizer by not mixing instruments that have gone silent. This can double the performance of some DLS sequences.
  • Increased the default number of simultaneous DLS voices allowed from 32 to 64.
  • Added the RegisterRIB function to load the MP3 and Voxware codecs in the static library versions of Miles (Xbox and DOS).

Changes from 6.5e to 6.5f (10-09-2003)

  • Added `EAX property set` and `EAX sample property set` attributes to the EAX providers, so that you can hook to EAX directly if necessary.
  • Toggle EAX `auto` mode when using -1 for the mix level on EAX 2 and 3 - this lets EAX 1 be more closely emulated.
  • Made the effects level only control the wet level on EAX 1 which makes it more consistent with software and EAX 2+.
  • Fixed crash when calling AIL_process_digital_audio if audio was already playing.
  • Force compatibility to DirectSound 3 in the 2D system (so we work on NT4 again).
  • Fixed a crash when initializing waveOut mode on NT4.
  • Fixed a multithreaded deadlock on MacOS X.

Changes from 6.5d to 6.5e (03-17-2003)

  • Worked around a multi-threaded bug in the system function, timeGetTime, that would cause Miles to use too much CPU.

Changes from 6.5c to 6.5d (02-12-2003)

  • Worked around a bug in the SBLive drivers where positions were moving backwards (which caused periodic sound drop outs).
  • Changed channel locking logic so that you can redundantly lock a channel in a MIDI stream.
  • DLS banks other than 0 are now handled properly.
  • Fixed a bug in the channel-lock controller (114) code that could cause lock failure in some sequences.
  • All MIDI channels from 1-16 are now available for dynamic assignment by controller 114 and AIL_lock_channel. This change allows more complex sequences to be overlaid, but eliminates support for channel-locking on non-General MIDI synthesizer platforms.
  • Fixed some crashes when playing bad MP3 data (more bulletproofing of the decoder).
  • Change the DirectSound 3D providers not to reset the speaker type to stereo on startup.
  • Switched to Perforce for source code control.
  • Switched to building with MSVC 7 on Windows.
  • Integrated the Linux changes into the main Miles tree (official release soon).
  • Switched to building internally with our internal make utilities. We now generate complete batch files to build Miles with no fuss.

Changes from 6.5b to 6.5c (07-19-2002)

  • Fixed a bug in the Miles Fast 2D and the Dolby Surround providers where the playback rate wasn't being set correctly.
  • First version of 6.5 for the Macintosh!
  • Fixed a crash in the digital input API when running on MacOS X.
  • On the Mac, fixed a crash when the Miles library was placed in a folder more than 127 characters long (now limited to 255 and doesn't crash in any case).
  • On the Mac, fixed a bug where 3D samples could get stuck playing with the SMP_PLAYING flag always on.
  • Switched to using critical sections on MacOS X. Fixes lots of deadlock conditions that could occur on multi-CPU machines. Uses the timer system from Bink.
  • Fixed a bug in the resamplers on the Mac where stereo files could sometimes bleed a bit from the right channel into the left.
  • Now use UpTime in Carbon instead of Microseconds (faster on MacOS 9).
  • On the Mac, made AIL_mem_use_malloc and AIL_mem_use_free exported functions.
  • On the Mac, better quality resampling of ADPCM and MP3 streams.
  • Now use a 20 ms mix ahead on the Mac for less CPU use.
  • On the Mac, use more descriptive names for all of the Miles redistributable files.

Changes from 6.5a to 6.5b (07-07-2002)

  • Fixed a bug in the Miles Fast 2D and the Dolby Surround providers where the same H3DSAMPLE was always returned from AIL_allocate_3D_sample_handle.
  • Fixed a bug in AIL_stream_volume_pan where the volume levels where being incorrectly returned.
  • Fixed a bug where the debug log could sometimes get truncated.

Changes from 6.1c to 6.5a (05-30-2002)

  • Moved the software EAX reverb engine directly into the Miles mixer and massively optimized it. You can now add global reverb for essentially no CPU hit at all (0.25% - one forth of one percent) per sample! Since it is built into the mixer, you can add software EAX reverb on digital streams or the DLS songs as well.
  • Moved the low-pass filter into the Miles mixer and did massive optimizations. You can now use low-pass filtering for about 0.33% (one third of one percent) per sample.
  • Merged the digital volume and pan functions and made them accept float values that are linear in loudness (not amplitude). That means that 0.5 is 10 dB down (vs. 6 dB in a linear amplitude system). The pan is now a power pan compatible with DLS - the left and right levels are adjusted to give a balanced total volume as the panned sample moves from one speaker to the other.
  • Added direct volume level functions that accept a specific float level for the left and right speakers from 0.0 to 1.0. These direct volume functions are linear in amplitude space (0.5 is 6 dB down).
  • Added a new Creative EAX 3 provider (Thanks Carlo).
  • Added support for exclusion (a new EAX 3 setting) control in all of the providers (emulated where necessary) and at the API level.
  • Added a new Dolby Surround DSP filter. You can now set the front to back pan level on Dolby Surround speaker systems on samples, streams or DLS songs.
  • Added new 5.1 and 7.1 speaker system flags. Fixed the default mode of the DirectSound3D providers always using 2-speakers.
  • Don't perform mixing at all on samples whose volumes are zero - speeds up the 3D providers when the 3D sample is beyond the maximum distance.
  • Mix twice as far on emulated DirectSound drivers to smooth skipping problems.
  • When automatically choosing between DirectSound and waveOut, if emulated DirectSound works, but waveOut doesn't work, then flip back to emulated DirectSound even though it may skip.
  • Added a time-out in the waveOut support so buggy drivers don't lock up Miles.
  • Merged all of the digital filters into one DLL instead of 18 (smaller and faster to load - not to mention 17 fewer files in the redistribution directory).
  • Merged all of the EAX 3D providers into one DLL, all of the A3D providers into one DLL, all of the DirectSound3D providers into one DLL, all of the DirectX 7 3D providers into one DLL and all of the Miles software providers into one DLL (again this is smaller and faster to load).
  • Fixed a bug in the DLS synthesizer where songs could overrun after a certain length of time (leading to small pops).
  • Fixed a bug in the DLS synthesizer where notes played exactly on frequency could be dropped.
  • Switched to using a new voice re-allocation strategy in the DLS synthesizer when running out of voices.
  • Changed the envelope shaping in the DLS synthesizer to be linear in amplitude space (vs. the seemingly more correct linear in dB).
  • Upped the simultaneously voices in the DLS synthesizer from 24 to 32.
  • Fixed a small memory leak in the 3D system when a provider fails to open another 3D sample (Thanks Jeff).
  • Fixed a bug where using the non-async file reading callbacks where they could be called at interrupt time on MacOS and DOS (leading to a crash) (Thanks John).
  • Fixed a bug where requesting the length of a quick audio handle could cause the next audio handle to prematurely end.
  • Fixed a steathly bug where playing a non-MP3 stream directly after an MP3 stream at exactly the right moment could cause a crash (Thanks James).
  • Fixed a goofy bug in the ASIFile example where the files were being converted only 4 bytes at a time.
  • Dropped Win32s support (Win32 on Win16).
  • Switched to not calling GlobalLock on Win32 to support some memory debugging systems.
  • Added the `Mute at max` preference to the Miles software 3D providers and the DirectSound 3D based providers. This allows you to control whether sounds are muted at the maximum distance (the default) or just stop fading out at the maximum distance.

Changes from 6.1b to 6.1c (10-15-2001)

  • Added the new 3D functions: AIL_set_3D_rolloff_factor, AIL_set_3D_doppler_factor, and AIL_set_3D_distance_factor.
  • Fixed a bug in the DLS synth where MIDI notes could sometimes get shut off when a song looped.
  • Added support for MP3 files with ID3 v2 headers. ID3 v2 headers can be up to 64K, so you will usually want to avoid them for space considerations.
  • Fixed a subtle bug in the PC downsampling mixers, where the audio could be quite noisy and crackly when downsampling by very small factors.
  • Made optimizations to the PC ADPCM and 8-bit sound mixers.
  • Added a workaround in the PC Miles timer code for buggy motherboards that advance the QueryPerformanceCounter incorrectly under heavy loads. Also added a check to prevent the timer from ever running backwards.
  • Fixed a bug in PC Miles where you couldn't restart Miles with the quick API.
  • Fixed a bug where AIL_quick_ms_length wouldn't return the correct length unless the sound was playing.
  • Added a few changes to the RIB subsystem so that RIBs are reference counted.
  • Used the special exception code on NT to label the Miles background threads (easier to see what threads belong to Miles).
  • Fixed a bug in the PC timer code where if you released a timer inside a timer callback, the callback might be called again.
  • Fixed a bug when playing waveOut audio on NT4 with an SBLive where the sound would skip and stutter.
  • Fixed a bug when playing waveOut audio and you released and then reacquired the digital sound handle.
  • Added support for overriding the Miles memory allocation routines under Win32.
  • Fixed a bug where the Miles Sound Studio would crash on a MIDI or DLS Dump.
  • Fixed a crash bug in the RSX provider when shutting down while running on waveOut drivers.

Changes from 6.1a to 6.1b (09-06-2001)

  • Mac MP3 decoder has been completely rewritten in PPC assembly. It is 20% faster than the old decoder.
  • Switched to a shorter mix-ahead for lower latency on the Mac.
  • Fixed a crash when streaming very short MP3 files on the Mac.
  • Fixed a rare crash when streaming files on the Mac.
  • Fixed a crash in the MIDI to XMIDI converter on the Mac.

Changes from 6.0m to 6.1a (03-06-2001)

  • First official MacOS version! PC and Mac versions fully synched.
  • All new sound mixers - in some cases up to 3 times faster! Also includes much higher quality resamplers (fully linearly interpolated vs. approximate).
  • Fixed crash when running under waveOut.
  • More tolerant of bad MP3 data (keep playing whenever possible and fewer potential crashes).
  • Fixed a bug in the Miles Fast 2D and Dolby Surround providers where some samples beyond the maximum distance never finish playing.
  • Added the AIL_set_async_file_callbacks function. This allows you to replace the file IO functions used by the streaming API using asynchronous IO (usually only used on MacOS or Win NT).
  • Plain MP3 files inside of a packed file can now be opened by the streaming API without having to wrap a wave header around the data. To do this, pass in the file handle as you would normally do only now add a comma, followed by the length of the MP3 data. For example, if you wanted to stream out of file handle 5, for 32768 bytes, use `\\\\5,32768`.
  • Fixed a bug in the voice chat client example where the application could crash on opening.
  • Fixed a bug in the exporting of the AIL_update_3D_position and AIL_auto_update_3D_position functions.
  • Miles no longer includes pre-built 16-bit Windows DLLs - they must be built on the developer's machine (mainly because the 16-bit Microsoft C compiler doesn't work on my Win2K machine any longer).

Changes from 6.0k to 6.0m (11-12-2000)

  • All new documentation - includes online and offline versions!
  • Most examples have been rewritten to make them easier to understand.
  • Added the AIL_open_digital_driver/AIL_close_digital_driver and AIL_open_XMIDI_driver/AIL_close_XMIDI_driver functions. These functions work on all Miles platforms and should now be used instead of AIL_waveOut* and AIL_midiOut* which were Windows-only and are now deprecated.
  • Miles now allows all ASI formats to wrapped in a wave file. Each ASI exports a wave format tag that tells Miles what ASI decoder to use.
  • Renamed the AIL_DLL_verion function to AIL_MSS_version.

Changes from 6.0J to 6.0k (10-22-2000)

  • MP3 streams no longer cause audio artifacts at the wrapping of a sub-block.
  • The current playback position in an MP3 stream is now correctly reported after a sub-block loop seek.
  • Made the MP3 decoder more tolerant of bad MP3 streams.
  • Renamed the AIL_input_info function to AIL_get_input_info.

Changes from 6.0i to 6.0J (10-04-2000)

  • Added the AIL_set_file_callbacks function. This allows you to replace the file IO functions used by the streaming API and AIL_file_read.
  • Added the AIL_set_stream_processor and AIL_set_DLS_processor filter installation functions.
  • Fixed a couple stream API deadlock/crash possibilities (when running in a multithreaded game).
  • Fixed an atexit link warning when building with the non-static C runtime or a non-Microsoft C compiler.
  • Fixed a tricky DLS timer aliasing bug when running under Win2K.
  • Changed the size parameters to AIL_extract_DLS to be U32s instead of S32s.

Changes from 6.0h to 6.0i (08-17-2000)

  • Made MSS const-clean! Most source files changed to handle the new const action.
  • Fixed a shutdown crash when starting up and shutting down the system multiple times while streams are playing.
  • Fixed a crash in the mono delay, stereo delay and reverb 1 filters where memory was freed out of order.
  • Fixed a granularity problem when seeking with milliseconds in an uncompressed sound stream.
  • Fixed the sub-block looping on streams to allow -1 for the end of the stream.
  • Limited waveOut latency to more reasonable maximum values - should have much lower latency on NT 4 with newer sound cards.
  • Renamed the internal STREAM_TYPE structure to avoid collisions in the MMSYSTEM.H Windows header file.
  • Added the new function RIB_find_files_provider which allows you to search for multiple file formats at once (when you need a specific input and output format, for example).

Changes from 6.0g to 6.0h (06-08-2000)

  • Improved the streaming playback performance when multiple streams are playing at once or when playing a stream that comes close to fully exhausting the IO bandwidth of the streaming device.
  • Force call to AIL_shutdown from an atexit handler to insure Miles is always closed.
  • Lock far fewer Miles functions for better performance on multiple CPU machines.
  • Fixed a crash problem in the console applications if you hit Control-Break to exit.
  • Internally meter AIL_serve checks so that the buffer status is only checked every 10 ms.

Changes from 6.0f to 6.0g (06-01-2000)

  • Tweaked all of the software EAX settings to much closer match hardware EAX.
  • Fixed setting the playback position on very short streams.
  • Fixed a crash in AIL_set_DirectSound_HWND if a hardware 3D provider is installed.
  • Fixed a crash when closing the input API under Windows 2000.
  • If no default HWND is found, MSS now uses the current foreground window with DirectSound (which fixes some problems in NT console windows).

Changes from 6.0e to 6.0f (04-24-2000)

  • Removed the Sleep in AIL_serve which could cause Smacker to skip on Windows 2000 when running in waveOut mode.

Changes from 6.0d to 6.0e (04-20-2000)

  • Changed AIL_stream_close to not shutdown the background thread (which, under Windows 98 in the debugger, takes so long that the sound can skip). The stream servicing thread is now closed at shutdown time.
  • Re-validate the HWND when re-opening a digital device (to work around a bug in the SBLive drivers which crashed on an invalid HWND).

Changes from 6.0c to 6.0d (03-21-2000)

  • Fixed a really-well hidden bug that could cause the MP3 *encoder* to lock up when the FPU state was set to a non-default mode.
  • Fixed a deadlock that could occur when closing a stream on a multiple CPU machine.
  • Fixed the background of some of the controls in the sample apps under Win2K.
  • Fixed a crash in the RSX provider when setting the velocity before setting the sample's audio data.

Changes from 6.0b to 6.0c (02-21-2000)

  • Fixed a deadlock that could occur when closing a stream.
  • Made looping MP3 streams loop a little cleaner.
  • Fixed a deadlock that could occur when starting a 3D sample from the background timer thread.
  • Added AIL_close_input call to voice chat client example program.
  • Fixed an obscure bug in the RIB provider enumeration functions.
  • Fixed a problem when setting the orientation of a H3DSAMPLE before calling AIL_set_3D_sample_file.

Changes from 6.0a to 6.0b (01-15-2000)

  • Made the Exam3D example always reset the effects level to 1.0F after a switch. Fixes not being able to hear reverb on some EAX drivers.
  • Changed the Miles voice chat examples to use a less commonly used port number to lessen the chance of possible conflicts.
  • Fixed the Miles Sound Studio occasionally using the voice chat encoder instead of the MP3 encoder.
  • Switched to a new threading model that should be more robust with poor sound card drivers and other libraries that use DirectSound concurrently with Miles (you shouldn't have to call AIL_lock anymore). The new threading model can be turned on and off with the new AIL_MUTEX_PROTECTION preference (default is on).
  • Fixed a few harmless BoundChecker warnings.
  • Should be fewer skips in the 2D system when switching 3D providers (this is probably as good as we can make this with the Windows 9x's crummy thread scheduler).
  • Switched the filters to be compiled with the VC 6 switch `/QIfist` to allow fast floating point to integer conversion, while still giving the compiler good scheduling opportunities.
  • Updated the Lagrangian Interpolating filter to the correct source file.
  • Added the new AIL_register_3D_EOS_callback function that allows you to set an end-of-sample callback for 3D samples (added on all 3D providers).
  • Switched to using the SetEQ function to model occlusions with a hardware low-pass filter on A3D 2 cards (sounds as good as EAX).
  • Somewhat simplified the threading model in the A3D 2 and QSound providers (should be a little quicker when starting or stopping sounds).
  • Simplified the threading model in the RSX provider drastically (should respond more quickly).
  • Fixed a crash if you changed an A3D 2, EAX 2, or Miles fast 2D settings before calling AIL_set_3D_sample_file.
  • Fixed a problem with the Fast 2D provider where the low-pass filter could be dropped when replaying the same sound.
  • Automatically invert minimum and maximum distances if they are passed in backwards.
  • Fixed the 2D streaming system to handle corrupt or unsupported MP3 files without crashing.
  • Fixed the 2D streaming system to automatically close all playing streams when calling AIL_waveOutClose or AIL_shutdown (avoids a shutdown crashes).
  • Fixed a nasty crash bug when re-using 2D samples or 3D samples in the Fast 2D provider where an applied DSP filter could go uninitialized.

Changes from 5.0r to 6.0a (10-18-2000)

  • Switched to a new directory structure to better handle the upcoming multi- platform support (see ReadMe.Txt for details).
  • Added new voice chat codecs and an new client-server system to show it off (MSSChat.EXE). Since Miles doesn't supply a network layer, our example uses TCP for its transport. Games should add the voice packets into their existing network layers for best results.
  • Added a new input API for recording digital audio.
  • Added new set of 18 DSP-style digital audio filters. Low-pass, high-pass, equalizers, reverb, EAX emulation with occlusion and more!
  • Changed the AIL_set_3D_sample_distances function to only take one set of minimum and maximum parameters (none of the providers except RSX supported different front and back distances). You'll have to make a change to your code to handle for this change.
  • Added new 3D functions to set the room type, speaker type, sample effects level, sample obstruction, sample occlusion, and conical emission for samples (see the new Exam3D.exe for examples of all of these functions).
  • Added three new DirectSound 7 only 3D providers - full HRTF, light HRTF, and pan and volume only. You must have DX7 installed to use these providers.
  • Added a new EAX2 provider with hardware support for occlusions and obstructions. All of the advanced settings are available as provider and sample level attributes and preferences.
  • The Miles Fast 2D and Dolby providers now offer software emulation of the EAX room styles. These providers also use a low-pass filter to support occlusions. Use this functionality with care - each voice with EAX effects costs 7% of the CPU on a P5/200.
  • Added a new function to set the directory that contains all of the Miles redistributable files (ASIs, M3Ds, FLTs, etc). Just call AIL_set_redist_directory *before* AIL_startup to tell Miles where to find its files.
  • Upgraded all of the existing 3D providers to support occlusions and obstructions by simulating them by adjusting the sample volume.
  • Added a new A3D2 provider - you can request the A3D2 interface and download geometry or use our new EAX reverb emulation (we create geometry on the fly that matches the EAX room styles as closely as possible).
  • Added a new QMixer provider (which cannot be redistributed without a license from QSound - give Mitch a call for details). This provider creates a nice, sweet 3D sound - definitely worth checking out.
  • Added sub-block looping of streamed files.
  • Added normal doppler effects to RSX (not based on changing positions, but rather by the 3D velocity function).
  • Removed support for the Microsoft mixer in our DirectSound support (since there wasn't any reason to use theirs any more). This means that the DIG_USE_MSS_MIXER preference is gone now.
  • Made the DOS examples compile under Win32 or DOS - now stored in a CONSOLE directory.
  • Made the Miles Sound Studio resizable under Win 98 and Win NT.
  • Fixed burst of static when running under DX7 with the debug libraries.
  • Pre-normalize the 3D orientation before passing it into M3D providers.
  • Fixed tons of other small bugs.

Changes from 5.0q to 5.0r (09-22-1999)

  • Fixed a rare deadlock crash when using multiple DirectSound buffers (like when using Smacker and Miles together or when using the 3D DirectSound hardware provider with 2D sounds).
  • Fixed a memory fragmentation problem under DOS.
  • Allow more 3D voices on Aureal cards.

Changes from 5.0p to 5.0q (09-06-1999)

  • Improved DirectSound buffering to help skipping under heavy loads and crummy DirectSound drivers. Added a new preference that allows you to control how far in advance to mix ahead. Use DIG_DS_MIX_FRAGMENT_CNT to control how many fragments to mix ahead (defaults to eight 8 ms fragments).
  • Improved the panning routines in the Fast 2D 3D provider - should pan from side to side much more smoothly now.
  • Fixed a rare waveOut deadlock problem.
  • Worked around some A3D stability problems.
  • Added a new function to determine the slowest timer response since Miles was started. Just call AIL_get_timer_highest_delay to get the worst time (0 means the system is running perfectly). The mixing system will start to skip when this number exceeds 64 ms. If this happens in your application, you can use the new preference DIG_DS_MIX_FRAGMENT_CNT to increase the mix ahead time (at the expense of latency).
  • Fixed the EAX constant for flipping back to automatic sample reverb control.
  • Fixed MMX support (goofy bug).
  • Fixed callback on preloaded HSTREAMs.
  • Changed the type of H3DSAMPLEs to be not defined to an (void*) pointer to enable better compile time type checking.
  • Fixed a bug when a NULL was passed to the red book routines.
  • Cleaned up the Delphi interface files somewhat.
  • Fixed AIL_allocate_file_sample to accept an MP3 file.
  • Made all of the ADPCM routines fail on non-4 bit IMA ADPCM compressed data.
  • Fixed the floating point status not being saved in a DOS timer callback.
  • Made the RSX provider consider only the minimum distance (not scaled by the maximum) for volume attenuation.
  • Turned on doppler pitch shifting under RSX.
  • Fixed a bug in the XMIDI sequencer where channel mutes weren't being handled properly with callback prefix functions (whew).

Changes from 5.0n to 5.0p (04-25-1999)

  • Made the MP3 parser more tolerant of files with bogus pre-header data.
  • Added compatibility with variable bit-rate MP3 files to the MP3 decoder.

Changes from 5.0m to 5.0n (04-20-1999)

  • Fixed the RSX provider dropping voices when playing multiple samples through a H3DSAMPLE in close succession.

Changes from 5.0k to 5.0m (04-09-1999)

  • Added a new optimized assembly MP3 math module for Intel and AMD 3DNow - up to 10% better on Intel, 54% better on AMD! Miles is now by far the fastest MP3 decoder on AMD machines.
  • Fixed a granularity problem when seeking in a non-compressed stream using AIL_set_stream_ms_position.
  • Fixed a crash if you called AIL_shutdown when 3D samples were still playing.
  • Fixed an RSX startup crash when running under the MSVC debugger under NT.
  • Allocated service threads for 3D samples at sample-allocation time vs. provider-open time.

Changes from 5.0i to 5.0k (03-31-1994)

  • Made the `Maximum supported samples` provider attribute also a *preference* in the Fast2D, Dolby Surround, and RSX providers. This means you can set the number of available 3D samples in these three providers by calling the AIL_set_3D_provider_preference function *before* you call the AIL_open_provider function. For the Fast2D and Dolby provider, you need to also insure that their are enough 2D HSAMPLEs available for the number of 3D H3DSAMPLEs that you request (use the DIG_MIXER_CHANNELS Miles preference to set the number of 2D HSAMPLEs).
  • Made AIL_set_3D_sample_distances and AIL_3D_sample_distances take F32-typed parameters rather than U32.

Changes from 5.0h to 5.0i (03-06-1999)

  • Fixed a bug in the DLS software synth that would crash if you looped a single MIDI file for more than 71 minutes.

Changes from 5.0g to 5.0h (02-25-1999)

  • Fixed a crash bug when closing the RSX 3D audio provider if legacy RSX had never been previously installed.
  • Fixed a new parameter names to avoid collisions with the STL.

Changes from 5.0f to 5.0g (02-15-1999)

  • Changed the calling convention of the RIB-based providers slightly (M3Ds, ASIs, and FLTs). Make sure you update *all* of your MSS files - not just MSS32.DLL!
  • Added the new Dolby Surround M3D provider. This is a Dolby-certified run-time 3D positioner. It allows multi-speaker systems like those from Cambridge Soundworks, Boston Acoustics, and Altec Lansing to play sounds audio from the rear speakers - `true` 3D sound positioning.
  • Added a new filter called `CAPTURE.FLT`. This filter writes all Miles digital audio output to a specified wave file. This lets you create complete sound tracks for your running applications! You simply set the filename and then load the filter to begin recording your application's output.
  • Further support has been added to the standard HSAMPLE-based API for installable digital audio processor modules, or `filters.` Filters allow the manipulation of sample data in real time, just before it is mixed into the driver's output buffer. Several new API functions have been added to make it easy for applications to select, install, configure, and use filters.
  • The use of these new functions is demonstrated in the FILTER.CPP console application in the FLT directory, along with a simple example filter provider which emulates MSS's reverb support in an externally-installable module.
  • To associate a filter provider with a given HSAMPLE, simply call the existing AIL_set_sample_processor function with DP_FILTER as the SAMPLESTAGE parameter. It is not necessary to explicitly open the filter with AIL_open_filter first; however, be advised that some filters may need to allocate large amounts of memory or perform CPU-intensive setup processing when first opened. Calling AIL_open_filter at application startup time may help avoid perceptible delays when a given filter is associated with an HSAMPLE for the first time.
  • Open filters are cleaned up automatically at driver shutdown time. Even if AIL_open_filter is called explicitly by the application, it is not necessary to call AIL_close_filter unless the application needs to free up resources consumed by a filter which it no longer intends to use. Keep in mind that each installed filter may add a small amount of CPU-usage overhead to the MSS digital audio pipeline, even if no HSAMPLEs are using the filter.
  • Filter support is available only in the Win32 MSS API, and only if the DIG_USE_WAVEOUT or DIG_USE_MSS_MIXER preferences are enabled.
  • Added the DIG_F_USING_ASI flag in AIL_stream_info flags return parameter.
  • Increased the number of voices available with RSX to 16.

Changes from 5.0e to 5.0f (01-31-1999)

  • Added the new integrated RSX provider (RAD acquired RSX in January 1999). You can now use the RSX provider without installing RSX first! There were many improvements made to improve quality and compatibility. Be sure to try this new provider - it is now one of the best 3D options!
  • Fixed a bug in the Fast 2D M3D provider where the default volume level could be set incorrectly.
  • Dropped the volume by 3 db when the sound is behind you in the Fast 2D M3D provider.
  • Improved the speed of stopping 3D samples in the DirectSound3D derived 3D providers.

Changes from 5.0d to 5.0e (01-01-1999)

  • Fixed a bug when opening a normal wave file with the streaming API (introduced by the support for wave-wrapped MP3 files).

Changes from 5.0c to 5.0d (12-20-1998)

  • Add a 3D provider that uses the Miles 2D interface (pitch/pan/volume) for extremely fast simulated 3D audio.
  • Fixed a lock-up bug in the MP3 parser where certain non-MP3 data blocks could cause a crash.
  • Reduced the speaker static when loading and unloading 3D providers.
  • Added support for wave wrapped MP3 files in the high-level API (both file name and file handle based).
  • Fixed a bug where the end of 3D digital sample could be clipped off.
  • Fixed a bug when selecting a non-A3D provider after the A3D provider.
  • Forced RSX not to use MMX (which was the cause of the awful clipping noise).

Changes from 5.0b to 5.0c (11-15-1998)

  • Added software reverb to the digital API. You can now set reverb parameters on any sample, stream, quick handle, or soft-synth MIDI sequence. The new functions allow you to set the reverb level (amount of reverb), reverb decay time, and reverb reflection time. See the Miles Sound Player for an example of the reverb parameters.
  • Fixed a few problems in the Delphi interface.
  • Added SBLive info in the driver list (uses the SB16 driver).
  • Fixed a bug in the file-based MP3 decompressor where the channels and bits were inverted in the output wave header.
  • Added hardware DLS support for the Aureal Vortex chipset (both Vortex 1 and Vortex 2). Also added hardware DLS selections to the Miles Sound Player.
  • Fixed some thread synchronization problems in the 3D providers.
  • Added a DOS without MPEG library.

Changes from 5.0a to 5.0b (10-19-1998)

  • This is a maintenance release. The .M3D 3D hardware providers have changed, so be sure to update any copies you currently keep in your application directory.
  • Added AIL_set_3D_sample_info, to allow direct specification of a block of raw sample data via an AILSOUNDINFO structure.
  • Added AIL_set_3D_sample_playback_rate and AIL_3D_sample_playback_rate functions to allow on-the-fly control of a 3D sample's playback rate.
  • Added three functions for per-sample attribute control in the 3D sound API. AIL_enumerate_sample_attributes, AIL_3D_sample_attribute, and AIL_set_3D_sample_preference allow per-sample attributes to be listed, read, and written, respectively.
  • Some 3D providers (notably Creative EAX at this time) allow control of parameters such as effect intensity on a per-voice basis. On the Creative EAX provider (MSSEAX.M3D), the new per-sample attribute functions will expose `EAX sample reverb mix`, which can be read with the AIL_3D_sample_attribute function or written with the AIL_set_3D_sample_preference function.
  • Most applications should not need to set the `EAX sample reverb mix` preference. If an EAX application creates a sample and does not set this property, EAX automatically calculates the reverb mix for the sound source based on its volume and distance. If an application does want to override EAX's control of this attribute, its value may be varied over the range of 0.0 (no reverb at all added to the source) to 1.0 (the maximum amount of reverb added to the source). If you want to put the reverb mix attribute back under the control of EAX, you can set the value using the constant EAX_REVERBMIX_USEDISTANCE, defined in EAX.H as -1.0F.
  • Fixed a bug which could potentially cause deadlocks when setting or retrieving EAX environment properties.
  • Fixed a truncation problem in the AIL_find_DLS function.
  • Fixed a bug in the end of stream callback.
  • Updated the Delphi interface files to 5.0.

Changes from 4.0g to 5.0a (10-04-1998)

  • Major new version - almost everything changed somewhat. Highlights:
  • All new digital mixer (actually the digital mixer from our DLS synthesizer) - it is much faster, has MMX support, supports on-the-fly filtering, and can call pre- and post- mix sound processors.
  • MSS now uses the new Miles mixer even when running under DirectSound - if you start and stop many sound samples, then this can increase your performance dramatically.
  • New API for adding runtime bound APIs to MSS (called RIB).
  • New API for adding audio codecs to MSS called `ASI` (which is built with RIB).
  • New API for adding 3D audio providers to MSS called `M3D` (which is also built on RIB).
  • New MPEG Layer-3 ASI-based decoder (note that you must sign a license addendum to obtain the decoder). MP3 is integrated completely into MSS - you don't even have to decompress the MP3 data first (although you can for performance reasons). MSS does NOT support MPEG Layer 1 or MPEG Layer 2 files, btw.
  • New high-level 3D API - with the MSS 3D API, you can support any of the Miles M3D audio providers (DirectSound software, DirectSound hardware, Aureal's A3D, Creative's EAX, and Intel's RSX - more coming soon). Note that Intel is currently working on several bugs in RSX, so the RSX provider is noisier than it will be.
  • New API for high-level access to the Miles mixer. This means you can do format conversions and pre-mixing in your application (without actually playing the sound).
  • New functions for compressing and decompressing with an ASI codec. Note that Miles does NOT supply a redistributable MPEG Layer 3 *encoder*. You can purchase a encoder for use with the Miles Sound Studio for $95, but it is still not redistributable.
  • The DLS synthesizer is now capable of using MP3 compression for the instrument data. This makes MSS MIDI files even smaller! You must purchase the Miles MPEG Layer 3 encoder to create these files, however.
  • Added a callback to most of the File Format services functions that is called periodically during lengthy operations (for status displays).
  • New function to write out a wave file from just a memory pointer and format description.
  • Improved autodetection of application master HWND.
  • New function to retrieve the HWND that the MSS system is using (for DirectSound and 3D library support).
  • Fixed the default pan setting for drum voices in the DLS synthesizer.
  • Stream callbacks are now made when the sound completes (rather than when all of the audio has been read from the file).

Changes from 4.0f to 4.0g (06-11-1998)

  • Fixed a bug when looping ADPCM sound streams.
  • Fixed some Win32s problems.
  • Fixed a bug where end of stream callbacks would only be made once.

Changes from 4.0e to 4.0f (06-03-1998)

  • Fixed use of greater than 1MB DLS files under Windows 3.x.

Changes from 4.0d to 4.0e (05-10-1998)

  • Fixed an obscure buffer boundary bug in the ADPCM decompressor.

Changes from 4.0c to 4.0d (03-30-1998)

  • First release of the DOS version of MSS 4.
  • Fixed the stream millisecond positioning functions.
  • Merged a lot of the Windows and DOS source code.
  • Shipped the newest S3BASE.DLL in the WinTools directory (adds from memory loading for SonicVibes cards).
  • New DOS driver for the ESS AudioDrive (runs better under a Win95 DOS box).
  • Added DOS driver for the Maxi Sound 64 sound card.
  • Updated Delphi interface files to version 4.0.
  • Fixed a bug in the DLS synthesizer with some of the weirder DLS instruments.

Changes from 4.0b to 4.0c (03-20-1998)

  • Doubled the speed of ADPCM decompression.
  • Fixed ADPCM mono samples playing without volume control.
  • First release of the Win16 version of MSS 4.
  • Dumped the use of the Shrinker DLL compressor - all kinds of loading problems.
  • Fixed a few compiler warnings in MSS.H.

Changes from 4.0a to 4.0b (03-09-1998)

  • MSS now uses a single header file for all platforms: MSS.H
  • First release of the Win32 SDK.
  • Miles Sound Studio: easy-to-use utility for manipulating MIDI, XMIDI, DLS, and digital sound files.
  • New native Win32 version of MIDI Echo.
  • New Tools API - convert MIDIs to XMIDIs, compress/decompress ADPCM files, DLS file handling functions, etc. The Miles Sound Studio was written with these functions.

Changes from 3.6f to 4.0a (02-24-1998)

  • DLS support: high and low-level APIs, a bunch of new utilities, MMX and non-MMX support.
  • ADPCM compression support: on-the-fly compression in the sound mixer, file compression and decompression APIs, and support for DLS sample compression.
  • Miles Sound Player - new application to play MIDI/XMIDI (with and without DLS installed), and digital sound files.
  • New time-based positioning functions for both sequences and samples (current position, total length, and seek).
  • Quick API additions: DLS support, time position, normal MIDI file support.

Changes from 3.6e to 3.6f (11-07-1997)

  • Changed the Quick API to attempt to load the MIDI driver after the digital driver (instead of before) to work around Creative Labs MIDI drivers that attempt to allocate the digital driver for software music synthesis.
  • Made quite a few low-level changes to the MIDI sub-system for the DLS support coming in version 4.0.
  • Decreased the delay in the MIDI traffic when ending a MIDI sequence.
  • Fixed an open bug in the MSS Xtra.

Changes from 3.6d to 3.6e (10-20-1997)

  • Now use the DSBCAPS_GETCURRENTPOSITION2 flag to work a little better with emulated DirectSound drivers.
  • Added a function called AIL_set_DirectSound_HWND that will allow you to explicitly set the HWND of your application. Call this function after AIL_waveOutOpen.
  • Fixed a few bugs in the Miles Xtra with opening digital audio cast members.
  • Fixed a bug in the Miles Xtra in the positioning command for streaming audio.
  • Fixed a crash when there was no event callback installed and an AIL_send_channel_voice_message call was issued with no sequence handle specified.

Changes from 3.6c to 3.6d (08-25-1997)

  • Fixed a bug in AIL_minimum_sample_buffer_size that causes stuttering in the streaming API under DirectSound when the sound format didn't match the DirectSound output format.

Changes from 3.6b to 3.6c (06-08-1997)

  • Fixed bug in the streaming API under Win32 where some wave files wouldn't open.

Changes from 3.6a to 3.6b (03-07-1997)

  • Fixed bug in waveOut mixing code that could cause all sounds to stop under very high sound loads.
  • Fixed bug in red book volume control for CD devices that allowed stereo volume resolution.
  • Fixed some debug stuff that was left in the Quick example application.
  • Switched the newest Causeway (which works around a bug in the Ensoniq VIVO drivers).
  • Fixed a bug if you called AIL_start_sample or AIL_load_sample_buffer from an EOB or SOB callback (EOS and timer callbacks were fine).
  • MSS doesn't look for the application hwnd in AIL_digital_handle_reacquire again - it just uses the old one.

Changes from 3.5f to 3.6a (01-25-1997)

  • Added a new high-level streaming API - stream disk files in 4 calls! Streams work just like samples - you can change the playback rate, volume, pan, loop count, etc.
  • Updated the timer system to work around the dreaded Microsoft VC debugger problem under Windows 95 and Windows NT (slowdowns and crashes when sitting on a breakpoint for a long time).
  • Added volume control functions for redbook audio (AIL_redbook_volume and AIL_redbook_set_volume). Uses MSCDEX for DOS, the mixer API for Win32, and the aux device calls for Win16.
  • Fixed a bug in the DOS redbook control functions that would sometimes cause a redbook track not to play (good catch - BullFrog!)
  • Integrated the Fatman's General MIDI FM patches directly into the library.
  • Added a new function to duplicate an existing quick handle (AIL_quick_copy). This function doesn't duplicate the audio memory - only the handle info.
  • Added two new functions to control the speed and volume of a quick handle (AIL_quick_set_speed and AIL_quick_set_volume).
  • Added a new function to return the digital and MIDI driver handles when you used the Quick API to init the system (AIL_quick_handles). This is handy because you can now use AIL_quick_startup to simplify initializing MSS, and still use the full API for everything else.
  • Fixed a bug in AIL_strnicmp that was causing a crash when loading data out of a 32-bit resource DLL file.
  • The MSS DLLs now check to see if they have been incorrectly installed in Windows or Windows system directory.
  • Added the AIL_get_preference function to the DOS API.
  • Took out the virtual memory feature of VTOR - use the Smacker utilities to convert huge wave files to RAWs.
  • Fixed a bug in AIL_file_read when an pointer was passed and the read failed.
  • Fixed a bug in AIL_file_write that would free the pointer if the write failed.
  • Fixed a bug in the quick API where the MIDI system occasionally fail to load under NT.
  • Various minor clean-ups in the Delphi interface units.

Changes from 3.5e to 3.5f (10-22-1996)

  • Adjusted the method that the 16-bit DLL locks its memory for extreme low memory machines (Win3.x and Win32s).
  • Fixed potential crash when completely out of DOS memory in the 16-bit DLL (Win3.x and Win32s).
  • Preceded the system functions with `AIL_` to fix function name collisions with VFX from Miles Design. The old function names are still defined to match the new names, so no source should have to be changed.
  • Because of these function name changes and because Smacker dynamically links to MSS, you must update to at least Smacker version 2.2B for MSS 3.50F.

Changes from 3.5d to 3.5e (08-18-1996)

  • Fixed bug in release/reacquire code for DirectSound.
  • Added new ESS drivers - now run under Win95 DOS box.

Changes from 3.5c to 3.5d (09-14-1996)

  • Fixed unusual problem of DirectSound dropping samples when many samples are played at once.
  • Improved method that the background task uses for CPU-sharing, so that it is slightly faster.
  • Fixed bug in MIDI driver loading code - seen with Gravis driver & MidiForm.

Changes from 3.5b to 3.5c (08-22-1996)

  • Added locking calls for volume and pan setting in the DirectSound code.
  • Added AIL_digital_handle_release and AIL_digital_handle_reacquire for focus control under Windows.
  • Added AIL_MIDI_handle_release and AIL_MIDI_handle_reacquire for focus control under Windows.
  • Added new macro, `AIL_DLL_version`, to return the current DLL version (doesn't actually call into the DLL, so it is always safe).
  • Fixed weirdness with the background task complaining about Bad Code Pointers.
  • Changed the way AIL_redbook_status works to speed it up.
  • Added AIL_serve calls in the redbook API to avoid stutters on slow CDs.
  • Changed standard types (S8, U8, etc) slightly (to defines)
  • Under DirectSound, you can now pass NULL for the lpFormat parameter - this tells MSS not to adjust the primary sound buffer.

Changes from 3.5a to 3.5b (07-07-1996)

  • DOS version now has all of the features of the Windows version (red book support, quick-integration API, sub-block looping, etc).
  • Fixed error in linked list code of the quick API for Windows.
  • Fixed error in AIL_send_channel_voice_message when the driver handle is NULL.
  • Changed AIL_ms_count to call QueryPerformanceCounter under NT.
  • AIL_ms_count under DOS inside a Windows DOS box can read the Windows timer for millisecond accuracy.
  • Added `FILE_READ_WITH_SIZE` flag to FILE_READ function, so that it can return the size of the data read as the first four bytes of the returned pointer.
  • AIL.LIB can be used for register or stack based programs (there is no need to recompile for stack based programs anymore).
  • MSS can now be used with Watcom 9.5 to 10.6. RAD recommends version 10.6.
  • Added new AIL_set_driver_directory function to load drivers, .INI files, and patch files from alternate directory (MSS still always searches the current directory first).
  • You must now call AIL_startup before any other MSS calls (including FILE_read, MEM_alloc, etc).
  • Callbacks are now typed and must use the AILCALLBACK calling convention.
  • Added two new redbook functions. AIL_redbook_track returns the current playing track number. AIL_redbook_retract closes the CD drive door.
  • Timer callbacks now synchronize the callback frequency to AIL_ms_count. This improves MIDI playback drastically under DOS inside a Windows DOS box. It also prevents long-term timer counting drift if you use MSS timer to track time (use AIL_ms_count directly for best accuracy).
  • DDK has been integrated into the SDK for convenience.
  • All example programs and tools have been bound with the Causeway DOS extender.
  • Added new DOS drivers for the AMD Interwave and the NVidia multimedia card.
  • The VBL flag no longer used for delaying (in either the library or the drivers).
  • SetSound can display the current Windows 95 configuration when running in a Windows 95 DOS box.
  • Built-in Borland C support for both Windows and DOS PowerPack.
  • SoundFont support now supplied directly with MSS.
  • AILEXPORT has been renamed to AILCALLBACK for consistency with DOS.
  • Renamed main libraries and header to use MSS instead of AIL.
  • VTOR uses virtual memory so that large .WAVs or .VOCs can be converted. Under Windows and Windows 95 DOS boxes, virtual memory is limited to 16 MB, so you may have to run VTOR under normal DOS to convert really huge files.
  • Added 16- and 32-bit Delphi interface units.

Changes from 3.04a to 3.5a (04-11-1996)

  • Add complete built-in DirectSound support. There are several new DirectSound specific functions - see the docs for details.
  • AIL_startup can be called multiple times - but calling AIL_shutdown closes everything down immediately. This allows you to call AIL_startup several times in your application, and call AIL_shutdown once in your closing procedure.
  • Fixed a harmless thread handle leak.
  • Also fixed is AIL_minimum_sample_buffer_size which was under-reporting by a factor of 4.
  • Added the new Quick Integration API. See the docs for details.
  • Added new AIL_digital_configuration call that returns info about the current sound driver.
  • Added new sub-block looping feature - can loop internal pieces of a buffer. Use the AIL_set_sample_loop_block function to set the loop points.
  • Callbacks now work under Win32s - but are not called at interrupt time. Rather, they are distributed from the Windows messaging system, so you must yield to Windows to receive callbacks
  • Added new Red-Book audio interfaces - play CD audio tracks quickly and easily.
  • Multiple 16-bit and Win32s apps can be loaded at the same time.
  • Fixed crashes when running 16-bit DLL with other 32-bit apps or libraries.
  • Fixed crashes when memory would move.
  • Added new millisecond count call - AIL_ms_count. Allows accurate timing without having to create absurdly fast timers.
  • Added new starvation call - AIL_sample_buffer_info for video players.
  • AIL_serve is no longer needed in your message loop. Under Win32, a background thread handles servicing. Under Win16 and Win32s, a background task takes care of it.
  • MSS now works under Windows NT - (the NT MIDI drivers are still pretty buggy however).

Changes from 3.03d to 3.04a (02-04-1996)

  • Integrated Win32s support directly into WAIL32.DLL. This means you can create one executable that supports Win 95, Win NT, and Win32s. To support Win32s, you must distribute both WAIL32.DLL and WAIL16.DLL.
  • You must use MEM_alloc_lock for memory that you intend to use for sample or sequence data (with AIL_set_sample_address, AIL_load_sample_buffer, AIL_init_sequence, etc). MEM_alloc_lock returns 32-bit pointers that have been locked and fixed for Win32s. Under Win 95 or Win NT, MEM_alloc_lock just returns GlobalAlloc-ed memory, so you can use this function for all environments. If you pass in a pointer that isn't created with MEM_alloc_lock, MSS will display a error message box.
  • HDIGDRIVER, HSAMPLE, HSEQUENCE, etc, are all handles under Win32s - they are not pointers, so you can't dereference them.
  • Internal MSS calls are not captured in the debug trace file when running under Win32s.
  • Callbacks aren't supported yet.
  • Fixes segment wrap around in WAIL16 on sound cards that need large Windows buffers (>64K).
  • Marks several variables as volatile, so that WAIL can be compiled with optimizations on.
  • Pointers are checked for validity as they are freed.

Changes from 3.03c to 3.03d (11-22-1995)

  • Switched to a new thread synchronization technique which should fix deadlocking problems previously encountered by some 32-bit MSS applications.
  • Previous versions of the 32-bit MSS library could crash if an attempt was made to start more than one instance of a MSS application. This has been fixed.
  • AIL_branch_index could fail to work properly in previous versions of MSS. This problem has been fixed for this release.

Changes from 3.03b to 3.03c (11-07-1995)

  • SETSOUND now includes explicit support for the new Yamaha DB50-XG WaveForce(TM) daughterboard via the MPU401.MDI driver.
  • MSS for Win32 now uses thread synchronization.
  • If all playing samples had their volume set to 127, it was possible for the AIL_set_digital_master_volume command to fail to control the overall digital output level. This has been fixed.
  • The SETSOUND installation program did not uninstall drivers after successful detection. This caused no reported problems; however, the message `Out of timer handles` could appear if the user were to select and install any driver more than 16 times. SETSOUND now uninstalls drivers after detection to avoid the possibility of this error message.
  • The AIL_MDI_driver_type function caused premature termination of debug scripts when the AIL_DEBUG feature was in use. This has been fixed.
  • Memory past the end of XMIDI files could be accessed by AIL_init_sequence, in cases where XMIDI files smaller than 1024 bytes were played. This caused occasional page faults in the Windows MSS system, but no problems were ever reported in the DOS MSS system. This bug has been fixed, however, in both versions of MSS.
  • At the end of an unlooped XMIDI sequence, the sequence loop count is now reset to 1. This allows a sequence to be restarted without undesirable looping.
  • Under certain rare circumstances, unwanted pauses occurred during XMIDI playback when using the FOR/NEXT XMIDI controllers or the AIL_branch_index function. These pauses have been eliminated in this release.
  • The AIL_end_sequence function previously called the end-of-sequence (EOS) callback function, even if the sequence was already done. This behavior has been corrected.
  • The Microsoft Windows Sound System driver (SNDSYS.DIG) has been patched to fix a bug that caused a detection problem on some systems, particularly Compaq machines.
  • The standard Sound Blaster digital driver (SBLASTER.DIG) could cause lockups or `Transfer Stack Overflow` messages during detection when running under Windows 95. This was due to the use of an extremely short DMA buffer to check for auto-init DMA capabilities. In this release, the DMA verification buffer in SBLASTER.DIG has been increased in size to avoid problems. No other drivers, including those for the Sound Blaster Pro and Sound Blaster 16, were affected by this problem.

Changes from 3.03a to 3.03b (06-29-1995)

  • Changing the digital master volume level had no effect on samples whose volume level was set to 127. This has been fixed.
  • A VMM page-locking problem with the FlashTek DOS extender version of MSS has been fixed.

Changes from 3.03 to 3.03a (06-25-1995)

  • Sporadic crashes at shutdown time may occur in earlier MSS releases if a sequence handle is allocated with AIL_allocate_sequence_handle but never actually initialized with AIL_init_sequence. This patch corrects this problem, which affected only the MS-DOS versions of MSS.

Changes from 3.02 to 3.03 (06-18-1995)

  • Two new drivers, SNDSYS.DIG and ESFM.MDI, provide support for the Microsoft Windows Sound System and ESS Technology ES1688, ES1788, and ES1888 chipsets, respectively. The SETSOUND program recognizes these new drivers by means of an updated AILDRVR.LST file.
  • Support for the Borland Power Pack and Zortech/Symantec compiler packages is now available. Please note that by default, the MSS system is built for the more popular Watcom/Rational package. To use MSS with any other compiler/DOS extender package, it is necessary to delete all .OBJ, .LIB, and .EXE files and recompile the desired library version. The .MDI and .DIG drivers, as well as the files in the TOOLS subdirectory, do not need to be rebuilt.
  • Four new functions provide a `master volume` control for all digital samples and XMIDI sequences: AIL_set_digital_master_volume, AIL_set_XMIDI_master_volume, AIL_digital_master_volume, and AIL_XMIDI_master_volume
  • Please note that like the AIL_set_sequence_volume function, AIL_set_XMIDI_master_volume will not have the desired effect on sequences which do not include MIDI Part Volume controllers (7) at the beginning of each track. Refer to the updated documentation for further information on these functions.
  • The function AIL_register_beat_callback has been added to allow applications to request callback service at sequence beat transition points. Refer to the description of this function AND the AIL_sequence_position function in the documentation before attempting to use either function!
  • The function AIL_MDI_driver_type has been added to help applications identify the synthesis technology provided by various MSS drivers. This function may be used to select different XMIDI sequences for various sound synthesis platforms. Refer to the documentation for details.
  • A new XMIDI controller has been implemented. The XMIDI Channel Mute controller (107) can be used to selectively mute channels in sequences. Refer to the updated documentation for information on the XMIDI Channel Mute controller.
  • The prototypes of the AIL_install_DIG_INI and AIL_install_MDI_INI functions have been changed to provide enhanced error-reporting capabilities. It is now possible to distinguish between failure due to a missing .INI file and failure due to driver initialization or hardware detection problems. Refer to the updated documentation file for details.
  • Previous versions of MSS truncated 16-bit sample data to 8-bit sample data when panpot or volume scaling was used (panpot != 64 or volume < 127). With this release, 16-bit sample data is scaled with a multiply/shift sequence that preserves full 16-bit sample precision.
  • For consistency with the new Windows MSS package, the DIG_DRIVER * and MDI_DRIVER * data types have been replaced with the HDIGDRIVER and HMDIDRIVER handle types, respectively. The old pointer types may still be used, but new applications should be written with the new handle types for compatibility with the Windows MSS API.
  • Previous versions of MSS shut down interrupts during the digital mixing process, which caused problems with high-speed serial communications. By default, MSS V3.03 no longer disables interrupts at any time during digital audio processing. A new preference name, DIG_SS_LOCK, has been added to allow applications to restore the former behavior of shutting down interrupts while updating the DMA buffer. Few applications should need to change the DIG_SS_LOCK preference value.
  • When playing a stereo digital audio sample on a monaural sound card, previous versions of MSS truncated the right channel source data and played only the left channel data. MSS V3.03 allows the AIL_set_sample_pan function to fade linearly between the left and right source channel in this situation.
  • In previous versions of MSS, it was possible under exceptionally rare conditions for a nested INT 8 interrupt to cause crashes due to stack corruption. Under Windows 95, however, the probability of protection faults and crashes is greatly increased. This bug has been fixed for this release of MSS; additionally, Windows 95 itself has been patched to correct the bug in legacy applications by automatically modifying the faulty instructions in the MSS INT 8 ISR. Customers with the retail release of Windows 95 should not be affected; however, early beta versions (pre-490) can exhibit problems.
  • A minor bug in the digital mixer code caused clipping tests to be performed even with only one actively-playing sample. This bug has been fixed for this release, resulting in faster digital audio performance.
  • The AIL_resume_sample function could fail to operate properly if no other samples were playing at the time it was called. This has been fixed.
  • Reports have been received of lockups with Sound Blaster 16 daughterboards (such as those from Roland and Creative Labs) which occasionally occur during extremely intense bursts of MIDI traffic while digital audio is in use. The MSS MPU401 driver has been patched to provide a partial workaround for this problem; however, momentary digital audio glitches may still be noted during fast volume fades and other periods of high MIDI activity. Because this problem is due to a hardware bug in the Creative chipset, no completely reliable software workaround is currently known. However, difficulties arising from the bug are quite rare and should not be a cause for concern with most applications.
  • AIL_start_sequence formerly reset the sequence loop count (if any) to 1, effectively disabling any loop count previously established by AIL_set_sequence_loop_count. This has been fixed in version 3.03 -- AIL_set_sequence_loop_count may now be called either before or after playback begins.

Changes from 3.01 to 3.02 (01-18-1995)

  • The DRIVERS directory now contains a complete MSS driver configuration program (SETSOUND.EXE) which may be included in your application. SETSOUND must be executed before any of the MSS example programs in the DRIVERS directory can be run. Consequently, the example programs no longer require driver filenames to be specified directly on their command lines.
  • SETSOUND is very easy to use and can shave days or weeks of programming time from an application's development cycle. However, you should refer to SETSOUND's complete description in the Tools Reference section of the manual to help you get the most out of this powerful new utility.
  • The contents of the old MIDI and DIGITAL directories have been merged into the outer DRIVERS directory. Minor revisions have been made to the example programs and makefiles to accommodate this change.
  • SBLASTER.MDI, SBPRO1.MDI, and SBPRO2.MDI now check the BLASTER environment variable to permit FM sound autodetection at addresses other than 220h. Previously, only the Sound Blaster-series .DIG drivers checked the BLASTER variable.
  • DMA channel 0 is now available for use with Sound Blaster Pro adapters. In earlier releases, DMA channel 0 worked only with Sound Blaster 16 boards.
  • During autodetection, RAP10.DIG now checks addresses 330H and 320H, using DMA channels 5 and 6 and IRQ 9. Formerly, IRQ 5 was tested with address 320H.
  • The AIL_minimum_sample_buffer_size function could occasionally return buffer sizes below the actual minimum size when used with the SBPRO.DIG driver. This bug has been fixed.
  • An error-checking problem in the SSTEST example program could cause GP faults under rare circumstances. This bug has been fixed.
  • Updated Gravis UltraSound drivers are now available with this release. These `native mode` drivers no longer require the ULTRAMID emulation program.
  • Two new drivers, ADRV688.DIG and PROAUDIO.DIG, are supplied for use with ESS Technology's ES688 chipset and Media Vision's Pro Audio Spectrum line, respectively. Many newer systems from Compaq and other vendors include the ES688 device, which can support 16-bit stereo sound at up to 44 kHz through the use of the new ADRV688.DIG driver. PROAUDIO.DIG has been tested and found to give satisfactory performance on most systems; however, the Media Vision cards' `native mode` has never been among the most reliable of sound options, so users should be informed that the SBLASTER.DIG driver can be used with most Pro Audio Spectrum boards in the event problems occur.
  • First version of MSS for Windows is released as version 3.02 with full MSS API support for 16-bit Windows 3.1, Windows 95, and Windows NT.

Changes from 3.0a to 3.01 (11-22-1994)

  • The AIL_background function allows an application function to tell if it is being executed from within an MSS timer, XMIDI, or callback function.
  • The new AIL_set_sample_file function is similar to the existing AIL_allocate_file_sample function, except that it operates on an existing sample handle. .VOC or .WAV files may be played using an application's own sample handles through the use of the AIL_set_sample_file function. See the API Reference for further information.
  • A powerful debugging feature has been added to the MSS API library. If an AIL_DEBUG environment variable is created with a command of the form SET AIL_DEBUG=filename, a timestamped log of virtually every MSS API call made by any subsequently-executed MSS application will be recorded to the text file or device `filename`. The logfile may be examined to help diagnose and fix application errors. MSS functions called from within callback functions will not be logged, along with the functions AIL_switch_stack, AIL_restore_stack, AIL_unlock, AIL_lock, and AIL_background.
  • Digital support for the Roland RAP-10 device is now available (RAP10.DIG). This board produces extremely high-quality audio in either 8- or 16-bit, mono or stereo formats. Use the MPU401.MDI driver for MIDI support with the RAP-10.
  • Digital support for the New Media WaveJammer PCMCIA audio adapter is now available (JAMMER.ZIP). Use the OPL2.MDI driver for MIDI support with the WaveJammer.
  • Under certain circumstances, double-buffered samples could be terminated prematurely in previous releases of MSS. This problem has been fixed.
  • `Stuck` notes were occasionally reported when shutting down applications using the Roland RAP-10 and Roland SB16 MIDI daughterboards. This MIDI hardware overrun problem has been corrected by introducing a slight delay into functions which flush the XMIDI note queue, such as AIL_end_sequence and AIL_stop_sequence. This delay should not normally be perceptible at the application level.
  • Revised guidelines for audio-video synchronization have been issued with this release. The AIL_minimum_sample_buffer_size function returns the size of the smallest memory block which may be used with the double-buffering calls. Typically this value will range from 2 to 8KB; applications must ensure that their video playback engines can provide sound blocks of this size or greater. See the API Reference for further information. The DBTEST.C example program now uses AIL_minimum_sample_buffer_size to allocate its memory buffers. Note that the `Guidelines for Audio/Video Synchronization` section that appeared in earlier manual revisions is no longer applicable.
  • Under rare circumstances, MSS's built-in VMM locking calls could fail to lock the last few bytes in a module. This problem was caused by Watcom's code optimizer; a workaround is now in place.
  • The AIL_restore_interrupts function is now prototyped to return void.
  • Calls to the AIL_channel_lock function could result in crashes if any sequence handles were allocated with AIL_allocate_sequence_handle but not yet initialized with AIL_init_sequence. This problem has been fixed.
  • AIL_destroy_wave_synthesizer now releases sample handles allocated by AIL_create_wave_synthesizer. Previously, these allocated handles were lost upon destruction of the HWAVE instance.

Changes from 3.00 to 3.0a (10-24-1994)

  • FlashTek X32 support with the Watcom compiler
  • Sound Blaster AWE32 XMIDI support (SoundFont support coming soon!)
  • Ensoniq SoundScape native-mode digital and XMIDI support
  • Updated Gravis UltraSound support
  • The AIL_set_sequence_volume function can now be used prior to calling AIL_start_sequence. Previously, AIL_start_sequence reset the sequence volume to its default value. The default sequence volume is now established by the AIL_init_sequence function, based on the MDI_DEFAULT_VOLUME preference.

Changes from 0.0 to 3.00 (09-19-1994)

  • The complete digital audio system, with digital mixing, mono/stereo support, double-buffering, and individual control over sample pitch, volume, panning, and stereo balance. Any sample, regardless of its resolution, rate, channel count, or sign, may be played with any MSS 3.0 digital driver -- present or future!
  • Full General MIDI support, including 16-channel response for all Yamaha drivers, adjustable pitch-bend range, and information on The Fat Man's acclaimed Yamaha General MIDI instrument set.
  • Over 100 API functions for interactive music and sound effects control.
  • Complete documentation of all tools and MSS API functions.
  • Support for Watcom C32/C++32 V10.0. Versions 9.5 and earlier may also be used by recompiling the library's source code.

  • 425.893.4300 ph
  • Email us!
  • © 1991 - 2024 Epic Games Tools LLC
  • 12/21/23