avio

avio is a library for making interactive audio/visual systems in the browser

Usage

The recommended way is using ECMAScript modules (esm):

<script type='module'>
  import { input, output } from 'https://unpkg.com/[email protected]?module'
</script>

Input

The input object has collections of signals and signals generators.

Mouse

The mouse collection has the following signals:

• x: X coordinate relative to the window viewport. The values are decimal numbers between 0 and 1.
• y: Y coordinate relative to the window viewport. The values are decimal numbers between 0 and 1.
• down: Whether or not the mouse is pressed down. 1 when mouse is pressed down, 0 when not.
• up: Whether or not the mouse is pressed down. 0 when mouse is pressed down, 1 when not.

input.mouse.x.print() // 0.01, 0.02, 0.03 ...
input.mouse.y.print() // 0.005, 0.008, 0.01 ...
input.mouse.down.print() // 0, 0, 1 ...
input.mouse.up.print() // 1, 1, 0 ...

Time

The time collection has the following signals:

• frame: Starts at 0 and increments by 1 around 60 times every second.
• interval(ms): Starts at 0 and increments by 1 at the time interval of milliseconds specified.

input.time.frame.print() // 0, 1, 2, 3, 4 ... (updates 60 times every second)
input.time.interval(1000).print() // 0, 1, 2, 3, 4 ... (updates one time every second)
input.time.interval(500).print() // 0, 1, 2, 3, 4 ... (updates two times every second)

Output

Audio

Oscillator

...

Visual

...

Signals

avio uses a high-level concept of signals. A signal in avio is an object whose value changes over time, similar to voltage in a wire. It has methods for transformation, inspection and connection. All methods return a signal which means that they can be chained.

Inspection

A signal can be inspected by using the print method. It will print all values continuously in the developer tools console of the browser. In example:

signal.print()

Transformations

Math

Basic arithmetic (add, subtract, multiply, divide) and all built-in JavaScript Math methods can be used. In example:

signal.multiply(0.5).subtract(1).sin().pow(2)

Signal generators

...