npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

smoothfade

v1.1.1

Published

Smooth volume fading for WebAudio

Downloads

39

Readme

smoothfade

npm version

Smooth fading of volume (gain) in WebAudio is possible with parameter automation on the GainNode.

However, currently, there is no easy way to stop and change (for eg. reverse) an automation smoothly. Once an AudioParam is automated, there is no easy way to know it's value at a given point of time except for calculating it manually using the automation equations. Hence stopping and reversing the automation is not trivial.

This JSFiddle shows the various techniques that don't work for smooth fading, and finally the calculation based technique which does.

This library does the calculation and allows fading in/out smoothly.

Usage

npm install smoothfade
// wrap the smoothfade around a gain node

var sm = smoothfade(context, gain);


// use fadeIn/fadeOut functions to
// fadeIn/fadeOut the audio.

sm.fadeIn();

sm.fadeOut();

API

Constructor

eg: var sm = smoothfade(context, gainNode, options);

  • context: AudioContext - The AudioContext within which the GainNode has been created.
  • gainNode: GainNode - The GainNode which is connected to the audio graph which needs to be faded in/out.
  • options: Optional object attribute which contains extra configuration options in the following format -startValue : Number - The initial starting value of the gainNode. If not specified, the library attempts to read it from the gainNode itself. This is useful if the gainNode is already being automated before this library is initialized.
    • type : String - The type of automation to use. Currently support 'linear' and 'exponential'. 'exponential' fade is considered to be more natural to human ears and hence is the default
    • fadeLength : Number - The time taken (in seconds) for a complete fadeout (from 1 - 0) or fadein (from 0 - 1). This determines how quickly the volume fades for both fadeins and fadeouts. This defaults to 10.

Methods

  • fadeIn : Fade in the audio. Slowly increase the gain of gainNode.

    • eg :
    sm.fadeIn(options);
    • arguments (optional):
      • targetValue : Number - The targeted value of the gain (between 0 and 1) where the fadeIn will stop. This defaults to 1.
      • startTime : Number - Timestamp to define when the fading starts, in the same time coordinate system as the AudioContext currentTime attribute. This defaults currentTime.
  • fadeOut : Fade out the audio. Slowly decrease the gain of gainNode.

    • eg :
    sm.fadeOut(options);
    • arguments (optional):
      • targetValue : Number - The targeted value of the gain (between 0 and 1) where the fadeOut will stop. This defaults to 1.
      • startTime : Number - Timestamp to define when the fading starts, in the same time coordinate system as the AudioContext currentTime attribute. This defaults currentTime.

License

Apache-2.0

See License file