version 3.1.0

What's new:

Added:

• TypeScript definition file (props to @alex-greff).

Improvements:

• Generate only the currently selected gradient on mode/gradient changes.

version 3.0.0

What's new:

BREAKING CHANGES:

• The analyzer object is no longer exposed - use the new connectInput() method to connect all audio sources and connectOutput() to connect the analyzer output to other nodes;
• audioSource property has been renamed to connectedSources, which now returns an array of all connected audio sources;
• binToFreq() and freqToBin() methods have been removed;
• connectAudio() method has been replaced by connectInput(), which now accepts either an HTML media element or any instance of AudioNode;
• dataArray property is no longer exposed;
• showScale property has been renamed to showScaleX;
• version is now a static property and should always be accessed as AudioMotionAnalyzer.version.

New features:

• Dual channel (stereo) analyzer option;
• Built-in volume control;
• New methods for easy connection/disconnection of input and output nodes:
  • connectInput()
  • disconnectInput()
  • connectOutput()
  • disconnectOutput()
• New properties:
  • isOctaveBands (read only)
  • isLedDisplay (read only)
  • isLumiBars (read only)
  • stereo
  • splitGradient
  • volume

Improvements:

• Automatically unlock/resume the AudioContext on first user click, so you don't need to handle this in your code anymore;
• Improved FFT data interpolation on low frequencies (especially noticeable in 1/12th and 1/24th octave bands);
• Corrected initial amplitude of line / area graph.

Fixed:

• A compatibility issue that could cause reflexRatio not to work in some environments.

version 3.0.0-beta.3

Version bump.

version 3.0.0-beta.0

Update package.json for beta pre-release.

version 2.5.0

What's new:

Improvements:

• Behavior of the onCanvasResize callback is now consistent across different browsers. Changes worth of note:
  1. on fullscreen changes, only a 'fschange' reason will be reported to the callback function - no more redundant 'resize' calls;
  2. the callback function is now executed only when canvas dimensions effectively change from the previous state - for example,
     setting loRes or width to the same value they already have won't trigger a callback;
• Canvas dimensions are now properly updated whenever the container element is resized, not only on window resize;
• audioSource now returns the first audio source connected via connectAudio() method, if no source was provided during instantiation;
• Size of scale labels on both axes is now scaled relatively to the canvas height;
• Added a new demo with only the minimal code required to use audioMotion-analyzer;
• Demo scripts are now loaded as native ES6 modules and no longer require bundling. See the README file for instructions on running the demos locally.

version 2.4.0

What's new:

Added:

• New Radial visualization - see radial and spinSpeed properties and try them in the demos!
• showScaleY property for displaying the level (dB) scale on the analyzer's vertical axis;
• energy and peakEnergy read-only properties;
• Known issues section added to the documentation.

Changed:

• setOptions() called with no argument now resets all configuration options to their default values (it used to raise an error);
• The LED effect code has been refactored to improve appearance and compatibility with other (future) effects;
• "Unlit" LEDs are no longer displayed in overlay mode - see the notice in showBgColor documentation;
• Canvas fillStyle and strokeStyle properties are now set with the current gradient before calling the onCanvasDraw callback function;
• Updated all demos with more straightforward access to configuration options.

version 2.3.0

• Reverted the change to reflexAlpha introduced in v2.2.1 and removed the forced black layer off the reflection background;
• Added a new reflexBright property to allow adjusting the brightness of the reflected image;
• Added binToFreq() and freqToBin() methods.

version 2.2.1

• Improved the Reflex effect in overlay mode - the reflexAlpha property is now used to adjust the opacity of a dark layer applied over the reflection area, which prevents undesired transparency of the reflection itself and creates a consistent effect, whether overlay mode is on or off;

• Fixed LEDs showing below the 0 level, when both reflex and overlay are active;

• The package source code has been moved from the dist to the src folder.

version 2.2.0

• New overlay and bgAlpha properties allow displaying the analyzer over other contents.
  Check out the new demo!

• Corrected the documentation for the registerGradient() method, which stated the bgColor property was required (it has always been optional).

version 2.1.0

• Added customizable Reflex effect - see reflexRatio and try it in the demo.