custom-audio-node/README.md

Create your own AudioNodes with AudioParams for using with the Web Audio API.

custom-audio-node
===

Create your own AudioNodes with AudioParams for using with the Web Audio API. 

## Install

```bash
$ npm install custom-audio-node
```

## API

```js
var createAudioNode = require('custom-audio-node')
```

### createAudioNode(input, output, params)

Specify the **input** and **output** nodes to wrap into a single audio node. 

**params**: automatable AudioParams

```js
var extendTransform = require('audio-param-transform')

var audioContext = new AudioContext()
var input = audioContext.createBiquadFilter()
var output = audioContext.createGain()

// add the transform method
extendTransform(input.frequency, audioContext)

var decimalFrequencyParam = input.frequency.transform(valueToFreq)

input.connect(output)

function mapValueToFreq(defaultValue, value){
  var min = Math.log(100)/Math.log(10)
  var max = Math.log(20000)/Math.log(10)
  var range = max-min
  return Math.pow(10, value * range + min)
}

var customNode = createAudioNode(input, output, {
  amount: {
    min: 0, max: 1, defaultValue: 0.5,
    targets: [ decimalFrequencyParam ]
  }
})

customNode.connect(audioContext.destination)
```

## TODO

- param.value should return the curve value at current time not the final value
- params currently cannot be connected to from another audioNode (modulate) e.g. `node.connect(otherNode.frequency)`