version 4.0.0-beta.5

[hvianna]

What's new:

New in 4.0.0-beta.5:

• Strings for dual channelLayout modes changed from camelCase to hyphen-separated words;
• The dual-vertical channel layout now properly displays background colors from both selected gradients;
• Fixed overlay display in dual-combined channel layout;
• Added two new built-in gradients: 'orangered' and 'steelblue'.

🚨 v4 BREAKING CHANGES:

• Removed deprecated properties:

  • energy - use getEnergy() instead
  • isLedDisplay - use isLedBars instead
  • peakEnergy - use getEnergy('peak') instead
  • showLeds - use ledBars instead

• getBars() elements now contain an extra freq property (potentially breaking in TypeScript projects), which represents the band's center frequency. The range of each band has also changed - frequencies that were previously at the lower edge (freqLo) are now placed at the center of the band.

• Also, stereo has been DEPRECATED and should be removed in version 5 - use channelLayout instead.

Added:

• ansiBands - use ANSI/IEC preferred frequencies for the octave bands;
• channelLayout - adds option for dual channel combined spectrum, with both channel graphs overlaid;
• frequencyScale - adds linear and perceptual (Bark/Mel) frequency scales;
• gradientLeft and gradientRight - allow to select different gradients for each channel;
• isBandsMode read-only property;
• linearAmplitude - use linear values instead of dB for spectrum amplitudes;
• linearBoost - amplify low energy values when using linear amplitude;
• noteLabels - display musical note labels instead of frequency values on the X axis;
• weightingFilter - select from five different weighting filters for improved spectrum visualization.

Thank you @jonathan-annett (#28) and @TF3RDL (#30 and #38) for the suggestions that led to the implementation of several of these new features.

Fixed:

• LED peaks showing below zero level when reflexRatio > 0.

Changed and improved:

• Optimized generation of octave bands, with more accurate ranges and center frequencies;
• Frequency labels on the X-axis now show different values depending on the value of ansiBands, to properly match the bands' center frequencies;
• Custom gradients can now register a single color;
• splitGradient now works for horizontal gradients in radial visualization;
• maxFreq is now capped to half the AudioContext's sample rate (Nyquist frequency);
• Code optimizations, minor fixes and clean-up;
• Revised and improved demos and documentation.

---

This discussion was created from the release version 4.0.0-beta.5.

[hvianna]

👉Demo on CodePen