audiomotion-analyzer 4.4.0 → 4.5.0-beta.0

package/README.md

@@ -140,6 +140,7 @@ options = {<br>
 &emsp;&emsp;[gradient](#gradient-string): **'classic'**,<br>
 &emsp;&emsp;[gradientLeft](#gradientleft-string): *undefined*,<br>
 &emsp;&emsp;[gradientRight](#gradientright-string): *undefined*,<br>
+&emsp;&emsp;[gravity](#gravity-number): **1**,<br>
 &emsp;&emsp;[height](#height-number): *undefined*,<br>
 &emsp;&emsp;[ledBars](#ledbars-boolean): **false**,<br>
 &emsp;&emsp;[linearAmplitude](#linearamplitude-boolean): **false**,<br>
@@ -498,6 +499,16 @@ For **_dual-combined_** channel layout or [`radial`](#radial-boolean) spectrum,
 
 See also [`gradient`](#gradient-string) and [`splitGradient`](#splitgradient-boolean).
 
+### `gravity` *number*
+
+*Available since v4.5.0*
+
+Controls the acceleration of [peaks](#showpeaks-boolean) falling down.
+
+It must be a number greater than zero. Invalid values are ignored and no error is thrown.
+
+Defaults to **1**.
+
 ### `height` *number*
 ### `width` *number*
 
@@ -607,7 +618,7 @@ Defaults to **false**.
 
 *Available since v4.0.0*
 
-Performs an *n*th-root to amplify low energy values when using linear scale for the amplitude.
+Performs an *n*th-root operation to amplify low energy values when using linear scale for the amplitude.
 
 It should be a number >= 1, while 1 means no boosting. Only effective when [`linearAmplitude`](#linearamplitude-boolean) is set to *true*.
 
@@ -906,9 +917,11 @@ and setting `showBgColor` to ***true*** will make the "unlit" LEDs visible inste
 
 ### `showPeaks` *boolean*
 
-*true* to show amplitude peaks. Defaults to **true**.
+*true* to show amplitude peaks.
 
-See also [`peakLine`](#peakline-boolean).
+See also [`gravity`](#gravity-number) and [`peakLine`](#peakline-boolean).
+
+Defaults to **true**.
 
 ### `showScaleX` *boolean*
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "audiomotion-analyzer",
   "description": "High-resolution real-time graphic audio spectrum analyzer JavaScript module with no dependencies.",
-  "version": "4.4.0",
+  "version": "4.5.0-beta.0",
   "main": "./src/audioMotion-analyzer.js",
   "module": "./src/audioMotion-analyzer.js",
   "types": "./src/index.d.ts",
@@ -9,6 +9,7 @@
   "exports": {
     ".": {
       "import": "./src/audioMotion-analyzer.js",
+      "require": "./src/audioMotion-analyzer.js",
       "types": "./src/index.d.ts"
     }
   },

package/src/audioMotion-analyzer.js

@@ -2,12 +2,12 @@
  * audioMotion-analyzer
  * High-resolution real-time graphic audio spectrum analyzer JS module
  *
- * @version 4.4.0
+ * @version 4.5.0-beta.0
  * @author  Henrique Avila Vianna <hvianna@gmail.com> <https://henriquevianna.com>
  * @license AGPL-3.0-or-later
  */
 
-const VERSION = '4.4.0';
+const VERSION = '4.5.0-beta.0';
 
 // internal constants
 const PI      = Math.PI,
@@ -92,6 +92,7 @@ const DEFAULT_SETTINGS = {
 	fillAlpha      : 1,
 	frequencyScale : SCALE_LOG,
 	gradient       : GRADIENTS[0][0],
+	gravity        : 1,
 	height         : undefined,
 	ledBars        : false,
 	linearAmplitude: false,
@@ -186,7 +187,7 @@ if ( ! Array.prototype.findLastIndex ) {
 
 // AudioMotionAnalyzer class
 
-export default class AudioMotionAnalyzer {
+class AudioMotionAnalyzer {
 
 /**
  * CONSTRUCTOR
@@ -485,6 +486,13 @@ export default class AudioMotionAnalyzer {
 		this._setGradient( value, 1 );
 	}
 
+	get gravity() {
+		return this._gravity;
+	}
+	set gravity( value ) {
+		this._gravity = value > 0 ? +value : this._gravity || DEFAULT_SETTINGS.gravity;
+	}
+
 	get height() {
 		return this._height;
 	}
@@ -1767,6 +1775,7 @@ export default class AudioMotionAnalyzer {
 			    _energy,
 			    fillAlpha,
 			    _fps,
+			    _gravity,
 			    _linearAmplitude,
 			    _lineWidth,
 			    maxDecibels,
@@ -1909,7 +1918,7 @@ export default class AudioMotionAnalyzer {
 			if ( _energy.peak > 0 ) {
 				_energy.hold--;
 				if ( _energy.hold < 0 )
-					_energy.peak += _energy.hold / ( holdFrames * holdFrames / 2 );
+					_energy.peak += _energy.hold / ( holdFrames * holdFrames / _gravity );
 			}
 			if ( newVal >= _energy.peak ) {
 				_energy.peak = newVal;
@@ -2141,7 +2150,7 @@ export default class AudioMotionAnalyzer {
 					bar.hold[ channel ]--;
 					// if hold is negative, it becomes the "acceleration" for peak drop
 					if ( bar.hold[ channel ] < 0 )
-						bar.peak[ channel ] += bar.hold[ channel ] / ( holdFrames * holdFrames / 2 );
+						bar.peak[ channel ] += bar.hold[ channel ] / ( holdFrames * holdFrames / _gravity );
 				}
 
 				// check if it's a new peak for this bar
@@ -2641,3 +2650,6 @@ export default class AudioMotionAnalyzer {
 	}
 
 }
+
+export { AudioMotionAnalyzer };
+export default AudioMotionAnalyzer;

package/src/index.d.ts

@@ -28,6 +28,7 @@ export interface Options {
   gradient?: string;
   gradientLeft?: string;
   gradientRight?: string;
+  gravity?: number;
   height?: number;
   ledBars?: boolean;
   linearAmplitude?: boolean;
@@ -165,6 +166,9 @@ declare class AudioMotionAnalyzer {
   get gradientRight(): string;
   set gradientRight(value: string);
 
+  get gravity(): number;
+  set gravity(value: number);
+
   get height(): number;
   set height(h: number);
 
@@ -319,4 +323,5 @@ declare class AudioMotionAnalyzer {
   public toggleFullscreen(): void;
 }
 
+export { AudioMotionAnalyzer };
 export default AudioMotionAnalyzer;